Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Käytä sometyökaluja Vercel AI SDK:ssa: Instagram, TikTok ja muut

Vercel AI SDK saa sometyökalut Instagramille, TikTokille, Facebookille, WhatsAppille ja muille kanaville easyCoexistencen MCP-palvelimelta. @ai-sdk/mcp-paketin createMCPClient avaa HTTP-yhteyden osoitteeseen https://easycoexistence.com/api/mcp, kirjautumisen hoitaa OAuthClientProvider, jonka rakennat itse, ja clientin tools() syötetään generateText- tai streamText-funktioon julkaisemaan, ajastamaan, vastaamaan kommentteihin ja DM-viesteihin sekä lukemaan tilastot kunkin verkoston virallisen rajapinnan kautta.

auth()

@ai-sdk/mcp-funktio, joka viimeistelee OAuth-takaisinkutsun serverUrl-arvon ja authorizationCode-arvon perusteella sekä callbackState- ja callbackIssuer-arvot, kun ne ovat mukana.

isStepCount(1)

generateTextin oletus stopWhen, joten malli lukee työkalun tuloksen vain, jos stopWhen sallii lisää vaiheita.

HTTP

MCP-kuljetus, jonka AI SDK suosittelee tuotantoon; sen stdio-kuljetus on tarkoitettu vain paikallisille palvelimille.

1 hour

easyCoexistencen MCP-käyttötunnuksen elinikä; sen päivitystunnus on voimassa 60 päivää ja vaihtuu jokaisessa päivityksessä.

1,000 bytes

Suurin teksti, jonka yksi Instagram-DM-viesti kantaa UTF-8-koodauksella mitattuna, joten ääkköset ja emojit vievät siitä enemmän tilaa.

Miten AI SDK kirjautuu easyCoexistenceen?

OAuthClientProvider-toteutuksen kautta, jonka rakennat omaan tallennukseesi ja jota AI SDK:n auth()-funktio ohjaa. Ensimmäinen kutsu rekisteröi sovelluksesi easyCoexistenceen julkisena asiakkaana, tallentaa PKCE-verifioijan ja antaa suostumusosoitteen redirectToAuthorization-metodin kautta. Kutsu palauttaa REDIRECT-arvon, ja reittisi lähettää käyttäjän sinne. easyCoexistence ohjaa sitten takaisin callback-osoitteeseesi koodin kanssa, ja toinen auth()-kutsu, jossa on authorizationCode, vaihtaa sen tunnuksiin. Kun tunnukset on tallennettu, auth() käyttää päivitystunnusta uuden parin hankkimiseen, eikä käyttäjää lähetetä takaisin. Pidä redirectUrl ja rekisteröidyt redirect_uris täsmälleen samoina, sillä easyCoexistence vertaa niitä tarkasti.

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

Miten työkalut päätyvät generateTextiin?

createMCPClient-funktiosta HTTP-kuljetuksella, easyCoexistencen URL-osoitteella ja providerilla. tools() palauttaa palvelimen työkalut AI SDK:n työkaluina. Säilytä tehtävän vaatimat nimeltä ja anna ne generateTextille tai streamTextille. Aseta stopWhen isStepCount-funktiolla, sillä oletuksena kutsu pysähtyy yhteen vaiheeseen, eikä malli koskaan lue, mitä reply_to_comment palautti. Kirjoita verkostosäännöt instructions-parametriin, sillä nykyinen viite käyttää sitä mallin käyttäytymisen ohjaamiseen. Sulje client finally-lohkossa tai streamTextin onEnd-callbackissa, ettei yhteyksiä jää auki.

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

Minne tunnukset kannattaa tallentaa serverless-alustalla?

Paikkaan, joka säilyy yhden kutsun yli: tietokantariviin, Redisiin tai avain-arvo-tallennukseen, avaimena sen sovelluksesi käyttäjä, jolle tunnukset kuuluvat. Vercelin tai muun serverless-alustan funktio alkaa muistista tyhjästä, joten provider, joka pitää tunnuksia muuttujassa, lähettää käyttäjän takaisin suostumusruutuun kylmäkäynnistyksen jälkeen. Käyttötunnukset ovat voimassa tunnin ja päivitystunnukset 60 päivää, ja jokaisella käytöllä saa uuden päivitystunnuksen. Sovellus, joka kutsuu työkaluja vähintään kerran 60 päivän aikana, pysyy siis kirjautuneena. Pidä clientin rekisteröinti tunnusten vieressä, sillä provider lukee molemmat jokaisella yhteydellä.

Miten kommentit ja DM-viestit tulevat sovellukseen?

Allekirjoitettuina POST-pyyntöinä reittikäsittelijään, jonka set_social_webhook_destination rekisteröi tilille. Reittiin tulevat sen jälkeen Instagramin ja Facebookin kommentit, maininnat ja DM-viestit sekä TikTokin kommentit. Jokainen runko sisältää kentät platform, account_id, external_id ja entry, eli verkoston tapahtuman sellaisena kuin se lähetettiin. Lue runko tekstinä, tarkista X-EC-Signature-arvo sen tilin allekirjoitusavaimella ja vastaa nopeasti. easyCoexistence antaa reitille 8 sekuntia ja lähettää jokaisen tapahtuman kerran ilman uusintoja. Aseta tapahtuma jonoon ja anna työntekijän kutsua replyToEvent sillä, jolloin mallin aika ei koskaan kulu niihin 8 sekuntiin.

Mitä kukin verkosto antaa mallin tehdä?

Niin paljon kuin tilin API sallii. Ohjeissa kannattaa kertoa se tarkasti:

  • Instagram: julkaisut, Reelsit ja Storyt JPEG-kuvilla. DM-vastaukset vain ihmisille, jotka ovat kirjoittaneet viimeisen 24 tunnin aikana, enintään 1 000 tavua.
  • Facebook: Sivun julkaisut, kommenttivastaukset ja Messenger-vastaukset samalla 24 tunnin rajalla.
  • TikTok: videot ja kuvajulkaisut. Kommenttivastaukset ovat aina julkisia, ja videon ID toimii post_id-arvona. DM-viestejä ei ole.
  • WhatsApp: send_message enintään 24 tuntia asiakkaan viimeisestä viestistä, send_template kaikille muille.
  • YouTube ja LinkedIn: lataukset ja julkaisut, kun käyttäjä pyytää, sekä kommenttivastaukset ja analytiikka. Kumpikaan ei välitä tapahtumia, joten sovellus lukee uudet kommentit ajastetusti.

Yleiset virheet

  • Stopwhen jätetään oletukseksi. generateText pysähtyy ensimmäiseen vaiheeseen, joten malli kutsuu reply_to_commentia eikä koskaan saa tietää, lähtikö vastaus. Salli muutama vaihe isStepCount-funktiolla.
  • Tunnusten pitäminen moduulitason muuttujassa serverless-alustalla. Seuraava kylmäkäynnistys ei löydä niitä, ja käyttäjä päätyy suostumusruutuun uudelleen. Tallenna ne paikkaan, johon `tokens()` ja `saveTokens()` yltävät tietokantaan.
  • Yhden uudelleenohjausosoitteen rekisteröinti ja toisen lähettäminen. easyCoexistence tarkistaa redirect_uri-arvon rekisteröintiä vastaan täsmälleen, joten loppuviiva tai eri polku päättää kirjautumisen virhesivulle.
  • Tilin oman toiminnan vastaaminen. Instagram lähettää tilin DM-viestit takaisin kaikuina, ja sen julkiset vastaukset palaavat kommentteina. Ohita molemmat ennen kuin kehote menee mallille.
Näin teet tämän EasyCoexistencen avulla

easyCoexistence antaa Vercel AI SDK:lla rakentamillesi agenteille yhteyden asiakkaisiin WhatsAppissa, Instagramissa, Facebookissa, TikTokissa, YouTubessa, LinkedInissä ja muissa kanavissa, kukin virallisen rajapintansa kautta. Mukana ovat MCP-työkalut OAuth-kirjautumisen takana, allekirjoitetut tapahtumat kommenteille ja DM-viesteille sekä julkaisujono jopa 90 päivää eteenpäin. Jokainen yhteys valvotaan 24/7. Hinta on US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, ja se laskee yhteyksien määrän kasvaessa. Ensimmäiset 3 päivää ovat ilmaisia.

Usein kysytyt kysymykset

Vaatiiko tämä Next.js-kehyksen tai Vercel-hostauksen?

Ei. AI SDK toimii Node.js-ympäristössä, joten mikä tahansa isäntä, joka palvelee HTTPS-reitin, käy. MCP-asiakas tarvitsee vain lähtevän HTTPS-yhteyden osoitteeseen easycoexistence.com.

Voiko chat-käyttöliittymä striimata työkalukutsut?

Kyllä. Anna samat työkalut streamTextille ja sulje MCP-asiakas sen onEnd-callbackissa, kuten AI SDK dokumentoi striimatuille vastauksille.

Voiko sama sovellus vastata WhatsApp-viesteihin?

Kyllä. Numeron työkalut tulevat samasta asiakkaasta. list_numbers palauttaa connection_id-arvon, ja send_message lähettää viestin enintään 24 tuntia asiakkaan viimeisimmästä viestistä. AI SDK:n WhatsApp-opas käsittelee viestien vastaanottamisen.

Mitä easyCoexistence maksaa AI SDK -sovellukselle?

US$ 9:stä US$ 0,75:een per yhteys kuukaudessa. Hinta laskee yhteyksien määrän kasvaessa ja on sama jokaisessa verkostossa. MCP-palvelin ja Partner API kuuluvat hintaan, ja ensimmäiset 3 päivää ovat ilmaisia.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu