Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Comment créer un produit d'agent IA sur WhatsApp, Instagram et TikTok de vos clients

Un produit d'agent IA sur les canaux de vos clients repose sur trois éléments : un lien de connexion hébergé pour le numéro WhatsApp ou le compte social de chaque client, des webhooks qui font remonter leurs messages et commentaires jusqu'à votre backend, où votre propre modèle rédige les réponses envoyées via l'API officielle de chaque réseau avec le token du client, et des événements de statut pour les connexions qui se coupent. L'agent respecte les règles de chaque réseau, comme la fenêtre de 24 heures de WhatsApp.

easyCoexistence donne aux agents IA de votre produit une voix sur les numéros WhatsApp de vos clients et sur leurs comptes Instagram, Facebook, TikTok, YouTube et LinkedIn, ainsi que sur d'autres canaux à venir : liens de connexion hébergés, identifiants renouvelés, webhooks et événements de statut signés, le tout via l'API officielle de chaque réseau, avec chaque connexion surveillée 24/7.

24 hours

Fenêtre de service client de WhatsApp après un message ou un appel de l'utilisateur ; chaque nouveau message la réinitialise.

Templates only

Ce qu'une entreprise WhatsApp peut envoyer une fois la fenêtre de service client fermée : des templates de message préapprouvés.

Section 4.7

Les conditions de Meta interdisent aux fournisseurs d'IA d'utiliser WhatsApp pour proposer l'IA comme fonctionnalité principale, et non accessoire.

7 days

Fenêtre pour la réponse privée unique à un commentaire sur un compte Instagram, comptée à partir de la publication du commentaire.

20 mps

Débit fixe d'un numéro utilisé à la fois avec l'application WhatsApp Business et la Cloud API.

De quoi un produit d'agent IA a-t-il besoin sur le canal de chaque client ?

Quatre choses : un moyen pour le client de le connecter, la réception de ses messages par votre backend, un token pour répondre et une alerte lorsque la connexion cesse de fonctionner. L'API Partner couvre chacun de ces points, tandis que le modèle, les prompts et la logique de conversation restent chez vous. easyCoexistence connecte le compte, maintient son accès renouvelé et le surveille, et vos réponses partent de votre backend directement vers l'API du réseau.

1ConnectA hosted link per customer: POST /connect-sessions
2ReceiveMessages from Meta; comments and DMs forwarded, signed
3DecideYour model, your prompts, your memory
4ReplyThe network's API, with the customer's token
5Watchconnection.* and channel.* status events

Comment chaque client se connecte-t-il ?

Votre backend crée une session de connexion avec POST /connect-sessions, en indiquant le canal, un redirect_url et un external_ref pour votre client, et, pour un numéro, son webhook_url et son webhook_verify_token. Le client ouvre le lien hébergé, se connecte avec Meta, TikTok, Google ou LinkedIn, puis revient dans votre application avec connection_id ou channel_id. Il n'a besoin d'aucun compte easyCoexistence, d'aucune adresse e-mail ni d'aucune carte, et chaque connexion établie avec votre clé appartient à votre compte.

Comment les messages et les commentaires parviennent-ils à votre modèle ?

Par webhook, sur les réseaux qui les envoient. Meta livre les messages d'un numéro directement à son webhook_url, et ce que le personnel de l'entreprise envoie depuis l'application WhatsApp Business arrive à cet endroit sous forme de smb_message_echoes. Les commentaires, mentions et messages privés (DM) d'Instagram et de Facebook, ainsi que les commentaires TikTok, sont transmis à la destination de chaque canal, signés avec son secret. YouTube et LinkedIn n'envoient aucun événement de commentaire : l'agent lit donc les nouveaux commentaires via leurs API selon un planning. Répondez à chaque livraison par un code 2xx immédiatement, puis laissez un worker appeler le modèle.

Comment l'agent répond-il ?

Par l'API propre à chaque réseau, avec les identifiants que votre backend a récupérés. Une réponse WhatsApp est un POST vers le send_endpoint du numéro avec le token du client ; un DM Instagram ou Facebook part vers l'edge messages du compte ; une réponse TikTok est publiée sous le commentaire via business/comment/reply/create/. L'exemple ci-dessous répond aux messages WhatsApp : il vérifie le secret dans le chemin de l'URL, met chaque message entrant en file d'attente et répond avec ce que renvoie votre modèle.

Python: a WhatsApp agent on your own model
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request

EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"}  # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"]  # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {}  # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)

@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
    if not hmac.compare_digest(secret, PATH_SECRET):
        abort(404)
    if request.method == "GET":  # Meta's handshake when the destination is set
        if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
            abort(403)
        return request.args.get("hub.challenge", "")
    for entry in request.get_json().get("entry", []):
        for change in entry.get("changes", []):
            if change.get("field") == "messages":  # echoes and history are context, not prompts
                value = change["value"]
                for msg in value.get("messages", []):
                    jobs.put((value["metadata"]["phone_number_id"], msg))
    return "", 200  # answer at once; dedupe on msg["id"], since Meta can deliver twice

def worker() -> None:
    while True:
        phone_number_id, msg = jobs.get()
        conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
                            headers=KEY, params={"credentials": 1}).json()
        creds = conn["credentials"]
        if not creds["access_token"]:  # token_ready is false: a new connect session issues one
            continue
        reply = my_model(conn["external_ref"], msg)  # your model, your prompt, your memory
        requests.post(creds["send_endpoint"],  # a reply to a fresh message is inside the 24 hours
                      headers={"Authorization": f"Bearer {creds['access_token']}"},
                      json={"messaging_product": "whatsapp", "to": msg["from"],
                            "type": "text", "text": {"body": reply}})

threading.Thread(target=worker, daemon=True).start()

