Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Koristite alate za društvene mreže u Vercel AI SDK-u: Instagram, TikTok i drugi

Vercel AI SDK dobiva alate za društvene mreže: Instagram, TikTok, Facebook, WhatsApp i druge kanale iz MCP poslužitelja easyCoexistencea. createMCPClient iz paketa @ai-sdk/mcp otvara HTTP vezu prema https://easycoexistence.com/api/mcp, OAuthClientProvider koji napišete čuva prijavu, a tools() klijenta ulazi u generateText ili streamText radi objavljivanja, zakazivanja, odgovaranja na komentare i izravne poruke te čitanja uvida kroz službeni API svake mreže.

auth()

Funkcija iz @ai-sdk/mcp koja dovršava OAuth povratni poziv iz serverUrl i authorizationCode, uz callbackState i callbackIssuer kada postoje.

isStepCount(1)

Zadani stopWhen funkcije generateText, pa model čita rezultat alata samo ako stopWhen dopušta više koraka.

HTTP

MCP transport koji AI SDK preporučuje za produkciju; njegov stdio transport namijenjen je samo lokalnim poslužiteljima.

1 hour

Vijek trajanja MCP pristupnog tokena easyCoexistencea; njegov refresh token traje 60 dana i zamjenjuje se pri svakom osvježavanju.

1,000 bytes

Najveći tekst koji jedna Instagram izravna poruka može nositi, mjereno u UTF-8, pa slova s dijakriticima i emoji zauzimaju više prostora.

Kako se AI SDK prijavljuje u easyCoexistence?

Preko OAuthClientProvidera koji sami implementirate nad vlastitom pohranom, a njime upravlja funkcija auth() iz AI SDK-a. Prvi poziv registrira vašu aplikaciju kod easyCoexistencea kao javnog klijenta, sprema PKCE verifikator i preko redirectToAuthorization vam predaje URL za odobrenje; vraća vrijednost REDIRECT, a vaša ruta šalje korisnika tamo. easyCoexistence zatim preusmjerava na vaš povratni poziv s kodom, a drugi poziv auth() s authorizationCode mijenja ga za tokene. Kad su tokeni pohranjeni, auth() koristi refresh token za novi par umjesto da korisnika vrati na prijavu. Držite redirectUrl i registrirane redirect_uris identičnima jer ih easyCoexistence uspoređuje točno.

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");
}

Kako alati dolaze do generateText?

Iz createMCPClient s HTTP transportom, easyCoexistence URL-om i providerom. tools() vraća alate poslužitelja kao AI SDK alate; po nazivu zadržite samo one koji su potrebni i prosljedite ih u generateText ili streamText. Postavite stopWhen s isStepCount, jer se poziv zadano zaustavlja nakon jednog koraka i model nikada ne pročita što je reply_to_comment vratio. Pravila za mrežu stavite u instructions, parametar koji aktualna referenca koristi za ponašanje modela. Zatvorite klijenta u finally bloku ili u funkciji onEnd od streamText, da ne ostane otvorena nijedna veza.

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();
  }
}

Gdje tokeni trebaju biti na serverless hostu?

Bilo gdje što nadživljava jedan poziv: u retku baze podataka, Redisu ili spremištu ključeva i vrijednosti, s ključem korisnika vaše aplikacije kojem tokeni pripadaju. Funkcija na Vercelu ili nekoj drugoj serverless platformi kreće bez ičega u memoriji, pa provider koji tokene drži u varijabli modula nakon hladnog starta korisnika šalje natrag na zaslon za odobrenje. Pristupni tokeni traju sat, a refresh tokeni 60 dana, uz novi refresh token pri svakoj upotrebi, pa aplikacija koja pozove alate barem jednom u 60 dana ostaje prijavljena. Registraciju klijenta držite uz tokene, jer ih provider čita pri svakom povezivanju.

Kako komentari i izravne poruke dolaze do aplikacije?

