Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Vercel AI SDK'da sosyal medya araçlarını kullanın: Instagram, TikTok ve daha fazlası

Vercel AI SDK, easyCoexistence'ın MCP sunucusu üzerinden Instagram, TikTok, Facebook, WhatsApp ve diğer kanallar için sosyal medya araçlarını kullanır. @ai-sdk/mcp paketindeki createMCPClient, https://easycoexistence.com/api/mcp adresine bir HTTP bağlantısı açar; sizin yazdığınız bir OAuthClientProvider oturum açmayı yürütür ve istemcinin tools() çıktısı generateText ya da streamText içine konarak her ağın resmi API'si üzerinden gönderi yayınlanabilir, zamanlanabilir, yorum ve DM'ler yanıtlanabilir ve içgörüler okunabilir.

auth()

@ai-sdk/mcp fonksiyonu, serverUrl ve authorizationCode ile OAuth geri çağrısını tamamlar; varsa callbackState ve callbackIssuer da eklenir.

isStepCount(1)

generateText'in varsayılan stopWhen değeri; model, stopWhen daha fazla adıma izin vermedikçe bir aracın sonucunu okumaz.

HTTP

AI SDK'nın üretim için önerdiği MCP taşıma yöntemi; stdio taşımasının yalnızca yerel sunucular için olduğu belirtilir.

1 hour

Bir easyCoexistence MCP erişim token'ının geçerlilik süresi; yenileme token'ı 60 gündür ve her yenilemede değiştirilir.

1,000 bytes

Bir Instagram DM'ine sığan en fazla metin UTF-8 ile ölçülür; bu nedenle aksanlar ve emoji daha fazla yer kaplar.

AI SDK easyCoexistence'a nasıl giriş yapar?

Kendi depolamanızın üzerine kurduğunuz bir OAuthClientProvider aracılığıyla; AI SDK'nın auth() fonksiyonu bunu yönetir. İlk çağrı uygulamanızı easyCoexistence'a herkese açık bir istemci olarak kaydeder, PKCE doğrulayıcısını saklar ve onay URL'sini redirectToAuthorization ile size verir; fonksiyon REDIRECT döndürür ve rotanız kullanıcıyı oraya gönderir. easyCoexistence ardından kullanıcıyı bir kodla birlikte geri çağrı adresinize yönlendirir ve authorizationCode ile yapılan ikinci auth() çağrısı bu kodu token'lara çevirir. Token'lar saklandıktan sonra auth() kullanıcıyı yeniden yönlendirmek yerine yenileme token'ıyla yeni bir çift alır. redirectUrl ile kayıtlı redirect_uris değerlerini birebir aynı tutun; easyCoexistence bunları tam olarak eşleştirir.

An OAuthClientProvider over your database, with the two routes it needs
import { auth, type OAuthClientProvider } from "@ai-sdk/mcp";

export const MCP_URL = "https://easycoexistence.com/api/mcp";
const CALLBACK = "https://app.example.com/api/easycoexistence/callback";

// db is your own key-value store (Postgres, Redis, Vercel KV); one set of keys per user
export function easyAuth(userId: string): OAuthClientProvider {
  const k = (name: string) => "easycoexistence:" + userId + ":" + name;
  return {
    get redirectUrl() { return CALLBACK; },
    get clientMetadata() {
      return {
        client_name: "Acme app", // shown on easyCoexistence's consent screen
        redirect_uris: [CALLBACK],
        grant_types: ["authorization_code", "refresh_token"],
        response_types: ["code"],
        token_endpoint_auth_method: "none", // easyCoexistence registers public clients
      };
    },
    clientInformation: () => db.get(k("client")),
    saveClientInformation: (info) => db.set(k("client"), info),
    isClientInformationDynamicallyRegistered: async () => Boolean(await db.get(k("client"))),
    tokens: () => db.get(k("tokens")),
    saveTokens: (tokens) => db.set(k("tokens"), tokens),
    saveCodeVerifier: (verifier) => db.set(k("verifier"), verifier),
    codeVerifier: () => db.get(k("verifier")),
    redirectToAuthorization: (url) => db.set(k("sign-in"), url.href),
  };
}

