Tools Intercom
Les 13 opérations Intercom 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 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.
- Créer un messagePOSTEnvoie un nouveau message d'un membre de l'équipe à un contact, dans le Messenger (in_app) ou par email. L'email exige subject et template. La conversation n'existe qu'après la réponse du contact, sauf si create_conversation_without_contact_reply est true.
- Lister les équipiersGETListe les équipiers (admins) du workspace avec id, nom, email, away_mode_enabled et team_ids. L'id est l'admin_id des réponses et actions de conversation et l'owner_id des contacts.
- Lister les équipesGETListe les équipes du workspace avec id, nom et admin_ids. L'id est l'assignee_id d'une conversation assignée à une équipe.
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.
