EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Dê a um agente LangChain ferramentas para Instagram, TikTok e WhatsApp

Um agente LangChain recebe Instagram, TikTok, WhatsApp e mais canais como ferramentas do servidor MCP do easyCoexistence em https://easycoexistence.com/api/mcp, carregado pelo MCPAdapter, o cliente MCP do LangChain, com o FastMCP executando o login OAuth. A partir daí, create_agent pode publicar e agendar posts, responder comentários e DMs e ler métricas pela API oficial de cada rede, enquanto eventos assinados trazem novos comentários e mensagens para a sua rota.

Beta

Rótulo do LangChain para o namespace langchain.mcp, que exige langchain[mcp] 1.4.0 ou mais recente e traz o FastMCP.

In memory

Onde o FastMCP guarda os tokens OAuth, a menos que token_storage indique um backend; por isso, um reinício exige entrar de novo.

127.0.0.1

Endereço de loopback do servidor de callback temporário que o FastMCP inicia para o login no navegador, em uma porta livre ou em callback_port.

60 days

Duração do refresh token do MCP do easyCoexistence; os access tokens duram uma hora, e cada renovação emite um novo par.

8 seconds

Tempo que o easyCoexistence espera pela resposta da sua rota a um comentário ou DM encaminhado; o envio é feito uma vez e nunca repetido.

Quais ferramentas um agente LangChain recebe do easyCoexistence?

Mais de 50, como ferramentas comuns do LangChain que o create_agent pode chamar. As ferramentas de redes sociais recebem um account_id, então o agente começa com list_social_accounts e passa os IDs para publicar, ler e responder comentários, ocultá-los e ler insights. Ferramentas de uma única rede levam o nome dela, como publish_tiktok_post ou upload_youtube_video, e um número de WhatsApp parte de list_numbers, que devolve o connection_id usado por send_message e send_template. A descrição de cada ferramenta traz as regras da própria rede, então o modelo aprende, por exemplo, que uma resposta no TikTok é pública. Publicar depois exige mais um argumento: scheduled_at coloca o post 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 o agente faz login no easyCoexistence?

Com o auxiliar OAuth do FastMCP, que o MCPAdapter usa para autenticação. Na primeira execução ele descobre o servidor de autorização do easyCoexistence, se registra como cliente, abre o navegador na tela de consentimento, onde aparece o seu client_name, e recebe o código em um callback local em 127.0.0.1. Depois disso, os access tokens são renovados sem navegador. Os tokens ficam na memória, a menos que o auxiliar receba um backend token_storage; por isso o exemplo os guarda em disco, criptografados com uma chave Fernet. Filtre a lista antes que o create_agent a receba: as ferramentas mantêm o cliente MCP, então o agente continua funcionando depois que o bloco async with é fechado.

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 os comentários e DMs chegam a um agente LangChain?

Como requisições POST assinadas para uma rota sua, pois o MCP só responde às chamadas feitas pelo agente. Aponte cada conta para a rota com set_social_webhook_destination, feito pelo agente uma vez ou executado pelo Claude ou pelo ChatGPT, e guarde o signing_secret que ele devolve. O Instagram e o Facebook encaminham comentários, menções e DMs, e o TikTok encaminha comentários; cada evento traz platform, account_id, external_id e a entrada própria da rede. A rota verifica o X-EC-Signature, responde de imediato, já que o easyCoexistence espera 8 segundos e não repete o envio, e entrega o evento ao agente em segundo plano. Um checkpointer com um thread_id por remetente de DM mantém o histórico da 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 cada rede permite que o agente faça?

O que a API da rede permite à conta, o que as instruções do agente devem dizer com clareza:

  • DMs do Instagram e do Messenger: send_social_dm responde a pessoas que escreveram nas últimas 24 horas, e o Instagram limita uma DM a 1.000 bytes em UTF-8.
  • Respostas a comentários: reply_to_comment responde publicamente, ou com private definido como true envia uma DM por comentário do Instagram ou do Facebook, em até 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 da janela de atendimento de 24 horas, a contar da última mensagem do cliente, e send_template com um template aprovado fora dela.
  • Mídia: cada arquivo fica em um link HTTPS público; o Instagram aceita imagens JPEG, e posts de foto no TikTok aceitam JPEG ou WebP.

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

Quando uma etapa precisa ser executada de forma determinística, ou quando não há ninguém presente para fazer login. get_social_credentials entrega ao agente a base da API de uma conta, o seu ID na rede e, no TikTok, YouTube e LinkedIn, um token válido no momento, e a Partner API devolve o mesmo com GET /api/v1/channels/:id?credentials=1 e uma chave ec_live_, de modo que um job em Python pode chamar diretamente o TikTok, o Google ou o LinkedIn. Respostas que precisam sair a qualquer hora sem o agente, como um texto fixo para uma palavra-chave, se encaixam nas regras de comentários e automações, que o próprio easyCoexistence executa.

Erros comuns

  • Responder a eventos que a própria conta gerou. O Instagram devolve as DMs da conta com is_echo definido como true e retorna as respostas públicas como comentários, então descarte-os antes que o agente os veja, ou ele acabará respondendo a si mesmo.
  • Executar o agente antes da resposta da rota. O easyCoexistence espera 8 segundos por um 2xx e nunca repete o envio, então 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 no TikTok identifica o vídeo além do comentário, então passe o video_id do evento como post_id.
  • Dar a um agente de respostas as ferramentas de publicação. Filtre a lista por nome antes do create_agent, para que um comentário mal interpretado não consiga publicar, apagar um post ou alterar uma automação.
Fazendo isso com o EasyCoexistence

O easyCoexistence dá aos seus agentes LangChain alcance para clientes no WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e mais canais, cada um pela sua API oficial: um servidor MCP atrás de um login OAuth, eventos assinados de comentários e DMs e uma fila que publica até 90 dias à frente, com cada conexão monitorada 24/7. De US$ 9 a US$ 0.75 por conexão por mês, com o valor caindo conforme você adiciona conexões, e os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

O agente precisa de um app próprio de desenvolvedor da Meta, do TikTok ou do Google?

Não. As contas se conectam pelo app do próprio easyCoexistence em cada rede, no painel ou por um link de conexão da Partner API, e o agente acessa todas por um único login do easyCoexistence.

O agente pode agendar posts em vez de publicar na hora?

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

Quais modelos podem executar o agente?

Qualquer modelo de chat que o create_agent consiga usar com ferramentas. As ferramentas MCP não dependem do modelo, e o provedor do modelo cobra o próprio uso; o easyCoexistence cobra por conexão, nunca por chamada de ferramenta.

Quanto custa o easyCoexistence para um agente LangChain?

De US$ 9 a US$ 0.75 por conexão por mês, com o valor caindo conforme você adiciona conexões, e o mesmo valor em cada rede. O servidor MCP, os eventos encaminhados e a Partner API estão incluídos, e os primeiros 3 dias são grátis.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

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

Verificado em