// GET /api/easycoexistence/connect: send the user to the consent screen
export async function connect(userId: string) {
  const result = await auth(easyAuth(userId), { serverUrl: MCP_URL });
  if (result === "AUTHORIZED") return new Response("Already connected");
  return Response.redirect(await db.get("easycoexistence:" + userId + ":sign-in"));
}

// GET /api/easycoexistence/callback: trade the code for tokens
export async function callback(req: Request, userId: string) {
  const code = new URL(req.url).searchParams.get("code");
  if (!code) return new Response("Sign-in was cancelled", { status: 400 });
  await auth(easyAuth(userId), { serverUrl: MCP_URL, authorizationCode: code });
  return Response.redirect("https://app.example.com/settings");
}

Araçlar generateText'e nasıl ulaşır?

createMCPClient fonksiyonundan; HTTP taşımasıyla, easyCoexistence URL'siyle ve sağlayıcıyla. tools() sunucunun araçlarını AI SDK araçları olarak döndürür; işin ihtiyaç duyduğu araçları adlarıyla seçip generateText ya da streamText'e geçirin. stopWhen değerini isStepCount ile ayarlayın, çünkü varsayılan olarak çağrı bir adımdan sonra durur ve model reply_to_comment'in ne döndürdüğünü hiç okumaz. Ağ kurallarını, güncel referansın model davranışı için kullandığı instructions parametresine yazın. İstemciyi bir finally bloğunda ya da streamText'in onEnd geri çağrısında kapatın; böylece açık kalan bir bağlantı olmaz.

Reply to one forwarded comment or DM with a filtered set of tools
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText, isStepCount, type LanguageModel } from "ai";
import { easyAuth, MCP_URL } from "./easycoexistence-auth";

const REPLY_TOOLS = new Set(["list_social_comments", "reply_to_comment", "hide_comment", "send_social_dm"]);

export async function replyToEvent(userId: string, model: LanguageModel, event: unknown) {
  const mcp = await createMCPClient({
    transport: { type: "http", url: MCP_URL, authProvider: easyAuth(userId) },
  });
  try {
    const tools = Object.fromEntries(
      Object.entries(await mcp.tools()).filter(([name]) => REPLY_TOOLS.has(name)),
    );
    const { text } = await generateText({
      model,
      tools,
      stopWhen: isStepCount(4),
      instructions:
        "Reply to comments and DMs for Acme on the event's account_id. TikTok replies are public " +
        "and need the video ID as post_id. Instagram DMs only go to people who wrote in the last 24 hours.",
      prompt: JSON.stringify(event),
    });
    return text;
  } finally {
    await mcp.close();
  }
}

Sunucusuz bir hostta token'lar nerede tutulmalı?

Tek bir çağrıdan uzun yaşayan her yerde: uygulamanızın kullanıcısıyla anahtarlanmış bir veritabanı satırında, Redis'te ya da bir anahtar-değer deposunda. Vercel veya başka bir sunucusuz platformdaki bir fonksiyon bellekte hiçbir şeyle başlamaz; bu yüzden token'ları bir değişkende tutan bir sağlayıcı, soğuk başlatmadan sonra kullanıcıyı onay ekranına geri gönderir. Erişim token'ları bir saat, yenileme token'ları 60 gün geçerlidir ve her kullanımda yeni bir yenileme token'ı verilir; bu nedenle uygulama araçları 60 günde en az bir kez çağırırsa oturum açık kalır. İstemci kaydını token'ların yanında tutun, çünkü sağlayıcı her bağlantıda ikisini de okur.

Yorumlar ve DM'ler uygulamaya nasıl ulaşır?

set_social_webhook_destination'ın bir hesap için kaydettiği bir rota işleyicisine imzalı POST istekleri olarak; bu işleyici Instagram ve Facebook yorumlarını, bahsetmeleri ve DM'leri ile TikTok yorumlarını alır. Her gövde platform, account_id, external_id ve entry alanlarını içerir; entry, ağın olayını gönderildiği biçimiyle taşır. Gövdeyi metin olarak okuyun, X-EC-Signature değerini hesabın imzalama sırrıyla karşılaştırın ve hızlı yanıt verin: easyCoexistence rotaya 8 saniye tanır ve her olayı yalnızca bir kez gönderir, yeniden deneme yapmaz. Olayı bir kuyruğa koyun ve bir işçinin onu replyToEvent ile çağırmasını sağlayın; böylece modelin harcadığı süre 8 saniyeye sayılmaz.

