Araçlarınızı Influence yayınlama iş akışına bağlayın

Taslakları kaydetmek, gönderileri gözden geçirmek ve onaylanmış yayını zamanlamak için Influence API’sini ve MCP araçlarını kullanın. Aynı araçlarla bağlı hesapları alın ve kaydedilmiş yayın sonuçlarını kontrol edin.

Erişim bilgileri, onay ve gönderim durumu

Yetkileri sınırlandırılmış erişim bilgileriyle erişimi kısıtlayın

İstemcinin ihtiyaç duyduğu izinleri seçin. Influence her işlemde çalışma alanının sahipliğini ve erişimi kontrol eder. Her araç, onay gerekip gerekmediğini belirtir. Bu gerekliliği sunucu uygular.

Yayınlama işleminin tam olarak ne yapacağını onaylayın

İşlem başlamadan önce hesapları, içeriği, medyayı ve zamanı gözden geçirin. Önemli bir değişiklik, yeni bir inceleme ve yeniden onay gerektirir. Onaylanan işler Influence zamanlayıcısına girer.

Gönderim durumunu okuyun

Dönen kimliklerle her gönderiyi kontrol edin. “Zamanlandı”, gönderinin gönderilmeyi beklediğini; “Yayınlandı” ise yayınlandığını doğrular. “İnceleme gerekli”, sonucun belirsiz olduğu ve yeniden göndermeden önce bu belirsizliğin giderilmesi gerektiği anlamına gelir.

MCP ile bağlı hesaplarınızı okuyun

Bu Node.js örneği Influence hizmetine bağlanır ve çalışma alanınızdaki sosyal hesapları listeler. Taslak oluşturmadan veya gönderi yayımlamadan hesap ayrıntılarını okur.

1. Okuma erişimi olan bir anahtar oluşturun

Ayarlar bölümünde Uygulamalar ve otomasyonlar → Geliştirici araçları yolunu izleyin. Bağlı kanalları oku (integrations:read) iznini seçin, diğer tüm izinleri temizleyin ve API anahtarını oluşturun. Anahtarı yerel gizli bilgi deponuzda veya ortamınızda INFLUENCE_API_TOKEN adıyla saklayın. Anahtar yalnızca 1 kez gösterilir; kaynak dosyalarına veya sohbetlere koymayın.

API anahtarı ayarlarını açın

2. Örneği çalıştırın

Node.js ve npm kuruluysa MCP SDK paketini projenize yükleyin. Aşağıdaki kodu accounts.mjs olarak kaydedin; ardından INFLUENCE_API_TOKEN değişkeninin tanımlı olduğu bir ortamda node accounts.mjs komutunu çalıştırın. SDK, MCP bağlantısını ve başlatma işlemini yönetir.

npm install @modelcontextprotocol/client@2.3.1

accounts.mjs

import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";

const token = process.env.INFLUENCE_API_TOKEN;
if (!token) throw new Error("Set INFLUENCE_API_TOKEN first.");