Serveur MCP ou API Partner : lequel l'agent utilise-t-il ?

L'API Partner, lorsque l'agent est votre produit et que vos clients apportent les canaux : votre backend détient la clé, reçoit les événements et exécute le modèle de votre choix. Le serveur MCP à l'adresse https://easycoexistence.com/api/mcp convient à un assistant comme Claude ou ChatGPT agissant sur votre propre compte easyCoexistence, via des outils qu'il appelle sur demande après une connexion OAuth. Les numéros et canaux connectés avec votre clé se trouvent aussi sur ce compte, si bien qu'une session MCP peut les atteindre pour le travail de votre équipe.

Partner APIMCP server
Built forYour product, serving your customersAn assistant working on your own account
Signs in withAn ec_live_ key, one per accountOAuth, from Claude, ChatGPT or another client
Incoming messagesWebhooks to your backendRead when the assistant calls a tool
The modelAny model you runThe assistant's own
RepliesYour code calls each network's APITools such as send_message and reply_to_comment

Comment les agences font-elles tourner des agents pour de nombreux clients ?

Sur un seul compte, avec une étiquette par client. Transmettez l'ID du client comme external_ref à chaque session de connexion, affichez le nom de votre agence sur la page hébergée avec partner_name, et listez les connexions d'un client avec GET /connections?external_ref= et GET /channels?external_ref=. Chaque connexion est facturée à l'agence de US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, tandis que Meta facture les frais de conversation WhatsApp au compte WhatsApp Business propre au client. Avec Coexistence, le personnel du client continue de répondre dans l'application WhatsApp Business, à côté de l'agent.

Quelles règles l'agent doit-il respecter ?

Celles des réseaux, que votre code doit vérifier avant l'envoi de la réponse du modèle. Les plateformes les respectent pour le compte de leurs clients, car les sanctions de Meta frappent le compte du client :

  • WhatsApp : des réponses en texte libre uniquement dans les 24 heures suivant le dernier message du client ; au-delà, un template approuvé, envoyé via l'API, car l'application WhatsApp Business ne peut pas envoyer de templates en Coexistence.
  • WhatsApp : les conditions de Meta interdisent de proposer l'IA comme fonctionnalité principale, ce que la référence de l'API Partner traduit par l'interdiction des bots d'IA généralistes, et n'autorisent le fine-tuning sur les données WhatsApp qu'à l'usage exclusif de l'entreprise.
  • Instagram et Facebook : des DM dans les 24 heures suivant le dernier message de la personne, et une seule réponse privée par commentaire dans les 7 jours qui suivent celui-ci.
  • TikTok : les réponses aux commentaires sont publiques, une connexion TikTok n'ayant pas de DM.
  • Volume : 20 messages par seconde et par numéro Coexistence, et les templates marketing exigent un moyen de paiement sur le compte WhatsApp Business du client.

Comment l'agent sait-il qu'un canal a cessé de fonctionner ?

Grâce aux événements de statut. connection.disconnected ou channel.disconnected signifie que les réponses échouent tant que le client ne s'est pas reconnecté : suspendez donc l'agent de ce client, prévenez-le et envoyez-lui un nouveau lien de connexion ; connection.token_missing signifie que le numéro peut recevoir mais pas encore envoyer. Lorsque connection.connected ou channel.connected arrive à nouveau, récupérez de nouveaux identifiants et reprenez. Chaque événement est signé avec X-EC-Signature et renvoyé pendant environ 33 heures.

Erreurs courantes

  • Laisser le modèle répondre à un message WhatsApp de plus de 24 heures par du texte libre. La fenêtre est fermée : vérifiez l'heure du dernier message entrant du client et passez à un template approuvé.
  • Entraîner un modèle partagé sur les conversations WhatsApp de vos clients. Les conditions de Meta n'autorisent le fine-tuning sur les données de la WhatsApp Business Platform qu'à l'usage exclusif de l'entreprise, jamais pour améliorer d'autres modèles.
  • Traiter smb_message_echoes comme des messages de clients. Ce sont les messages envoyés par le personnel de l'entreprise depuis l'application : transmettez-les au modèle comme contexte, pas comme messages auxquels répondre.
  • Répondre aux propres réponses du compte. Les DM Instagram qu'il envoie reviennent sous forme d'échos, et les réponses TikTok sous forme d'événements de commentaire ; ignorez donc tout ce que le compte a lui-même écrit, sinon l'agent se répond à lui-même.
Faire cela avec EasyCoexistence

De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.

Questions fréquemment posées

Puis-je utiliser mon propre modèle d'IA ?

Oui. Votre backend reçoit les messages, appelle le modèle de votre choix et répond via l'API du réseau avec le token du client. Les messages d'un numéro WhatsApp vont directement de Meta à votre webhook, sans jamais passer par easyCoexistence.

Que signifie la politique IA de Meta pour un agent WhatsApp ?

Les conditions de Meta interdisent aux fournisseurs d'IA d'utiliser la WhatsApp Business Platform pour proposer une technologie d'IA comme fonctionnalité principale, et non accessoire ou secondaire, selon l'appréciation de Meta. Respectez-la pour le compte de vos clients, ainsi que la fenêtre de 24 heures et les templates approuvés.

L'agent peut-il envoyer des DM sur TikTok, YouTube ou LinkedIn ?

Non. Sur ces réseaux, l'agent travaille dans les commentaires : les réponses TikTok sont publiques, et les commentaires YouTube et LinkedIn sont lus et traités via leurs API.

Combien coûte easyCoexistence pour un produit d'agent IA ?

Par connexion, à l'identique sur chaque réseau : de US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit. Meta facture les frais de conversation WhatsApp au compte WhatsApp Business de chaque client.

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