Tools Chatwoot
Les 15 opérations Chatwoot que votre produit exécute sur le compte de votre client via Connect. Elles utilisent toutes le même endpoint, POST /api/tools/{tool}/execute.
- 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.
- Lier un contact à une boîtePOSTLie un contact existant à une autre boîte et renvoie le contact_inbox avec son source_id, pour Create conversation quand le contact n'a pas encore de source_id dans cette boîte.
- Lister les boîtes de réceptionGETListe les boîtes du compte, une par canal, comme WhatsApp, site web, email ou API, avec id, nom et channel_type. L'id est l'inbox_id des conversations et des contacts.
- Lister les agentsGETListe les agents du compte avec id, nom, email, rôle et availability_status. L'id est l'assignee_id d'une conversation.
- Lister les équipesGETListe les équipes du compte avec id, nom et si l'utilisateur de la connexion en est membre. L'id est le team_id des conversations.
- Obtenir le profilGETRenvoie l'utilisateur connecté : id, nom, email et les comptes auxquels il appartient, chacun avec id, nom et rôle. L'id de chaque compte est l'account_id demandé par les autres tools. Le champ access_token de la réponse est masqué.
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.
