Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Vercel AI SDK: Instagram, TikTok e mais ferramentas de redes sociais

O Vercel AI SDK recebe ferramentas de redes sociais para Instagram, TikTok, Facebook, WhatsApp e mais canais, a partir do servidor MCP da easyCoexistence. O createMCPClient, do pacote @ai-sdk/mcp, abre uma ligação HTTP a https://easycoexistence.com/api/mcp; um OAuthClientProvider que implementa assegura o início de sessão, e o tools() do cliente entra em generateText ou streamText para publicar, agendar, responder a comentários e mensagens diretas e ler métricas através da API oficial de cada rede.

auth()

A função do @ai-sdk/mcp que conclui um callback OAuth a partir de serverUrl e authorizationCode, além de callbackState e callbackIssuer quando existem.

isStepCount(1)

O stopWhen predefinido do generateText, pelo que o modelo só lê o resultado de uma ferramenta quando o stopWhen permite mais passos.

HTTP

O transporte MCP que o AI SDK recomenda para produção; o seu transporte stdio destina-se apenas a servidores locais.

1 hour

A duração de um token de acesso MCP da easyCoexistence; o seu token de atualização dura 60 dias e é substituído em cada atualização.

1,000 bytes

O texto máximo de uma mensagem direta do Instagram, medido em UTF-8, pelo que os acentos e os emojis ocupam mais espaço.

Como é que o AI SDK inicia sessão na easyCoexistence?

Através de um OAuthClientProvider que implementa sobre o seu próprio armazenamento, que a função auth() do AI SDK conduz. A primeira chamada regista a sua aplicação na easyCoexistence como cliente público, guarda o verificador PKCE e entrega-lhe o URL de consentimento através de redirectToAuthorization; devolve REDIRECT, e a sua rota envia o utilizador para lá. A easyCoexistence redireciona depois para o seu callback com um código, e uma segunda chamada a auth() com authorizationCode troca-o por tokens. Quando os tokens estão guardados, auth() utiliza o token de atualização para obter um novo par em vez de enviar o utilizador de volta. Mantenha redirectUrl e os redirect_uris registados idênticos, já que a easyCoexistence os compara exatamente.

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

Como chegam as ferramentas ao generateText?

Do createMCPClient com o transporte HTTP, o URL da easyCoexistence e o provider. O tools() devolve as ferramentas do servidor como ferramentas do AI SDK; mantenha pelo nome as que o trabalho exige e passe-as a generateText ou streamText. Defina stopWhen com isStepCount, porque por predefinição a chamada para após um passo e o modelo nunca lê o que o reply_to_comment devolveu. Coloque as regras da rede em instructions, o parâmetro que a referência atual usa para o comportamento do modelo. Feche o cliente num bloco finally, ou no callback onEnd do streamText, para que não fique nenhuma ligação aberta.

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

Onde devem ficar os tokens num alojamento serverless?

Em qualquer sítio que sobreviva a uma invocação: uma linha numa base de dados, Redis ou um armazenamento chave-valor, indexado pelo utilizador da sua aplicação a quem os tokens pertencem. Uma função na Vercel ou noutra plataforma serverless começa sem nada em memória, por isso um provider que guarda os tokens numa variável envia o utilizador de volta ao ecrã de consentimento depois de um arranque a frio. Os tokens de acesso duram uma hora e os de atualização 60 dias, com um novo token de atualização a cada utilização, pelo que uma aplicação que chama as ferramentas pelo menos uma vez em 60 dias mantém o início de sessão. Guarde o registo do cliente junto dos tokens, já que o provider lê ambos em cada ligação.

Como chegam os comentários e as mensagens diretas à aplicação?

Como pedidos POST assinados para um route handler, que o set_social_webhook_destination regista para uma conta e que depois recebe comentários, menções e mensagens diretas do Instagram e do Facebook, e comentários do TikTok. Cada corpo contém platform, account_id, external_id e entry, o evento da rede tal como foi enviado. Leia o corpo como texto, verifique o X-EC-Signature contra ele com o segredo de assinatura da conta, e responda depressa: a easyCoexistence dá à rota 8 segundos e envia cada evento uma só vez, sem nova tentativa. Coloque o evento numa fila e deixe um worker chamar replyToEvent com ele, para que o tempo do modelo nunca conte nos 8 segundos.

O que permite cada rede ao modelo?

Tanto quanto a API da conta permite, o que as instruções devem detalhar:

  • Instagram: publicações, Reels e Stories com imagens JPEG; respostas em mensagens diretas apenas a pessoas que escreveram nas últimas 24 horas, com no máximo 1,000 bytes.
  • Facebook: publicações na Página, respostas a comentários e respostas no Messenger dentro das mesmas 24 horas.
  • TikTok: vídeos e publicações com fotografias; respostas a comentários sempre públicas, com o ID do vídeo como post_id, e sem mensagens diretas.
  • WhatsApp: send_message dentro de 24 horas da última mensagem do cliente, send_template para qualquer outra pessoa.
  • YouTube e LinkedIn: carregamentos e publicações quando um utilizador o pede, respostas a comentários e métricas; nenhum dos dois reencaminha eventos, por isso a aplicação lê os novos comentários de acordo com uma agenda.

Erros comuns

  • Deixar o stopWhen no valor predefinido. O generateText para após o primeiro passo, por isso o modelo chama reply_to_comment e nunca fica a saber se a resposta foi enviada; permita alguns passos com isStepCount.
  • Guardar os tokens numa variável ao nível do módulo num alojamento serverless. O arranque a frio seguinte já não a tem, e o utilizador volta ao ecrã de consentimento; guarde-os onde tokens() e saveTokens() chegam a uma base de dados.
  • Registar um URL de redirecionamento e enviar outro. A easyCoexistence compara o redirect_uri com o registo exatamente, por isso uma barra final ou outro caminho termina o início de sessão numa página de erro.
  • Responder à atividade da própria conta. O Instagram devolve as mensagens enviadas pela conta como ecos e as respostas públicas voltam como comentários, por isso ignore ambos antes de chegarem ao modelo.
Fazer isto com a EasyCoexistence

A easyCoexistence dá aos agentes que cria com o Vercel AI SDK alcance a clientes no WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e mais canais, cada um através da API oficial: ferramentas MCP por trás de um início de sessão OAuth, eventos assinados para comentários e mensagens diretas, e uma fila de publicações até 90 dias à frente, com cada ligação monitorizada 24 horas por dia. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Isto precisa de Next.js ou de alojamento na Vercel?

Não. O AI SDK corre em Node.js, por isso qualquer alojamento que sirva uma rota HTTPS funciona, e o cliente MCP só precisa de HTTPS de saída para easycoexistence.com.

Uma interface de chat pode transmitir as chamadas às ferramentas?

Sim. Passe as mesmas ferramentas ao streamText e feche o cliente MCP no seu callback onEnd, como o AI SDK documenta para respostas em fluxo.

A mesma aplicação pode responder a mensagens do WhatsApp?

Sim. As ferramentas do número chegam pelo mesmo cliente: list_numbers para o connection_id e, depois, send_message dentro de 24 horas da última mensagem do cliente. O guia do AI SDK para WhatsApp explica como as receber.

Quanto custa a easyCoexistence para uma aplicação com o AI SDK?

De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, igual em cada rede. A MCP server e a Partner API estão incluídas, e os primeiros 3 dias são gratuitos.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em