Kao potpisani POST zahtjevi na route handler koji set_social_webhook_destination registrira za račun. Na njega stižu komentari, spominjanja i izravne poruke na Instagramu i Facebooku te komentari na TikToku. Svako tijelo zahtjeva sadrži platform, account_id, external_id i entry, događaj mreže onako kako je poslan. Čitajte tijelo kao tekst, provjerite X-EC-Signature prema njemu uz tajni ključ za potpisivanje računa i odgovorite brzo: easyCoexistence daje ruti 8 sekundi i šalje svaki događaj jednom, bez ponovnog pokušaja. Stavite događaj u red čekanja i neka radnik pozove replyToEvent s njim, da se vrijeme modela ne broji u tih 8 sekundi.

Što svaka mreža dopušta modelu?

Onoliko koliko API računa dopušta, što upute trebaju jasno navesti:

  • Instagram: objave, Reels i Stories s JPEG slikama; odgovori na izravne poruke samo onima koji su pisali u posljednja 24 sata, u najviše 1,000 bajtova.
  • Facebook: objave na stranici, odgovori na komentare i odgovori u Messengeru unutar istih 24 sata.
  • TikTok: videozapisi i objave fotografija; odgovori na komentare uvijek su javni, s ID-em videozapisa kao post_id, a izravnih poruka nema.
  • WhatsApp: send_message unutar 24 sata od posljednje poruke korisnika, send_template za sve ostale.
  • YouTube i LinkedIn: učitavanja i objave kada korisnik to zatraži, odgovori na komentare i analitika; nijedna ne prosljeđuje događaje, pa aplikacija nove komentare čita prema rasporedu.

Uobičajene pogreške

  • Ostavljanje stopWhen na zadanoj vrijednosti. generateText se zaustavlja nakon prvog koraka, pa model pozove reply_to_comment i nikada ne sazna je li odgovor otišao; dopustite nekoliko koraka s isStepCount.
  • Držanje tokena u varijabli na razini modula na serverless hostu. Nakon sljedećeg hladnog starta nema ih, pa se korisnik ponovno nađe na zaslonu za odobrenje; spremite ih tamo gdje tokens() i saveTokens() dosežu bazu podataka.
  • Registriranje jedne povratne URL adrese, a slanje druge. easyCoexistence provjerava redirect_uri točno prema registraciji, pa kosa crta na kraju ili drugi put prijavu završi na stranici s pogreškom.
  • Odgovaranje na vlastitu aktivnost računa. Instagram šalje izravne poruke računa natrag kao odjeke, a njegovi javni odgovori vraćaju se kao komentari, pa oba preskočite prije nego upit stigne do modela.
Radite ovo uz EasyCoexistence

easyCoexistence agentima koje gradite s Vercel AI SDK-om daje doseg do kupaca na WhatsAppu, Instagramu, Facebooku, TikToku, YouTubeu, LinkedInu i drugim kanalima, svakom kroz službeni API: MCP alati iza OAuth prijave, potpisani događaji za komentare i izravne poruke te red za objave do 90 dana unaprijed, uz praćenje svake veze 24/7. US$ 9 do US$ 0.75 po vezi mjesečno, a cijena pada kako dodajete veze, uz prva 3 dana koja su besplatna.

Često postavljana pitanja

Treba li ovo Next.js ili Vercel hosting?

Ne. AI SDK radi u Node.js-u, pa svaki host koji poslužuje HTTPS rutu radi, a MCP klijentu treba samo odlazni HTTPS prema easycoexistence.com.

Može li chat sučelje streamati pozive alata?

Može. Prosljedite iste alate u streamText i zatvorite MCP klijenta u njegovoj funkciji onEnd, kako AI SDK dokumentira za streamirane odgovore.

Može li ista aplikacija odgovarati na WhatsApp poruke?

Može. Alati broja dolaze kroz isti klijent: list_numbers za connection_id, zatim send_message unutar 24 sata od posljednje poruke korisnika. Vodič AI SDK-a za WhatsApp pokriva primanje tih poruka.

Koliko košta easyCoexistence za aplikaciju s AI SDK-om?

US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, jednako na svakoj mreži. MCP poslužitelj i Partner API su uključeni, a prva 3 dana su besplatna.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na