const client = new Client({ name: "influence-quickstart", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
  new URL("https://influence.so/api/mcp"),
  { requestInit: { headers: { Authorization: `Bearer ${token}` } } }
);

try {
  await client.connect(transport);
  const result = await client.callTool({
    name: "accountList",
    arguments: { limit: 20 }
  });
  console.log(JSON.stringify(result.structuredContent, null, 2));
  if (result.isError) process.exitCode = 1;
} finally {
  await client.close();
}

3. Yanıtı okuyun

Hesap adları ve kimlikleri kurgusal olan örnek yanıt. Sizin yanıtınız çalışma alanınızı ve ona bağlı sosyal hesapları tanımlar.

{
  "ok": true,
  "output": {
    "cursor": null,
    "done": true,
    "items": [
      {
        "connectionId": "account_example_01",
        "eligible": true,
        "name": "Example studio",
        "platform": "bluesky",
        "supportsImage": true,
        "supportsText": true,
        "supportsVideo": true
      }
    ],
    "workspaceId": "workspace_example_01",
    "workspaceName": "Example workspace"
  },
  "toolName": "accountList"
}

Sonuç ne anlama gelir

Hesaplar döndü

Her hesabı tanımlamak için connectionId kullanın. eligible ve supportsText, supportsImage, supportsVideo değerleri hesabın mevcut yayımlama yeteneklerini belirtir; gönderi hazırlamadan önce bunları yeniden kontrol edin.

Hesap dönmedi

ok: true, items: [] ve done: true içeren bir yanıt başarılı bir okumadır. workspaceName ile gösterilen çalışma alanına bir sosyal hesap bağlayın, ardından örneği yeniden çalıştırın.

Sonuçlar birden fazla sayfada

done değeri false ise dönen cursor ile aynı limit değerini kullanarak accountList aracını yeniden çağırın. done true olana kadar devam edin; ilk sayfa 20’den az hesap içerebilir.

Erişim reddedildi

401 yanıtında, anahtarın güncel olduğunu ve integrations:read erişimine sahip olduğunu kontrol edin. API anahtarında eksik bir izin kapsamı da 401 döndürebilir. OAuth bağlantısı 403 insufficient_scope döndürebilir; yeniden bağlanıp hesap okuma erişimini onaylayın.

ChatGPT ve Claude, anahtar yerine tarayıcı üzerinden yetkilendirmeyle bağlanabilir. Asistanın kurulum rehberini kullanın, ardından bağlı hesaplarınızı listelemesini isteyin. Yukarıdaki örnek tam MCP uç noktasını kullanır: https://influence.so/api/mcp; Claude’un çekirdek bağlayıcısının kendi kurulum adımları vardır.

Araçları ve gerektirdikleri izinleri keşfedin

GET /api/v1/tools, anahtarınızın kullanabildiği araçları listeler. Bu istek, accountList için gereken izinleri ve onay koşullarını seçip gösterir. Taslak oluşturmak için ek yazma izinleri gerekir.

HTTP API

GET /api/v1/tools

Uygulamanız kataloğu okur ve kullanılabilir araçları çağırır.

MCP

tools/list

Desteklenen bir asistan araçları keşfeder ve aynı inceleme iş akışını izler.

Influence
  1. 1. Taslak hazırlayın

    Çalışma alanındaki hesap ve medyayla campaignDraftSave çağrısını yapın. Kesintiye uğrayan bir yanıtı kurtarmak için sürümü ve istek kimliğini saklayın. Taslak yazma işlemleri sunucu onayı gerektirir.

  2. 2. İncelemeyi hazırlayın

    Kaydedilen sürüm ve işlem için campaignReview çağrısını yapın. Onay istemeden önce hesapları, içeriği, medyayı, ayarları, zamanı ve geçerlilik bitişini gösterin.

  3. 3. Onaylanan işlemi yürütün

    campaignReviewExecute, tam olarak o incelemeye onay verilmesini gerektirir. Metin gönderileri için incelemenin tamamına yeni bir yanıt gerekir; medya için görsel onay gerekir. Sunucu, sağlayıcıyı doğrudan çağırmak yerine işlemi kalıcı zamanlayıcıya gönderir.

  4. 4. Yeniden denemeden önce sonucu okuyun

    Her hesabın durumunu ve varsa yayımlanmış gönderi bağlantısını okuyun. Sonucu belirsiz bir gönderim, sonuç netleşene kadar İnceleme gerekli durumunda kalır. Yeni bir gönderi oluşturmadan önce mevcut isteği kurtarın; aksi halde yinelenen bir gönderi gönderebilirsiniz.

Aracınız için bağlantıyı seçin

Influence: Aracınız için bağlantıyı seçin
BağlantıKullanım alanıErişim
HTTP APIUygulamanız kataloğu okur ve kullanılabilir araçları çağırır.Ortam değişkenindeki, izin kapsamı sınırlandırılmış bir Bearer kimlik bilgisi kullanın.
MCPDesteklenen bir asistan araçları keşfeder ve aynı inceleme iş akışını izler.Influence Ayarlar bölümünde asistan için verilen kurulumu izleyin. Kullanılabilirlik, ana uygulamaya ve verilen izinlere bağlıdır.

Katalog isteği

curl --fail-with-body 'https://influence.so/api/v1/tools' \
  --header "Authorization: Bearer $INFLUENCE_API_TOKEN" \
  | jq '{tools: [.tools[] | select(.name == "accountList") | {name, scopes, confirmation, mutability}]}'

Örnek katalog alanları

{
  "tools": [
    {
      "confirmation": "none",
      "mutability": "read",
      "name": "accountList",
      "scopes": [
        "integrations:read"
      ]
    }
  ]
}

Bu örnek alanlar araç tanımlarından gelir. Hangi işlemlerin kullanılabileceğini canlı katalog, kimlik bilgilerinin izin kapsamları ve bağlı hesaplar belirler.

Mavi kablolar, fotoğraf kartı tepsisini, blokları, bir damgayı, takvimi ve kapalı bir zarfı birbirine bağlıyor.

Oluşturabileceğiniz yayınlama iş akışları

Kendi içerik iş akışınızdan gönderiler

Kendi araçlarınızda bir makaleden, değişiklik günlüğünden veya topluluk duyurusundan taslak hazırlayın. Influence’tan yayını zamanlamasını istemeden önce hesapları, içeriği ve zamanı tüm ayrıntılarıyla incelemeye sunun.

Yanıt kaybolduğunda isteğin sonucunu bulun

Asıl isteği ve idempotency anahtarını saklayın, ardından sonucunu sorgulayın. Sonucu belirsiz olan bir gönderim, ne olduğunu doğrulayana kadar “İnceleme gerekli” durumunda kalır. Yerine yeni bir istek oluşturmak, aynı gönderinin 2 kez yayınlanmasına yol açabilir.

Influence IQ ile ilk taslağınızı hazırlayın

Düzenleyebileceğiniz taslaklar için Influence IQ’ya bir makale, proje notları veya topluluk güncellemesi ile kayıtlı marka yönergelerinizi verin. Kullanılabilir ve kullanımına yetki verilmiş yapay zeka araçları IQ kredisi kullanır; onay gereklilikleri geçerliliğini korur.

Düzenlenebilir gönderiler ve önerilen tarihler için notlarınızı ve kayıtlı marka yönergelerinizi Influence IQ ile paylaşın. Taslak hazırlama ve görsel oluşturma, IQ kredisi kullanır. Başlamadan önce görsel oluşturma için verilen maliyet teklifini, yayınlamadan önce de tamamlanan içeriği inceleyin.

Influence IQ’yu keşfet

Yapay zeka asistanıyla başlayın

Desteklenen bir Influence bağlantısıyla ChatGPT veya Claude üzerinden kampanya planlayabilir ve taslakları düzenleyebilirsiniz. Asistanınızdan erişebildiği görsel ve videoları yüklemesini isteyin ya da Influence içindeki hazır medyayı yeniden kullanın. Dosyaya erişemiyorsa önce dosyayı Influence üzerinden yükleyin. Hesapları, metni, medyayı, ayarları ve zamanı tüm ayrıntılarıyla inceleyin. Ardından, desteklenen bir sohbet içi karttan ya da incelemenin tamamını gördükten sonra yeni bir “onaylıyorum” yanıtıyla onay verin. TikTok Direct için sohbette paylaşım tercihlerinizi belirtin ve paylaşıma rıza verin, sonra güncellenen incelemeyi onaylayın. İnceleme kartı isteğe bağlıdır. Kurulum ve bağlantı durumunu Ayarlar bölümünden kontrol edin.

Bağlı hesaplarınızda yayınlayın

Çalışma alanınızda kullanılabilen hesapları seçin. Her hedef için metni ve desteklenen medyayı düzenleyin, ardından yayınlamadan önce gönderileri inceleyin.

Sonraki gönderilerinizi hazırlayın

Hesaplarınızı ekleyin, gönderilerinizi hazırlayın ve tarihlerini seçin. Zamanlamadan önce içeriği inceleyin.

Başla

Sık sorulan sorular

API ve MCP iş akışıyla neler yapılabilir?
Etkin araçlara ve izinlerinize bağlı olarak bir API veya MCP istemcisi bağlı hesaplar, kayıtlı taslaklar, desteklenen medya, gönderi incelemeleri, zamanlamalar ve gönderim durumuyla çalışabilir.
API veya MCP çağrıları onayı atlar mı?
Hayır. Sunucu her aracın onay gerekliliklerini uygular. Yayınlamak için güncel incelemenin onaylanması gerekir. İşlem yürütülürken gönderim zamanlanmadan önce çalışma alanı, izinler, hesaplar ve içerik kontrol edilir.
Asistan iş akışı hangi medyaları kabul eder?
Asistanınızdan erişebildiği görsel ve videoları yüklemesini isteyin ya da Influence içindeki hazır medyayı yeniden kullanın. Dosyaya erişemiyorsa önce dosyayı Influence üzerinden yükleyin. Hesapları, metni, medyayı, ayarları ve zamanı tüm ayrıntılarıyla inceleyin. Ardından, desteklenen bir sohbet içi karttan ya da incelemenin tamamını gördükten sonra yeni bir “onaylıyorum” yanıtıyla onay verin. TikTok Direct için sohbette paylaşım tercihlerinizi belirtin ve paylaşıma rıza verin, sonra güncellenen incelemeyi onaylayın. İnceleme kartı isteğe bağlıdır.
Kayıp yanıt veya sonucu belirsiz gönderim durumunda ne yapmalısınız?
Asıl isteğin sonucuna ulaşın ve kayıtlı durumu kontrol edin. Sonucu belirsiz bir gönderimi yinelemeyin. Gerçek sonuç, kayıtlar karşılaştırılarak doğrulanmadan “İnceleme gerekli” durumu çözümlenmiş sayılmaz.
MCP desteği, asistanın çalıştığı her ortamla uyumluluğu garanti eder mi?
Hayır. Oturum açın; kurulum yönergelerini ve güncel bağlantı durumunu kontrol etmek için Ayarlar → Uygulamalar ve otomasyonlar → Asistanınızı bağlayın yolunu izleyin.
Bir entegrasyon zamanlanmış veya yayınlanmış gönderiyi düzenleyebilir mi?
Gönderim başlamadıysa ve sonucu belirsiz hiçbir gönderim yoksa zamanlanmış bir gönderi, düzenleme ve yeniden inceleme için taslağa dönebilir. Asistan, bir ağda zaten yayınlanmış içeriği düzenleyemez veya silemez.