Chatbot IA
Lister les conversations
Listez toutes les conversations de l’utilisateur authentifié avec filtrage et pagination par curseur
GET
Ce point de terminaison retourne une liste paginée par curseur des conversations appartenant aux assistants de l’utilisateur authentifié. Utilisez-le pour consulter l’historique des conversations, filtrer par type, ou intégrer avec votre CRM.
Ce point de terminaison utilise une pagination par curseur pour de meilleures performances avec de gros volumes de données. Utilisez
next_cursor et prev_cursor pour naviguer entre les pages.Paramètres de requête
string
Filtre les conversations par type. Valeurs possibles :
test, widget, whatsapp, apiinteger
Filtre les conversations par ID d’assistant (doit appartenir à l’utilisateur authentifié)
string
Filtre les conversations par numéro de téléphone du client (correspondance exacte). Utile pour retrouver toutes les conversations avec un client spécifique.
string
Filtre les conversations par numéro de téléphone de l’expéditeur WhatsApp (correspondance exacte). Utile pour retrouver toutes les conversations d’un numéro WhatsApp Business spécifique.
string
Filtre les conversations par identifiant externe. Utile pour retrouver les conversations liées à des enregistrements de votre système externe.
integer
Nombre de conversations par page (1-100, par défaut : 15)
string
Curseur de pagination. Utilisez
next_cursor ou prev_cursor d’une réponse précédente.Champs de réponse
array
string
Curseur pour récupérer la page de résultats suivante. Transmettez-le comme paramètre
cursor dans votre prochaine requête. null s’il n’y a pas d’autres résultats.string
Curseur pour récupérer la page de résultats précédente.
null s’il s’agit de la première page.integer
Nombre d’éléments par page
Types de conversation
Paramètres de filtrage
Tous les paramètres de filtrage utilisent des colonnes indexées pour une exécution efficace des requêtes :Détails des conversations WhatsApp
Pour les conversations WhatsApp, la réponse inclut des champs supplémentaires :- whatsapp_sender : le numéro WhatsApp Business qui a mené la conversation (nom et numéro de téléphone de votre expéditeur WhatsApp)
- customer : le client qui a initié ou reçu la conversation (son nom et son numéro de téléphone)
whatsapp et permettent d’identifier les parties impliquées lors de l’intégration avec votre CRM ou vos systèmes de support.
Détails des conversations API
Pour les conversations créées via l’API, vous pouvez définir unexternal_identifier lors de la création de la conversation. Cet identifiant est retourné dans la réponse et peut être utilisé pour :
- Lier les conversations à vos leads ou contacts CRM
- Suivre les conversations à travers vos systèmes internes
- Filtrer les conversations par votre référence externe
Cas d’usage
- Tableau de bord analytique : afficher les métriques et tendances des conversations
- Intégration CRM : synchroniser les données de conversation avec votre base clients via
external_identifier - Recherche client : retrouver toutes les conversations avec un client particulier via
customer_phone - Contrôle qualité : examiner le volume de conversations par type et par assistant
- Audit de facturation : suivre les coûts de conversation au sein de votre organisation