Lister les conversations avec l'API Intercom
Liste les conversations du workspace, 20 par page par défaut. La page suivante vient de pages.next.starting_after dans la réponse ; sans lui, c'est la dernière page. Obtenir une conversation renvoie toutes les parties d'une conversation.
- Identifiant
- intercom_list_conversations
L'appel
POST https://connect.reportei.com/api/tools/intercom_list_conversations/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"per_page": 1
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| per_page | integer | Non | Conversations per page, up to 150. The default is 20. |
| starting_after | string | Non | The pages.next.starting_after of the previous response. Omit it on the first page. |
Connexions possibles
Votre client connecte son compte Intercom une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/intercom, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/intercom_list_conversations. Il devient la définition de tool de votre agent sans conversion.
Autres tools Intercom
- Lister les contactsGETListe les contacts du workspace, utilisateurs et leads, 10 par page par défaut. La page suivante vient de pages.next.starting_after dans la réponse ; sans lui, c'est la dernière page. Les contacts fusionnés n'apparaissent pas.
- Rechercher des contactsPOSTRecherche des contacts par leurs attributs, par exemple par email, role ou un attribut personnalisé. Les timestamps sont en secondes Unix UTC. Renvoie total_count et data, 50 par page par défaut, et la page suivante vient de pages.next.starting_after. Un contact créé ces dernières minutes peut ne pas encore apparaître.
- Obtenir un contactGETRenvoie un contact avec role, email, téléphone, nom, owner_id, custom_attributes, tags, entreprises et localisation. Un contact fusionné dans un autre renvoie 410.
- Créer un contactPOSTCrée un contact, utilisateur ou lead. Envoyez au moins un parmi email, external_id ou role. Chaque attribut personnalisé envoyé doit déjà exister dans le workspace, sinon Intercom refuse le contact.
- Mettre à jour un contactPUTMet à jour un contact : envoyez seulement les champs à modifier. Un utilisateur ne peut pas devenir lead. Chaque attribut personnalisé envoyé doit déjà exister dans le workspace.
- Rechercher des conversationsPOSTRecherche des conversations par leurs attributs, par exemple les ouvertes assignées à un membre de l'équipe ou à une équipe. Les timestamps sont en secondes Unix. Renvoie total_count et conversations, 20 par page par défaut, et la page suivante vient de pages.next.starting_after.
- Obtenir une conversationGETRenvoie une conversation avec ses parties (messages, notes et actions), jusqu'aux 500 plus récentes, plus state, assignés, contacts et tags.
- Répondre à une conversationPOSTRépond à une conversation en tant que membre de l'équipe. Un comment parvient au contact par le canal de la conversation, comme le Messenger ou l'email ; une note reste interne, visible seulement des équipiers. Fermer, mettre en attente, rouvrir et assigner se font avec Gérer une conversation.
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.