Her ağ modele neleri yapmasına izin verir?

Hesabın API'sinin izin verdiği kadar; talimatlar bunu açıkça belirtmelidir:

  • Instagram: JPEG görsellerle gönderiler, Reels ve Hikâyeler; DM yanıtları yalnızca son 24 saat içinde yazan kişilere ve en fazla 1.000 bayt olacak şekilde.
  • Facebook: Sayfa gönderileri, yorum yanıtları ve aynı 24 saat içinde Messenger yanıtları.
  • TikTok: videolar ve fotoğraf gönderileri; yorum yanıtları her zaman herkese açık olur, post_id olarak videonun ID'si kullanılır ve DM yoktur.
  • WhatsApp: send_message, müşterinin son mesajından itibaren 24 saat içinde; send_template ise diğer herkes içindir.
  • YouTube ve LinkedIn: kullanıcı istediğinde yüklemeler ve gönderiler, yorum yanıtları ve analitik; ikisi de olay iletmez, bu yüzden uygulama yeni yorumları bir zamanlamayla okur.

Yaygın hatalar

  • stopWhen değerini varsayılanda bırakmak. generateText ilk adımdan sonra durur; model reply_to_comment çağırır ama yanıtın gidip gitmediğini hiç öğrenmez. isStepCount ile birkaç adıma izin verin.
  • Token'ları sunucusuz bir hostta modül düzeyindeki bir değişkende tutmak. Bir sonraki soğuk başlatmada hiçbir token kalmaz ve kullanıcı yeniden onay ekranına düşer; token'ları tokens() ve saveTokens() fonksiyonlarının ulaşabildiği bir veritabanına kaydedin.
  • Kayıtlı yönlendirme URL'sinden farklı bir URL göndermek. easyCoexistence redirect_uri değerini kayıtla birebir karşılaştırır; sonundaki bir eğik çizgi ya da farklı bir yol, oturum açmayı bir hata sayfasında bitirir.
  • Hesabın kendi etkinliğine yanıt vermek. Instagram, hesabın DM'lerini yankı olarak geri gönderir ve kamuya açık yanıtlar yorum olarak döner; istem modele ulaşmadan önce ikisini de atlayın.
Bunu EasyCoexistence'la yapmak

easyCoexistence, Vercel AI SDK ile oluşturduğunuz ajanlara WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn ve diğer kanallardaki müşterilere erişim verir; her biri resmi API'si üzerinden çalışır: OAuth oturum açmanın arkasındaki MCP araçları, yorumlar ve DM'ler için imzalı olaylar ve 90 güne kadar önceden planlanabilen bir yayın kuyruğu; her bağlantı 7/24 izlenir. Bağlantı başına aylık US$ 9'dan başlayıp bağlantı ekledikçe US$ 0.75'e kadar düşen fiyatlarla; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

Bu Next.js ya da Vercel barındırması gerektirir mi?

Hayır. AI SDK Node.js üzerinde çalışır; bu yüzden HTTPS rotası sunan her barındırma hizmeti uygundur ve MCP istemcisinin yalnızca easycoexistence.com'a giden HTTPS trafiğine ihtiyacı vardır.

Bir sohbet arayüzü araç çağrılarını akış olarak gösterebilir mi?

Evet. Aynı araçları streamText'e geçirin ve MCP istemcisini onEnd geri çağrısında kapatın; AI SDK bunu akışlı yanıtlar için belgeler.

Aynı uygulama WhatsApp mesajlarını yanıtlayabilir mi?

Evet. Numaranın araçları aynı istemciden gelir: connection_id için list_numbers, ardından müşterinin son mesajından itibaren 24 saat içinde send_message. Mesajları almayı AI SDK'nın WhatsApp rehberi anlatır.

Bir AI SDK uygulaması için easyCoexistence ne kadara mal olur?

Bağlantı başına aylık US$ 9'dan başlayıp bağlantı ekledikçe US$ 0.75'e kadar düşer; her ağda aynı fiyat geçerlidir. MCP sunucusu ve Partner API bu fiyata dahildir; ilk 3 gün ücretsiz deneme.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi