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.
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.
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.
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.
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.
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.
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.
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.
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_dmresponde 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_commentresponde 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_messagefunciona dentro das 24 horas após a última mensagem do cliente, esend_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.
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