Donner à un agent OpenAI Agents SDK les outils Instagram, TikTok et WhatsApp
Un agent OpenAI Agents SDK reçoit les canaux Instagram, TikTok, WhatsApp et d'autres sous forme d'outils via MCPServerStreamableHttp pointé sur https://easycoexistence.com/api/mcp, avec OAuthClientProvider du SDK Python MCP comme gestionnaire d'authentification. Un filtre d'outils réduit les 35+ outils à ceux utiles à la tâche, require_approval retient la publication jusqu'à l'approbation d'une personne, et chaque appel atteint le réseau par son API officielle.
Ce que MCPServerStreamableHttp reçoit dans params["auth"] avec le SDK Python MCP v2 ; avec la v1, il reçoit un httpx.Auth.
La plage du paquet mcp dont dépend le SDK Agents, couvrant les deux versions majeures du SDK Python MCP.
Où une exécution suspendue liste les appels d'outils en attente d'approbation, qu'un RunState approuve ou rejette avant que Runner.run ne reprenne.
À quelle fréquence le token OAuth doit être envoyé dans authorization à l'outil MCP de l'API Responses ; OpenAI ne stocke pas la valeur.
Les appels que TikTok autorise par compte autorisé sur chaque endpoint de l'API Accounts, réponses aux commentaires incluses.
Comment un agent Agents SDK se connecte-t-il à easyCoexistence ?
Via MCPServerStreamableHttp, avec OAuthClientProvider du SDK Python MCP dans params["auth"]. Le SDK Agents transmet ce gestionnaire au client HTTP qu'il construit, de sorte que le fournisseur découvre le serveur d'autorisation d'easyCoexistence, enregistre votre agent comme client public, lance une seule connexion dans le navigateur avec PKCE et renouvelle les tokens d'accès d'une heure grâce au refresh token. L'exemple utilise le SDK Python MCP v2, où le gestionnaire doit être un httpx2.Auth, ce qu'est le fournisseur. Un objet de stockage conserve l'enregistrement et les tokens entre les exécutions ; le fichier ci-dessous tient lieu de coffre à secrets. create_static_tool_filter liste les outils que l'agent peut voir, et require_approval désigne ceux qui attendent une personne.
import json, webbrowser
from pathlib import Path
from urllib.parse import parse_qs, urlparse
from pydantic import AnyUrl
from mcp.client.auth import AuthorizationCodeResult, OAuthClientProvider
from mcp.shared.auth import OAuthClientInformationFull, OAuthClientMetadata, OAuthToken
from agents.mcp import MCPServerStreamableHttp, create_static_tool_filter
URL = "https://easycoexistence.com/api/mcp"
SAVED = Path("easycoexistence-oauth.json") # a secret store in production
class SavedSignIn: # the MCP SDK's TokenStorage: registration and tokens survive restarts
def _read(self) -> dict:
return json.loads(SAVED.read_text()) if SAVED.exists() else {}
def _write(self, key: str, model) -> None:
data = self._read()
data[key] = model.model_dump(mode="json")
SAVED.write_text(json.dumps(data))
async def get_tokens(self):
t = self._read().get("tokens")
return OAuthToken(**t) if t else None
async def set_tokens(self, tokens): self._write("tokens", tokens)
async def get_client_info(self):
c = self._read().get("client")
return OAuthClientInformationFull(**c) if c else None
async def set_client_info(self, info): self._write("client", info)
async def open_sign_in(url: str) -> None:
webbrowser.open(url)
async def code_from_redirect() -> AuthorizationCodeResult:
q = parse_qs(urlparse(input("Address after sign-in: ")).query)
return AuthorizationCodeResult(code=q["code"][0], state=q["state"][0])
oauth = OAuthClientProvider(
server_url=URL,
client_metadata=OAuthClientMetadata(
client_name="Social desk agent", # shown on easyCoexistence's consent screen
redirect_uris=[AnyUrl("http://localhost:3030/callback")],
scope="mcp",
),
storage=SavedSignIn(),
redirect_handler=open_sign_in,
callback_handler=code_from_redirect,
)
PUBLISH = ["publish_instagram_post", "publish_tiktok_post", "publish_facebook_post"]
def easycoexistence() -> MCPServerStreamableHttp:
return MCPServerStreamableHttp(
name="easyCoexistence",
params={"url": URL, "auth": oauth, "timeout": 60},
client_session_timeout_seconds=60, # publishing waits on the network's API
cache_tools_list=True,
tool_filter=create_static_tool_filter(allowed_tool_names=[
"list_social_accounts", "list_social_posts", "list_social_comments",
"reply_to_comment", "list_scheduled_posts", *PUBLISH,
]),
require_approval={"always": {"tool_names": PUBLISH}},
)Comment garder la publication derrière l'approbation d'une personne ?
Avec require_approval sur le serveur, qui suspend l'exécution avant qu'un outil nommé ne s'exécute. L'exécution revient alors avec des interruptions au lieu d'une réponse finale : transformez le résultat en RunState, approuvez ou rejetez chaque appel en attente, puis rappelez Runner.run avec le même agent et l'état. Avec always_approve laissé à False, chaque oui couvre un seul appel, si bien que l'agent ne peut pas réutiliser une approbation pour une deuxième publication. Le serveur reste ouvert pendant la pause, car la boucle s'exécute dans son bloc async with. Pour une relecture qui prend des heures, le SDK peut enregistrer l'état en JSON et le recharger plus tard avec RunState.from_json.
from agents import Agent, Runner
RULES = "You run Acme's social accounts. Schedule posts with scheduled_at; TikTok replies are public."
async def run(task: str) -> str:
async with easycoexistence() as server:
agent = Agent(name="Social desk", instructions=RULES, mcp_servers=[server])
result = await Runner.run(agent, task)
while result.interruptions: # a publish tool is waiting for a decision
state = result.to_state()
for item in result.interruptions:
if await ask_a_person(item): # your review screen, chat message or queue
state.approve(item, always_approve=False)
else:
state.reject(item)
result = await Runner.run(agent, state)
return result.final_outputComment un commentaire TikTok ou un DM Instagram déclenche-t-il une exécution ?
Par votre propre route HTTPS, puisque l'agent n'entend que ce qu'il demande au serveur MCP. set_social_webhook_destination dirige les commentaires, mentions et DMs d'un compte vers la route et renvoie un secret de signature une seule fois ; les comptes TikTok transmettent les commentaires. La route vérifie X-EC-Signature, un HMAC-SHA256 du timestamp, d'un point et du corps brut, répond dans les 8 secondes imposées par easyCoexistence et met l'événement en file d'attente. Un worker appelle ensuite Runner.run avec l'événement comme entrée. Pour les DMs, une session indexée sur le compte et l'expéditeur fait durer la conversation ; un commentaire TikTok n'a besoin que du commentaire et de sa vidéo, il peut donc s'exécuter sans session.
Que doivent dire les instructions de l'agent sur chaque réseau ?
Les règles que l'API de chaque réseau applique au compte, écrites là où le modèle les lit :
- TikTok :
reply_to_commentpublie en public et exige l'ID de la vidéo commepost_id;send_social_dmrefuse les comptes TikTok. - Volume TikTok : jusqu'à 40 appels par minute et par compte sur l'endpoint de réponse, et de nombreuses réponses presque identiques en peu de temps peuvent être masquées comme spam.
- DMs Instagram : réponses uniquement aux personnes ayant écrit dans les dernières 24 heures, dans un texte UTF-8 d'au plus 1,000 octets.
- WhatsApp :
send_messagedans les 24 heures suivant le dernier message du client, etsend_templateavec un template approuvé au-delà. - Calendrier :
scheduled_ataccepte l'ISO 8601 avec un fuseau horaire, de 1 minute à 90 jours à l'avance, etlist_scheduled_postsaffiche la file d'attente.
L'agent peut-il utiliser HostedMCPTool, ou tourner sans connexion ?
Les deux, avec des compromis. HostedMCPTool confie le serveur à l'API Responses, dont l'outil MCP prend un token d'accès OAuth dans authorization et l'exige à chaque requête, puisque OpenAI ne le stocke pas ; un token d'accès easyCoexistence dure une heure, donc votre code en renouvelle un avant chaque exécution. Pour une tâche sans personne pour se connecter, passez par MCP : des outils de fonction qui appellent la Partner API avec une clé ec_live_ peuvent mettre des publications en file via POST /api/v1/channels/:id/posts et récupérer des tokens frais de TikTok, YouTube et LinkedIn via GET /api/v1/channels/:id?credentials=1, tandis que les règles de commentaires et les automatisations répondent sur easyCoexistence sans agent en marche.
Erreurs courantes
- Garder le client_session_timeout_seconds de 5 secondes pour la publication. Une publication attend l'API du réseau ; un appel lent peut donc expirer dans l'agent alors qu'easyCoexistence a déjà transmis la publication. Accordez une minute, et vérifiez list_scheduled_posts avant de réessayer.
- Passer external_id comme account_id. Les outils attendent account_id, l'identifiant d'easyCoexistence du compte ; external_id est l'identifiant propre au compte sur Instagram, TikTok ou Facebook.
- Approuver les interruptions en boucle sans personne dans le circuit. require_approval ne protège la publication que si une personne, ou une règle de confiance, décide de chaque appel en attente.
- Donner à l'agent sa propre activité. Instagram renvoie les DMs du compte comme échos avec is_echo true et ses réponses publiques comme nouveaux commentaires ; filtrez les deux avant Runner.run.
easyCoexistence donne à vos agents OpenAI Agents SDK accès aux clients sur WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn et d'autres canaux, chacun via son API officielle : un serveur MCP qui se connecte par OAuth, des événements signés pour les commentaires et les DMs, et une Partner API pour les tâches qui tournent sans surveillance, chaque connexion étant surveillée 24/7. De US$ 9 à US$ 0.75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
L'agent a-t-il besoin d'une clé API d'easyCoexistence ?
Pas pour MCP. La connexion OAuth délivre à l'agent ses propres tokens ; une clé ec_live_ tirée du dashboard ne sert qu'au code qui appelle la Partner API au lieu du serveur MCP.
Le même agent peut-il répondre aux messages WhatsApp ?
Oui, avec les outils du numéro : list_numbers pour le connection_id, send_message dans les 24 heures suivant le dernier message du client et send_template au-delà. Le guide du SDK Agents OpenAI pour WhatsApp explique la réception des messages.
Quel modèle utilise l'agent ?
Celui que vous donnez à l'Agent. Les outils MCP fonctionnent de la même façon quel que soit le modèle exécuté par le SDK, la consommation du modèle est facturée par son fournisseur, et easyCoexistence facture par connexion.
Combien coûte easyCoexistence pour un agent OpenAI Agents SDK ?
De US$ 9 à US$ 0.75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, le même tarif sur chaque réseau. Le serveur MCP, les événements transmis et la Partner API sont inclus, et les 3 premiers jours sont en essai gratuit.
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