Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

Gamitin ang social media tools sa Vercel AI SDK: Instagram, TikTok at marami pa

Makakakuha ang Vercel AI SDK ng social media tools para sa Instagram, TikTok, Facebook, WhatsApp at iba pang channel mula sa MCP server ng easyCoexistence. Binubuksan ng createMCPClient, mula sa @ai-sdk/mcp package, ang HTTP connection sa https://easycoexistence.com/api/mcp. Ang OAuthClientProvider na isusulat ninyo ang mag-iingat ng sign-in, at ang tools() ng client ay ipapasa sa generateText o streamText para mag-publish, mag-schedule, mag-reply sa comments at DMs, at magbasa ng insights sa pamamagitan ng opisyal na API ng bawat network.

auth()

Ang function ng @ai-sdk/mcp na tumatapos ng OAuth callback mula sa serverUrl at authorizationCode, kasama ang callbackState at callbackIssuer kung mayroon.

isStepCount(1)

Ang default na stopWhen ng generateText, kaya nagbabasa lang ang model ng resulta ng tool kapag pinapayagan ito ng stopWhen na magkaroon ng mas maraming hakbang.

HTTP

Ang MCP transport na inirerekomenda ng AI SDK para sa production; ang stdio transport nito ay para lang sa mga lokal na server.

1 hour

Ang buhay ng access token ng easyCoexistence MCP; ang refresh token nito ay tumatagal ng 60 araw at pinapalitan tuwing magre-refresh.

1,000 bytes

Ang pinakamaraming teksto na kayang dalhin ng isang Instagram DM, sinusukat sa UTF-8, kaya mas malaki ang nakukuha ng mga accent at emoji.

Paano nag-si-sign in ang AI SDK sa easyCoexistence?

Sa pamamagitan ng OAuthClientProvider na ipapatupad ninyo sa sarili ninyong storage, na pinapatakbo ng auth() function ng AI SDK. Ang unang tawag ay nagre-register ng app ninyo sa easyCoexistence bilang public client, sine-save ang PKCE verifier, at ibinibigay sa inyo ang consent URL sa pamamagitan ng redirectToAuthorization; nagbabalik ito ng REDIRECT, at ipinapadala ng route ninyo roon ang user. Pagkatapos, nagre-redirect ang easyCoexistence pabalik sa callback ninyo na may code, at ang pangalawang auth() call na may authorizationCode ay pinapalitan ito ng token. Kapag naka-save na ang token, gumagamit ang auth() ng refresh token para kumuha ng bagong pares sa halip na ibalik ang user. Panatilihing magkapareho ang redirectUrl at ang nakarehistrong redirect_uris, dahil eksaktong itinutugma ito ng easyCoexistence.

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

Paano nakakarating ang mga tool sa generateText?

Mula sa createMCPClient gamit ang HTTP transport, ang easyCoexistence URL, at ang provider. Ibinabalik ng tools() ang mga tool ng server bilang AI SDK tools; piliin lang ang mga kailangan ng trabaho ayon sa pangalan at ipasa ang mga ito sa generateText o streamText. Itakda ang stopWhen gamit ang isStepCount, dahil bilang default ay humihinto ang tawag pagkatapos ng isang hakbang at hindi mababasa ng model ang ibinalik ng reply_to_comment. Ilagay ang mga patakaran ng network sa instructions, ang parameter na ginagamit ng kasalukuyang reference para sa behavior ng model. Isara ang client sa finally block, o sa onEnd callback ng streamText, para walang naiwang bukas na koneksyon.

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

Saan dapat nakalagay ang mga token sa serverless host?

Saanman na tumatagal nang higit sa isang invocation: isang database row, Redis o key-value store, na naka-key sa user ng app ninyo na pag-aari ng mga token. Nagsisimula ang isang function sa Vercel o ibang serverless platform na walang laman sa memory, kaya ang provider na nagtatago ng token sa variable ay ibinabalik ang user sa consent screen pagkatapos ng cold start. Ang access token ay tumatagal ng isang oras at ang refresh token ng 60 araw, na may bagong refresh token sa bawat paggamit, kaya mananatiling naka-sign in ang app na tumatawag ng tools kahit isang beses kada 60 araw. Itabi ang client registration sa tabi ng mga token, dahil binabasa ito ng provider sa bawat koneksyon.

Paano nakakarating sa app ang mga comment at DM?

Bilang signed POST sa route handler na irerehistro ng set_social_webhook_destination para sa isang account, at ito ang tatanggap ng mga comment, mention at DM sa Instagram at Facebook, pati mga comment sa TikTok. Ang bawat body ay may platform, account_id, external_id at entry, ang event ng network na eksaktong ipinadala nito. Basahin ang body bilang text, itugma ang X-EC-Signature dito gamit ang signing secret ng account, at sumagot agad: 8 segundo lang ang ibinibigay ng easyCoexistence sa route at isang beses lang nagpapadala ng bawat event, walang retry. Ilagay ang event sa queue at hayaang tawagin ng worker ang replyToEvent gamit ito, para hindi mabilang sa 8 segundo ang oras ng model.

Ano ang maaaring gawin ng model sa bawat network?

Kasing dami ng pinapayagan ng API ng account, na dapat ilarawan nang malinaw sa instructions:

  • Instagram: post, Reel at Story gamit ang JPEG na larawan; mga DM reply lang sa mga taong sumulat sa loob ng huling 24 oras, hanggang 1,000 byte.
  • Facebook: Page post, comment reply at Messenger reply sa loob ng parehong 24 oras.
  • TikTok: video at photo post; laging public ang comment reply, gamit ang ID ng video bilang post_id, at walang DM.
  • WhatsApp: send_message sa loob ng 24 oras mula sa huling mensahe ng customer, send_template para sa sinumang iba.
  • YouTube at LinkedIn: mga upload at post kapag hiniling ng user, comment reply at analytics; hindi nagpapasa ng event ang alinman sa dalawa, kaya binabasa ng app ang mga bagong comment ayon sa iskedyul.

Mga karaniwang pagkakamali

  • Pagpapabayaan ang stopWhen sa default nito. Humihinto ang generateText pagkatapos ng unang hakbang, kaya tinatawag ng model ang reply_to_comment pero hindi nito nalalaman kung naipadala ang reply; payagan ang ilang hakbang gamit ang isStepCount.
  • Pagtatago ng token sa module-level variable sa serverless host. Wala na ito pagdating ng susunod na cold start, at mapupunta muli ang user sa consent screen; i-save ang mga ito kung saan maaabot ng tokens() at saveTokens() ang database.
  • Pagrerehistro ng isang redirect URL tapos pagpapadala ng iba. Eksaktong sinusuri ng easyCoexistence ang redirect_uri laban sa pagrerehistro, kaya ang trailing slash o ibang path ay nagtatapos ng sign-in sa error page.
  • Pagsagot sa sariling aktibidad ng account. Ibinabalik ng Instagram ang mga DM ng account bilang echo at ang mga pampublikong reply ay bumabalik bilang comment, kaya laktawan ang dalawa bago makarating ang prompt sa model.
Ginagawa ito gamit ang EasyCoexistence

Binibigyan ng easyCoexistence ang mga agent na gawa ninyo gamit ang Vercel AI SDK ng abot sa mga customer sa WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn at iba pang channel, bawat isa sa pamamagitan ng opisyal nitong API: MCP tools sa likod ng OAuth sign-in, event na may signature para sa comment at DM, at pila ng pag-post hanggang 90 araw nang maaga. Ang bawat koneksyon ay may pagmo-monitor 24/7. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang nagdadagdag kayo ng koneksyon, at libre ang unang 3 araw.

Mga madalas itanong

Kailangan ba ng Next.js o Vercel hosting?

Hindi. Tumatakbo ang AI SDK sa Node.js, kaya gumagana ang anumang host na nagsisilbi ng HTTPS route, at kailangan lang ng MCP client ng outbound HTTPS papunta sa easycoexistence.com.

Kaya bang i-stream ng chat interface ang mga tool call?

Oo. Ipasa ang parehong tools sa streamText at isara ang MCP client sa onEnd callback nito, gaya ng dokumentado ng AI SDK para sa mga streamed na sagot.

Kaya bang mag-reply ang parehong app sa mga mensahe sa WhatsApp?

Oo. Dumarating ang tools ng numero sa parehong client: list_numbers para sa connection_id, saka send_message sa loob ng 24 oras mula sa huling mensahe ng customer. Sakop ng gabay ng AI SDK para sa WhatsApp kung paano ito tatanggapin.

Magkano ang easyCoexistence para sa AI SDK app?

Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang nagdadagdag kayo ng koneksyon, pareho sa bawat network. Kasama rito ang MCP server at ang Partner API, at libre ang unang 3 araw.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong