Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Architecture SaaS d'agents IA : atteindre les clients de vos clients sur WhatsApp, Instagram et TikTok

Un SaaS d'agents IA qui atteint les clients de vos clients fonctionne en cinq couches : les connexions, où chaque client relie WhatsApp, Instagram, TikTok et d'autres canaux via la Partner API d'easyCoexistence ; l'ingestion, qui vérifie et met en file d'attente les webhooks ; un stockage des conversations qui vous appartient ; un worker d'agent qui exécute votre modèle ; et les envois sortants, qui répondent, publient et suivent les événements de statut via l'API officielle de chaque réseau.

smb_message_echoes

Le webhook qui décrit un message envoyé par l'entreprise depuis l'application WhatsApp Business sur un numéro Coexistence.

7 days

Durée pendant laquelle Meta renvoie un webhook WhatsApp que votre endpoint n'a pas accepté, ce qui peut livrer deux fois le même message.

1 attempt

Livraisons de chaque événement Instagram, Facebook ou TikTok transmis, sans nouvelle tentative et sans copie conservée.

24 hours

Fenêtre de service client WhatsApp ouverte par le message d'une personne ; en dehors, une entreprise n'envoie que des templates approuvés.

20 mps

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

Quelles sont les couches d'un SaaS d'agents IA ?

Cinq, chacune avec une seule mission, pour qu'un modèle lent ne perde jamais un message et qu'un compte interrompu ne fasse pas tomber le produit. easyCoexistence occupe la première et la dernière : il connecte les comptes et les maintient opérationnels, tandis que la logique conversationnelle et le modèle restent dans votre backend.

1ConnectionsHosted links, channel_id and connection_id per customer
2IngestionVerify, queue, then answer 2xx
3ConversationsYour store, one thread per person
4AgentYour model, prompts and tools
5OutboundReplies, posts and status events

Comment modéliser les tenants, les canaux et les conversations ?

En trois tables. Un tenant correspond à votre client, et son id est transmis comme external_ref à chaque session de connexion, si bien que chaque connexion et chaque événement de statut revient étiqueté avec lui. Une ligne canal contient le connection_id d'un numéro WhatsApp ou le channel_id d'un compte social, avec le réseau et son statut. Une conversation est indexée sur le canal et sur l'identifiant de la personne sur ce réseau : le numéro WhatsApp dans from, l'ID propre à Instagram pour un DM, ou le fil du commentaire sur TikTok.

Où les événements entrants doivent-ils arriver en premier ?

Dans une file d'attente durable, avant l'exécution de tout modèle. L'endpoint d'ingestion vérifie le secret dans le chemin de l'URL pour les livraisons WhatsApp et X-EC-Signature pour les événements sociaux transmis, écrit l'événement dans la file et répond 2xx. Les deux sources se comportent différemment : Meta renvoie un webhook WhatsApp pendant jusqu'à 7 jours, donc le même message peut arriver deux fois, alors qu'un événement Instagram, Facebook ou TikTok transmis n'est envoyé qu'une fois et n'est jamais conservé ; un événement refusé par votre endpoint est donc perdu. Dédupliquez sur l'identifiant natif du message ou du commentaire dans le réseau.

Comment garder les réponses dans l'ordre et à temps ?

Un worker par conversation, et une vérification avant chaque envoi. Verrouillez la conversation pendant le travail de l'agent, pour que deux messages d'une même personne soient traités à tour de rôle et jamais en double. Avant qu'une réponse WhatsApp parte, comparez le dernier message de la personne avec la fenêtre de 24 heures, et passez à un template approuvé une fois celle-ci fermée. Mettez en file les envois de chaque numéro à 20 messages par seconde au maximum, débit fixe d'un numéro Coexistence, et rappelez-vous qu'une réponse TikTok est un commentaire public.

Comment une personne reprend-elle la main sur l'agent ?

Par le canal lui-même. Avec Coexistence, le personnel de votre client continue d'utiliser l'application WhatsApp Business sur le même numéro, et chaque message qu'il envoie arrive à votre webhook sous la forme smb_message_echoes. Traitez un écho comme un passage de relais : suspendez l'agent sur cette conversation, transmettez la réponse du personnel au modèle comme contexte, et reprenez après une période de calme ou lorsque le personnel vous rend la main dans votre produit. Instagram renvoie aussi les DM du compte sous forme d'échos : la même règle empêche donc l'agent de se répondre à lui-même.

