Support client
Intercom dans votre produit et vos agents IA, via une API
Le toolkit Intercom couvre les contacts (utilisateurs et leads), les conversations avec réponses et assignation, les messages sortants, ainsi que les membres d'équipe et les équipes d'un workspace. Votre client connecte Intercom une fois via OAuth, et votre produit ou agent IA appelle chaque opération via Connect, qui stocke et renouvelle les identifiants et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/intercom_search_contacts/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"query": {}
}
}Fonctionnement
Du client connecté au premier appel à Intercom.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte Intercom. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec Intercom.
Garder les contacts synchronisés
Créez ou mettez à jour des contacts Intercom avec leurs attributs personnalisés quand des utilisateurs s'inscrivent ou changent de forfait dans votre produit.
Un agent de support trie la boîte
Un agent IA recherche les conversations ouvertes assignées à une équipe, lit chacune, répond en tant que membre de l'équipe et la ferme ou la met en attente.
Contact proactif depuis votre app
Envoyez un message à un contact dans le Messenger ou par email quand un événement survient dans votre produit, comme un paiement échoué.
Tools
13 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.
- Lister les conversationsGETListe 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.
- 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.
- Gérer une conversationPOSTFerme, met en attente, rouvre ou assigne une conversation. close exige type admin ; snoozed exige snoozed_until ; assignment exige type et assignee_id, et une conversation peut avoir un admin et une équipe assignés en même temps. Assigner une conversation fermée la rouvre, sauf si skip_reopen est true.
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.
Questions sur le toolkit Intercom
Dois-je intégrer l'API Intercom moi-même ?
Non. Connect fournit 13 tools Intercom décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte Intercom ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
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.
