API Chatwoot : conversations, contacts et boîtes de réception avec l'IA
Chatwoot est une plateforme de service client omnicanale open source, et son API REST couvre les conversations, les messages, les contacts et les paramètres du compte. Elle sert aux entreprises qui hébergent leur propre Chatwoot ou utilisent la version cloud et veulent y brancher des bots et des automatisations. L'accès se fait par un jeton d'utilisateur ou d'agent bot.
Ce que propose l’API Chatwoot
Conversations
Lister, filtrer, assigner et changer le statut des conversations.
Messages
Envoyer des messages et des notes privées dans une conversation, avec pièces jointes.
Contacts
Créer, rechercher et mettre à jour les contacts et leurs attributs.
Boîtes de réception
Consulter et configurer des canaux comme WhatsApp, l'e-mail et le site.
Étiquettes, équipes et attributs
Classer les conversations et les répartir entre les équipes.
Webhooks et agent bots
Recevoir des événements de messages et de conversations et répondre en tant que bot.
Comment accéder à l’API Chatwoot
- Avec les identifiants de votre entrepriseChaque appel porte un jeton d'accès dans l'en-tête : le jeton de profil d'un utilisateur ou celui d'un agent bot créé dans le compte.
- Pour une installation en propre, les limites dépendent de votre serveur. Dans le cloud, suivez les règles de l'offre.
- Les conversations contiennent des données personnelles : définissez la durée de conservation et qui voit l'historique.
- Commencez avec le bot sur une seule boîte de réception et montez en charge ensuite.
Documentation officielle: www.chatwoot.com/developers/api
Ce qu’un agent iTeam fait avec l’API Chatwoot
Premier niveau de support dans Chatwoot
L'agent répond comme bot dans les boîtes de réception, résout les questions courantes et passe la main à un humain avec la conversation résumée.
Étiquettes automatiques
Chaque conversation reçoit une étiquette de sujet et d'urgence, et part vers la bonne équipe.
Contact enrichi
L'agent retrouve le client dans le CRM ou l'ERP et enregistre des attributs sur le contact, comme l'offre et la dernière commande.
Rapport des motifs
Chaque semaine, l'agent lit les conversations résolues et montre les motifs de contact qui progressent le plus.
De l’identifiant à l’agent au travail, avec validation
Créez l'agent bot dans Chatwoot
Dans Chatwoot, créez un agent bot (ou un utilisateur d'intégration), copiez le jeton et définissez dans quelles boîtes de réception il intervient.
Définissez les permissions par agent
Dans iTeam, l'identifiant Chatwoot va dans le coffre et chaque agent reçoit une liste fermée d'actions (répondre aux conversations, appliquer des étiquettes, transférer à un humain). Les actions qui modifient des données demandent l'approbation d'une personne.
Validez à petite échelle, puis élargissez
Commencez par un cas : envoyez un message de test dans une boîte de réception interne. Une fois le résultat vérifié, le processus monte en volume, toujours avec traçabilité et approbation là où il y a un risque.
Équipes IA prêtes à l’emploi qui utilisent Chatwoot
Questions sur l’API Chatwoot
L'API Chatwoot est-elle gratuite ?
Chatwoot est open source et l'API est fournie avec, aussi bien en installation propre que dans les offres cloud. Le coût est celui de l'hébergement ou de l'offre souscrite.
Faut-il programmer pour utiliser l'API Chatwoot avec iTeam ?
Non. iTeam lit la documentation de l'API Chatwoot, construit les appels et l'équipe de déploiement ajuste le flux avec vous. L'entreprise n'a qu'à approuver et à suivre.
L'agent d'iTeam remplace-t-il les conseillers de Chatwoot ?
Non. Il répond comme bot, traite ce qui est répétitif et transfère à l'équipe avec le contexte. Les conseillers restent dans Chatwoot, avec moins de file d'attente.