L'agent doit-il aussi publier, et pas seulement répondre ?

Il le peut, avec la même clé. L'agent rédige des publications, et votre backend les met en file avec POST /channels/:id/posts sur Instagram, Facebook, TikTok et LinkedIn, de 1 minute à 90 jours à l'avance, les événements post.published et post.failed remontant vers le stockage des conversations. Les publications LinkedIn ne partent qu'après qu'une personne a approuvé chacune d'elles dans votre produit, car les conditions d'utilisation de l'API LinkedIn restreignent la publication automatisée.

Comment le produit réagit-il lorsqu'une connexion tombe ?

Par un statut sur la ligne du canal. Un événement de statut le fait passer à disconnected, removed ou suspended : l'agent cesse d'envoyer sur ce canal, et votre interface demande au tenant de se reconnecter via une nouvelle session de connexion. Un événement connection.token_missing laisse un numéro qui reçoit encore mais ne peut plus envoyer ; l'agent rédige donc des réponses pour le personnel à la place. connection.connected ou channel.connected remet la ligne à active, et le worker récupère des identifiants à jour avant sa prochaine réponse.

Quelles données stockez-vous, et lesquelles easyCoexistence conserve-t-il ?

Votre produit stocke les conversations. Les messages d'un numéro WhatsApp vont directement de Meta à votre webhook, et les événements sociaux transmis passent par easyCoexistence sans copie. easyCoexistence conserve ce dont il a besoin pour assurer la connexion : la fiche du compte, ses tokens, son historique de santé et les publications qu'il diffuse. Si votre compte active aussi les automatisations propres à easyCoexistence, le texte de leurs messages est conservé 7 jours et leurs journaux d'exécution 30 jours.

Erreurs courantes

  • Indexer les conversations sur le seul numéro de téléphone de la personne. La même personne peut écrire à deux de vos tenants : indexez donc chaque fil sur le canal et l'identifiant de la personne ensemble.
  • Laisser deux workers répondre à une même conversation. Des workers parallèles peuvent envoyer des réponses dans le désordre ou en double : verrouillez donc chaque fil pendant le travail de l'agent.
  • Laisser l'agent actif après que le personnel a répondu depuis l'application WhatsApp Business. L'écho indique qu'une personne a repris le fil : suspendez alors l'agent jusqu'à ce que votre règle de passage de relais le rende.
  • Publier les brouillons LinkedIn de l'agent sur un minuteur. Une personne approuve chaque publication LinkedIn : acheminez donc ces brouillons vers une étape de relecture avant qu'ils n'atteignent la file.
Faire cela avec EasyCoexistence

easyCoexistence est la couche de connexion de votre produit d'agents : les numéros WhatsApp de vos clients, leurs comptes Instagram, Facebook, TikTok, YouTube et LinkedIn, et d'autres canaux encore, connectés par des liens hébergés, avec des identifiants à jour, des webhooks, une file de publication et des événements de statut signés, chaque connexion étant surveillée 24/7. De US$ 9 à US$ 0,75 par connexion et par mois, qui baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Les clients de mes clients doivent-ils installer quoi que ce soit ?

Non. Ils écrivent à l'entreprise comme ils le font déjà, sur WhatsApp, en DM Instagram ou sur Messenger, ou dans les commentaires, et votre agent répond sur le même canal.

Le personnel de mes clients peut-il continuer à répondre à la main ?

Oui. Avec Coexistence, l'application WhatsApp Business continue de fonctionner sur le même numéro, et chaque message envoyé par le personnel arrive à votre webhook sous forme d'écho, afin que l'agent puisse laisser la place.

easyCoexistence exécute-t-il le modèle ?

Non. Le modèle, ses prompts et sa mémoire s'exécutent dans votre backend. easyCoexistence connecte les comptes, livre leurs événements et maintient leur accès opérationnel.

Combien easyCoexistence facture-t-il par client d'un SaaS d'agents ?

Chaque numéro ou compte connecté coûte de US$ 9 à US$ 0,75 par mois, dégressif à mesure que votre total augmente, si bien qu'un client présent sur WhatsApp et Instagram compte deux fois. Un essai gratuit de 3 jours s'applique.

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