Support client
Chatwoot dans votre produit et vos agents IA, via une API
Le toolkit Chatwoot couvre les conversations, messages, contacts, boîtes de réception, agents et équipes d'un compte Chatwoot Cloud : démarrer et assigner des conversations, changer leur statut et leurs étiquettes, envoyer des messages ou notes internes et gérer les contacts. Avec Connect, votre produit ou agent IA appelle ces opérations par un seul endpoint, pendant que Connect stocke les identifiants et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/chatwoot_create_conversation/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"account_id": 1,
"source_id": "<source_id>"
}
}Fonctionnement
Du client connecté au premier appel à Chatwoot.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Chatwoot. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Chatwoot.
Ouvrir une conversation depuis l'app
Quand un utilisateur a besoin d'aide, trouvez ou créez le contact, puis créez une conversation dans la bonne boîte avec un premier message.
Tri par agent IA
Un agent lit les derniers messages d'une conversation, répond ou laisse une note privée, ajoute des étiquettes, assigne à un agent ou une équipe et fixe le statut.
Contacts toujours synchronisés
Recherchez des contacts par email ou téléphone et mettez à jour leurs champs quand la fiche client change dans votre CRM ou SaaS.
Tools
15 tools Chatwoot
- Lister les conversationsGETListe les conversations d'un compte, par défaut les ouvertes, avec statut, étiquettes, inbox_id, can_reply, le contact dans meta.sender, l'assigné et le dernier message. data.meta contient les compteurs par type d'assigné. Les pages commencent à 1 ; un payload vide signifie qu'il n'y a plus de pages.
- Créer une conversationPOSTDémarre une conversation avec un contact dans une boîte, éventuellement avec un premier message. source_id identifie le contact dans cette boîte : il vient de contact_inboxes dans Search contacts, de Create contact ou de Create contact inbox. Dans les boîtes WhatsApp, le premier message part comme template approuvé dans message.template_params.
- Mettre à jour le statut d'une conversationPOSTDéfinit le statut d'une conversation : open, resolved, pending ou snoozed. Sans snoozed_until, une conversation en snoozed attend la prochaine réponse du contact, et toute réponse du contact la rouvre.
- Assigner une conversationPOSTAssigne une conversation à un agent ou à une équipe. Quand assignee_id est envoyé, team_id est ignoré.
- Mettre à jour les étiquettes d'une conversationPOSTDéfinit les étiquettes d'une conversation. La liste envoyée remplace les étiquettes actuelles : elle doit donc inclure celles à conserver.
- Lister les messagesGETRenvoie les derniers messages d'une conversation dans l'ordre croissant, avec meta contenant étiquettes, contact et assigné. sender_type indique qui a envoyé chaque message, et private marque les notes internes. Pour des messages plus anciens, passez before avec l'id du plus ancien reçu.
- Créer un messagePOSTEnvoie un message dans une conversation. Un message sortant arrive au contact par le canal de la boîte, comme WhatsApp, email ou le widget du site ; private true crée une note interne que seuls les agents voient. Sur WhatsApp, template_params envoie un template approuvé.
- Rechercher des contactsGETRecherche les contacts qui ont un identifiant, un email ou un téléphone, par nom, identifiant, email ou numéro de téléphone, 15 par page. Chaque contact a contact_inboxes, qui associe chaque boîte au source_id dont Create conversation a besoin. meta.count est le total ; une page de moins de 15 contacts est la dernière.
- Créer un contactPOSTCrée un contact dans une boîte du compte. La réponse contient le contact et le contact_inbox avec le source_id dont Create conversation a besoin.
- Mettre à jour un contactPUTMet à jour un contact : envoyez uniquement les champs à modifier.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
Questions sur le toolkit Chatwoot
Dois-je intégrer l'API Chatwoot moi-même ?
Non. Connect fournit 15 tools Chatwoot décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Chatwoot ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
