MCP

Yapay zeka istemcilerini Influence hesaplarına, medyaya, incelemelere, zamanlamaya ve kullanılabilen İstatistikler verilerine bağlayın.

İşe uygun uç noktayı seçin. Ürün araçları için yetkilendirilmiş bir Influence çalışma alanı gerekir; belge sunucusu yalnızca herkese açık kılavuzları okur.

Bağlanın ve araçları keşfedin

İstemcinin Influence OAuth akışını kullanın. İstemci bearer kimlik doğrulamasını destekliyorsa izinleri sınırlandırılmış bir API anahtarı da kullanabilirsiniz. Uygulamalar ve otomasyonlar, istemciye özel kurulumu açıklar. API anahtarlarını istemcinin gizli ortam değişkenlerinde saklayın.

Influence e-posta adresini ve çalışma alanını (nickname) doğrulamak için profileGet, ardından izin kapsamları ve yapay zeka zamanlama hakkı için connectionStatusGet sonucunu okuyun. Yapay zeka istemcisinde farklı bir e-posta adresiyle oturum açılmış olabilir. Yetkilendirme sırasında kullanmak istediğiniz Influence kimliğini seçin.

OAuth yenilemesi için offline_access kapsamına açık rıza gerekir. Yeni bir ChatGPT özel bağlantısının kurulum yönergeleri de bu temel kapsamı belirtir. Araçları yenilemek izin eklemez veya eski bir bağlantının temel kapsamlarını genişletmez.

tools/list ve MCP araç referansını kullanın. Keşifte, izin kapsamı henüz verilmemiş araçlar da listelenebilir; her çağrı yine izinleri denetler. Kullanılabilirlik etkin özelliklere ve istemci desteğine bağlıdır. Genel uç nokta ile Claude uç noktası farklıdır. Beceri veya eklenti indirmek, kurulu istemcinin araçları yüklediğini kanıtlamaz.

Tamamlanmış içeriği hazırlayın

1. accountList, ardından seçilen her hesabın gerekli ayarları ve medya sınırları için integrationSchema sonucunu okuyun. Panolar, kanallar ve benzeri hedefler için adı belirtilen sağlayıcı sorgulama araçlarını kullanın.
2. Erişilebilir bir HTTPS dosyasını mediaImport ile, url ve isteğe bağlı name kullanarak içe aktarın. Gerçek sunucu dosyası ayrı file nesnesini kullanır; dosya kimliği uydurmayın. Yerel dosyalarda çok parçalı yükleme araçlarını veya mevcut SDK/CLI yardımcısını kullanın. Medya sınırları ve hazır olma koşulları geçerlidir.
3. İçeriği tamamlanmış, zamanlanacak 1–10 gönderi için, her öğede sabit bir itemKey, draft ve scheduledFor ile campaignScheduleBatchReview kullanın. Araç, her hedefe ait metin ve medyayla birlikte taslakları ve bekleyen incelemeleri kaydeder; toplam gönderim sayısı en fazla 50 olabilir. Yalnızca taslak hazırlamak veya düzenlemek için campaignDraftSave kullanın. campaignReview, kaydedilmiş bir kampanya için amaçlanan işlemi hazırlar.
4. Kaydedilmiş incelemenin tamamını sunun. Gösterilen ve yüklenmiş bir kart bu sunumu sağlar. Kart yoksa tam hesapları, metni, medya önizlemelerini veya bağlantılarını, ayarları, zamanlanmış saati ve saat dilimini gösterin. İnceleme eksik, güncelliğini yitirmiş veya belirsizse campaignReviewGet sonucunu okuyun.
5. Çalıştırmadan önce kişiden yeni ve açık onay alın. Desteklenen bir kartın kendi onay düğmesi vardır. Uygun sosyal gönderilerde sohbet onayı campaignReviewExecute veya campaignScheduleBatchExecute üzerinden iletilir. Model, yalnızca arayüzün kullanımı için ayrılmış campaignReviewApprove eylemini çağırmamalıdır.

TikTok Direct normal sohbeti destekler. tiktokCreatorInfoGet sonucunu okuyun, ardından görünürlük, etkileşimler, tanıtım ve geçerli yapay zeka/müzik seçeneklerinden henüz netleşmeyenleri 1 toplu soruyla sorun. Geçerli rıza metnini ve bağlantılarını gösterin. Rızayı varsaymayın veya kısıtlanmış etkileşimleri açmayın. Kişinin tüm seçimlerini, reviewId ve connectionId ile settings içeren tiktokSettings girdilerini kullanarak campaignReview ile kaydedin. Bu işlem yeni bir bekleyen inceleme döndürür, onay vermez. Tam bu incelemeyi sunun ve çalıştırmadan önce kişiden yeni, açık onay gelmesini bekleyin. Desteklenen inceleme kartı isteğe bağlı kalır. TikTok gelen kutusuna gönderim akışı TikTok içinde tamamlanır.

TikTok rızası tam olarak ilgili incelemeye aittir. Taslakta saklanan rıza bu adımı tamamlamaz. İnceleme seçimlerini kaydetmek yeni bir taslak sürümü oluşturur ve ayarlar değişmese bile önceki incelemeyi güncelliğini yitirmiş duruma getirir.

Onaylama ve kurtarma

Onay gerektirdiği belirtilen araçlar önce _confirmationCapability veya _idempotencyKey olmadan hazırlık yapar. Aynı işlem girdisini dönen onay yetkisi ve çağıranın oluşturduğu sabit bir idempotency anahtarıyla onaylayın. Bu alışveriş, aracın belirtilen işlemini kaydeder veya gerçekleştirir; insanın yayın onayından ayrıdır. Asistan uygulamasının izin istemlerine uyun.

mediaUploadPart, mediaUploadComplete ve mediaUploadAbort yetkilendirilmiş bir yüklemeyi doğrudan sürdürür. Dosya baytlarını araç JSON’una değil, dönen depolama URL’lerine aktarın. Kesintiden sonra yükleme durumunu okuyun ve aynı dosya ile clientKey üzerinden devam edin.

Yüklemenin expiresAt değeri, o anki aktarım veya işleme süresinin sonudur: başlangıçta 24 saat, tamamlama adımı işlemeyi başlattıktan sonra ise 15 dakikadır. Bu sürenin dolması hazır medyanın geçerliliğini sona erdirmez. Medya kitaplığındaki assetId değerini yeniden kullanın.

Sonuç belirsizse onay ve yeniden deneme değerlerini koruyun. Bir yayın işlemini yeniden denemeden önce kayıtlı incelemeyi veya kampanyayı okuyun. Zaman aşımının hiçbir şey olmadığı anlamına geldiğini asla varsaymayın. Değişmiş veya süresi dolmuş bir inceleme için yeni inceleme ve onay gerekir.

Yapay zeka zamanlama sınırları, MCP istemcileri ve Influence IQ genelinde geçerlidir. Normal HTTP/CLI otomasyonu ve web uygulamasında elle zamanlama bu sınırlara dahil değildir. İstatistikler kapsamı ve yenileme davranışı İstatistikler bölümünde açıklanır. İsteğe bağlı olay abonelikleri için asistanı çalıştıran uygulamanın ayrıca destek sağlaması ve bunu etkinleştirmesi gerekir; her istemcide arka plan bildirimleri verileceği anlamına gelmez.