Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Dote um agente LangChain com ferramentas para Instagram, TikTok e WhatsApp

Um agente LangChain passa a ter o Instagram, o TikTok, o WhatsApp e mais canais como ferramentas do servidor MCP do easyCoexistence, em https://easycoexistence.com/api/mcp, carregadas pelo MCPAdapter, o cliente MCP do LangChain, com o FastMCP a tratar do início de sessão OAuth. Depois, o create_agent pode publicar e agendar publicações, responder a comentários e DMs e ler estatísticas através da API oficial de cada rede, enquanto os eventos assinados levam novos comentários e DMs até à sua rota.

Beta

A etiqueta do LangChain para o seu espaço de nomes langchain.mcp, que requer langchain[mcp] 1.4.0 ou posterior e traz o FastMCP.

In memory

Onde o FastMCP guarda os tokens OAuth, a não ser que token_storage indique um backend, pelo que um reinício obriga a iniciar sessão de novo.

127.0.0.1

O endereço de loopback do servidor de retorno temporário que o FastMCP inicia para o início de sessão no navegador, numa porta livre ou em callback_port.

60 days

Durante quanto tempo dura um token de atualização MCP do easyCoexistence; os tokens de acesso duram uma hora, e cada atualização emite um novo par.

8 seconds

Quanto tempo o easyCoexistence espera que a sua rota responda a um comentário ou DM reencaminhado, enviado uma só vez e nunca repetido.

Que ferramentas um agente LangChain recebe do easyCoexistence?

Mais de 50, como ferramentas LangChain comuns que o create_agent pode chamar. As ferramentas sociais recebem um account_id, pelo que o agente começa com list_social_accounts e transmite os IDs a publish, read e às ferramentas para responder a comentários, ocultá-los e ler estatísticas. As ferramentas de uma rede levam o nome dela, como publish_tiktok_post ou upload_youtube_video, e um número de WhatsApp começa em list_numbers, que devolve o connection_id que send_message e send_template recebem. Cada descrição de ferramenta traz as regras da própria rede, pelo que o modelo fica a saber, por exemplo, que uma resposta no TikTok é pública. Publicar mais tarde requer um argumento adicional: scheduled_at coloca a publicação na fila do easyCoexistence.

Instagrampublish_instagram_post, reply_to_comment, send_social_dm, get_social_insights
TikTokpublish_tiktok_post, get_tiktok_publish_status, reply_to_comment with post_id
WhatsApplist_numbers, send_message, send_template, get_number_health
Facebookpublish_facebook_post, reply_to_comment, send_social_dm for Messenger
YouTube and LinkedInupload_youtube_video, reply_to_youtube_comment, publish_linkedin_post, get_linkedin_stats
The queuelist_scheduled_posts, update_scheduled_post, cancel_scheduled_post, retry_scheduled_post

Como é que o agente inicia sessão no easyCoexistence?

Com o auxiliar OAuth do FastMCP, que o MCPAdapter usa para autenticação. Na primeira execução, descobre o servidor de autorização do easyCoexistence, regista-se como cliente, abre o navegador no ecrã de consentimento, onde é mostrado o seu client_name, e recebe o código num callback local em 127.0.0.1. Depois disso, os tokens de acesso renovam-se sem navegador. Os tokens ficam em memória, a não ser que o auxiliar receba um backend token_storage, pelo que o exemplo os guarda em disco, cifrados com uma chave Fernet. Filtre a lista antes de a entregar ao create_agent: as ferramentas guardam o cliente MCP, pelo que o agente continua a funcionar depois de o bloco async with terminar.

A reply agent's tools, with a sign-in that survives restarts
import os

from cryptography.fernet import Fernet
from fastmcp import Client
from fastmcp.client.auth import OAuth
from key_value.aio.stores.disk import DiskStore
from key_value.aio.wrappers.encryption import FernetEncryptionWrapper
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

URL = "https://easycoexistence.com/api/mcp"

# Kept on disk and encrypted, so the browser sign-in happens once
oauth = OAuth(
    client_name="Acme reply agent",  # shown on easyCoexistence's consent screen
    callback_port=8765,
    token_storage=FernetEncryptionWrapper(
        key_value=DiskStore(directory="~/.easycoexistence/oauth"),
        fernet=Fernet(os.environ["TOKEN_KEY"]),
    ),
)

REPLY_TOOLS = {"list_social_accounts", "list_social_comments", "reply_to_comment",
               "hide_comment", "send_social_dm"}

RULES = (
    "You reply to comments and DMs for Acme, on the account_id in the event. "
    "TikTok replies are public and need the video ID as post_id. "
    "Never reply to the account's own messages or replies."
)

async def build_reply_agent(model: str):
    async with MCPAdapter(Client(URL, auth=oauth)) as adapter:
        tools = [t for t in await adapter.list_tools() if t.name in REPLY_TOOLS]
    return create_agent(model, tools, system_prompt=RULES)

Como chegam os comentários e DMs a um agente LangChain?

Como pedidos POST assinados para uma rota sua, porque o MCP só responde às chamadas que o agente faz. Associe cada conta à rota com set_social_webhook_destination, pedindo-o ao agente uma vez ou executando-o a partir do Claude ou do ChatGPT, e guarde o signing_secret que devolve. O Instagram e o Facebook reencaminham comentários, menções e DMs, e o TikTok reencaminha comentários; cada evento traz platform, account_id, external_id e a entrada própria da rede. A rota verifica X-EC-Signature, responde de imediato, já que o easyCoexistence espera 8 segundos e não repete, e entrega o evento ao agente em segundo plano. Um checkpointer com um thread_id por remetente de DM mantém o histórico de cada conversa.

A FastAPI route that verifies the event, then runs the agent
import hashlib, hmac, json, time

from fastapi import BackgroundTasks, FastAPI, HTTPException, Request

app = FastAPI()  # at startup: app.state.agent = await build_reply_agent("<MODEL>")
SECRETS: dict[str, str] = {}  # account_id -> signing_secret, kept in your database

def signed(raw: bytes, header: str, secret: str) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t, v1 = parts.get("t", ""), parts.get("v1", "")
    if not t.isdigit() or abs(time.time() - int(t)) > 300:
        return False
    mac = hmac.new(secret.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac.encode(), v1.encode())

@app.post("/hooks/social")
async def social_event(request: Request, background: BackgroundTasks):
    raw = await request.body()
    event = json.loads(raw)  # platform, account_id, external_id, entry
    secret = SECRETS.get(event.get("account_id", ""))
    if not secret or not signed(raw, request.headers.get("x-ec-signature", ""), secret):
        raise HTTPException(status_code=401)
    background.add_task(reply, event)  # runs after the response is sent
    return {"received": True}

async def reply(event: dict) -> None:
    prompt = json.dumps(event)  # the agent reads the platform, the account and the entry
    await app.state.agent.ainvoke({"messages": [{"role": "user", "content": prompt}]})

O que permite cada rede ao agente?

O que a API da rede permite à conta, que as instruções do agente devem indicar claramente:

  • DMs do Instagram e do Messenger: send_social_dm responde a pessoas que escreveram nas últimas 24 horas, e o Instagram limita cada DM a 1,000 bytes em UTF-8.
  • Respostas a comentários: reply_to_comment responde em público, ou, com private definido como true, envia um DM por cada comentário do Instagram ou do Facebook, no prazo de 7 dias após o comentário.
  • TikTok: as respostas são sempre públicas e exigem o ID do vídeo como post_id, e não há DMs no TikTok.
  • WhatsApp: send_message funciona dentro das 24 horas após a última mensagem do cliente, e send_template, com um template aprovado, fora desse prazo.
  • Multimédia: cada ficheiro fica num link HTTPS público; o Instagram aceita imagens JPEG, e as publicações de fotos no TikTok aceitam JPEG ou WebP.

Quando é que o código deve chamar as redes sem o agente?

Quando um passo tem de acontecer sempre da mesma forma, ou quando não há ninguém presente para iniciar sessão. get_social_credentials entrega ao agente a base da API de uma conta, o seu ID na rede e, no TikTok, no YouTube e no LinkedIn, um token válido neste momento, e a Partner API devolve o mesmo através de GET /api/v1/channels/:id?credentials=1 com uma chave ec_live_, pelo que uma tarefa em Python pode chamar diretamente o TikTok, a Google ou o LinkedIn. Respostas que têm de sair a qualquer hora sem o agente, como um texto fixo para uma palavra-chave, encaixam nas regras de comentários e nas automatizações, que o próprio easyCoexistence executa.

Erros comuns

  • Responder a eventos que a própria conta causou. O Instagram repete as DMs da conta com is_echo definido como true e devolve as respostas públicas dela como comentários, por isso filtre-as antes de o agente as ver, ou acaba por responder a si próprio.
  • Executar o agente antes de a rota responder. O easyCoexistence espera 8 segundos por um 2xx e nunca repete, por isso um handler que aguarda o modelo perde o evento; responda primeiro e trabalhe em segundo plano.
  • Chamar reply_to_comment para um comentário do TikTok sem post_id. A resposta do TikTok indica o vídeo além do comentário, por isso passe o video_id do evento como post_id.
  • Dar a um agente de respostas as ferramentas de publicação. Filtre a lista pelo nome antes de a entregar ao create_agent, para que um comentário mal interpretado não possa publicar, apagar uma publicação nem alterar uma automação.
Fazer isto com a EasyCoexistence

O easyCoexistence dá aos seus agentes LangChain acesso aos clientes no WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e mais canais, cada um através da API oficial: um servidor MCP atrás de um início de sessão OAuth, eventos assinados de comentários e DMs e uma fila que publica com antecedência de até 90 dias, com cada ligação monitorizada 24/7. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

O agente precisa da sua própria app de programador da Meta, do TikTok ou da Google?

Não. As contas ligam-se através da app própria do easyCoexistence em cada rede, no painel ou através de um link de ligação da Partner API, e o agente acede a todas com um único início de sessão do easyCoexistence.

O agente pode agendar publicações em vez de as publicar de imediato?

Sim. publish_instagram_post, publish_facebook_post, publish_tiktok_post e publish_linkedin_post recebem scheduled_at, uma hora ISO 8601 com fuso horário, de 1 minuto a 90 dias à frente. O YouTube agenda nativamente com upload_youtube_video e publish_at.

Que modelos podem executar o agente?

Qualquer modelo de conversa que o create_agent possa usar com ferramentas. As ferramentas MCP não dependem do modelo, e o fornecedor do modelo cobra o seu próprio consumo; o easyCoexistence cobra por ligação, nunca por chamada de ferramenta.

Quanto custa o easyCoexistence para um agente LangChain?

De US$ 9 a US$ 0.75 por ligação por mês, com preço decrescente à medida que adiciona ligações, o mesmo em cada rede. O servidor MCP, os eventos reencaminhados e a Partner API estão incluídos, 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