Donnez à un agent LangChain des outils Instagram, TikTok et WhatsApp
Un agent LangChain reçoit Instagram, TikTok, WhatsApp et d'autres canaux sous forme d'outils, fournis par le serveur MCP d'easyCoexistence à https://easycoexistence.com/api/mcp, chargés par MCPAdapter, le client MCP de LangChain, FastMCP gérant la connexion OAuth. create_agent peut alors publier et programmer des posts, répondre aux commentaires et aux DM et lire les statistiques via l'API officielle de chaque réseau, tandis que les événements signés amènent vers votre route les nouveaux commentaires et messages.
Le nom que LangChain donne à son espace langchain.mcp, qui exige langchain[mcp] 1.4.0 ou plus récent et inclut FastMCP.
Où FastMCP conserve les tokens OAuth tant qu'aucun backend n'est indiqué dans token_storage, si bien qu'un redémarrage impose de se reconnecter.
L'adresse de bouclage du serveur de rappel temporaire que FastMCP démarre pour la connexion par navigateur, sur un port libre ou sur callback_port.
La durée de vie d'un refresh token MCP d'easyCoexistence : les access tokens durent une heure, et chaque rafraîchissement en émet une nouvelle paire.
Le délai pendant lequel easyCoexistence attend la réponse de votre route à un commentaire ou un DM transmis ; l'envoi n'est fait qu'une fois et jamais relancé.
Quels outils un agent LangChain reçoit-il d'easyCoexistence ?
Plus de 50, sous forme d'outils LangChain ordinaires que create_agent peut appeler. Les outils sociaux prennent un account_id : l'agent commence donc par list_social_accounts et transmet ces identifiants aux outils de publication, de lecture, de réponse aux commentaires, de masquage et de statistiques. Les outils propres à un réseau portent son nom, comme publish_tiktok_post ou upload_youtube_video, et un numéro WhatsApp part de list_numbers, qui renvoie le connection_id attendu par send_message et send_template. La description de chaque outil reprend les règles propres au réseau, si bien que le modèle apprend par exemple qu'une réponse TikTok est publique. Programmer une publication demande un argument de plus : scheduled_at place le post dans la file d'attente d'easyCoexistence.
Comment l'agent se connecte-t-il à easyCoexistence ?
Avec l'assistant OAuth de FastMCP, que MCPAdapter utilise pour l'authentification. Au premier lancement, il découvre le serveur d'autorisation d'easyCoexistence, s'enregistre comme client, ouvre le navigateur sur l'écran de consentement, où son client_name est affiché, et reçoit le code sur un rappel local à 127.0.0.1. Ensuite, les access tokens se rafraîchissent sans navigateur. Les tokens restent en mémoire, sauf si l'assistant reçoit un backend token_storage ; l'exemple les garde donc sur le disque, chiffrés avec une clé Fernet. Filtrez la liste avant que create_agent la reçoive : les outils détiennent le client MCP, si bien que l'agent continue de fonctionner après la fermeture du bloc async with.
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)Comment les commentaires et les DM parviennent-ils à un agent LangChain ?
Sous forme de requêtes POST signées envoyées à une route de votre application, car MCP ne répond qu'aux appels que fait l'agent. Reliez chaque compte à cette route avec set_social_webhook_destination, demandé une fois à l'agent ou lancé depuis Claude ou ChatGPT, et conservez le signing_secret renvoyé. Instagram et Facebook transmettent les commentaires, mentions et DM, et TikTok transmet les commentaires ; chaque événement contient platform, account_id, external_id et l'entrée propre au réseau. La route vérifie X-EC-Signature, répond immédiatement, car easyCoexistence attend 8 secondes et ne relance pas l'envoi, puis confie l'événement à l'agent en arrière-plan. Un checkpointer avec un thread_id par expéditeur de DM conserve l'historique de chaque conversation.
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}]})Que permet chaque réseau à l'agent ?
Ce que l'API du réseau autorise pour le compte. Les instructions de l'agent doivent le dire clairement :
- DM Instagram et Messenger :
send_social_dmrépond aux personnes ayant écrit dans les 24 dernières heures, et Instagram limite un DM à 1 000 octets en UTF-8. - Réponses aux commentaires :
reply_to_commentrépond publiquement ou, avec private à true, envoie un seul DM par commentaire Instagram ou Facebook dans les 7 jours qui suivent. - TikTok : les réponses sont toujours publiques et exigent l'ID de la vidéo en
post_id; il n'y a pas de DM sur TikTok. - WhatsApp :
send_messagefonctionne dans les 24 heures suivant le dernier message du client, etsend_templateavec un template approuvé au-delà. - Médias : chaque fichier se trouve à un lien HTTPS public ; Instagram accepte les images JPEG, et les publications photo TikTok les JPEG ou WebP.
Quand le code doit-il appeler les réseaux sans passer par l'agent ?
Lorsqu'une étape doit se dérouler toujours de la même façon, ou sans personne pour se connecter. get_social_credentials remet à l'agent l'URL de base de l'API d'un compte, son ID sur le réseau et, pour TikTok, YouTube et LinkedIn, un token valide au moment de l'appel ; l'API Partner renvoie la même chose par GET /api/v1/channels/:id?credentials=1 avec une clé ec_live_, si bien qu'une tâche Python peut appeler directement TikTok, Google ou LinkedIn. Les réponses qui doivent partir à toute heure sans l'agent, comme un texte fixe pour un mot-clé, relèvent des règles de commentaires et des automatisations, que easyCoexistence exécute lui-même.
Erreurs courantes
- Répondre aux événements provoqués par le compte lui-même. Instagram renvoie les DM du compte avec is_echo à true et renvoie ses réponses publiques comme commentaires ; écartez-les avant que l'agent les voie, sinon il finit par se répondre à lui-même.
- Lancer l'agent avant que la route réponde. easyCoexistence attend 8 secondes une réponse 2xx et ne relance jamais l'envoi ; un gestionnaire qui attend le modèle perd donc l'événement. Répondez d'abord, puis travaillez en arrière-plan.
- Appeler reply_to_comment pour un commentaire TikTok sans post_id. La réponse TikTok désigne aussi la vidéo, il faut donc passer le video_id de l'événement comme post_id.
- Donner les outils de publication à un agent de réponse. Filtrez la liste par nom avant create_agent, pour qu'un commentaire mal interprété ne puisse ni publier, ni supprimer un post, ni modifier une automatisation.
easyCoexistence donne à vos agents LangChain l'accès aux clients sur WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn et d'autres canaux, chacun via son API officielle : un serveur MCP derrière une connexion OAuth, des événements de commentaires et de DM signés, et une file d'attente qui programme les publications jusqu'à 90 jours à l'avance, avec chaque connexion surveillée 24 h/24 et 7 j/7. De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
L'agent a-t-il besoin de sa propre application développeur Meta, TikTok ou Google ?
Non. Les comptes se connectent via l'application propre d'easyCoexistence sur chaque réseau, depuis le dashboard ou via un lien de connexion de l'API Partner, et l'agent les atteint tous avec une seule connexion easyCoexistence.
L'agent peut-il programmer des publications au lieu de publier tout de suite ?
Oui. publish_instagram_post, publish_facebook_post, publish_tiktok_post et publish_linkedin_post acceptent scheduled_at, une heure au format ISO 8601 avec fuseau horaire, de 1 minute à 90 jours à l'avance. YouTube programme nativement avec upload_youtube_video et publish_at.
Quels modèles peuvent faire tourner l'agent ?
Tout modèle de chat que create_agent peut utiliser avec des outils. Les outils MCP ne dépendent pas du modèle, et le fournisseur du modèle facture sa propre consommation ; easyCoexistence facture par connexion, jamais par appel d'outil.
Combien coûte easyCoexistence pour un agent LangChain ?
De US$ 9 à US$ 0,75 par connexion et par mois, en baisse à mesure que vous ajoutez des connexions, et le même tarif sur chaque réseau. Le serveur MCP, les événements transmis et l'API Partner sont inclus, et les 3 premiers jours sont gratuits.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le