Skip to main content
GET
API Famulor 1.0 (héritée). Cette page concerne uniquement Famulor 1.0 (app.famulor.de) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la référence API Famulor 2.0.
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, api
integer
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)
Ces champs sont présents uniquement pour les conversations de type 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 un external_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