# Fiche connecteur Intercom
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## Intercom
URL : https://get-bruno.com/features/connectors/intercom
Référence texte : https://get-bruno.com/features/connectors/intercom/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Communication
Description : Intercom est un service de support et de messagerie client. Il permet de gérer des contacts, des conversations, des notes et des messages, avec plusieurs déclencheurs documentés sur les événements du compte.
Authentification : OAuth
Présentation : Intercom est un service de support et de messagerie client. Il permet de gérer des contacts, des conversations, des notes et des messages, avec plusieurs déclencheurs documentés sur les événements du compte.
Usage : Retrouver un contact puis lui ajouter une étiquette
Exemple de demande : Je veux retrouver le contact de Camille Durand dans Intercom et lui ajouter l'étiquette VIP Support.
Résultat attendu : Le contact ciblé est trouvé, puis l'étiquette choisie peut être ajoutée à sa fiche.
À préciser : Valeur de recherche pour retrouver le contact ; Nom ou identifiant de l'étiquette à appliquer ; Référence du contact à vérifier avant l'écriture
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/intercom/actions/search-contacts ; https://pipedream.com/apps/intercom/actions/list-tag-id-options ; https://pipedream.com/apps/intercom/actions/add-tag-to-contact
Usage : Lire une conversation puis la clôturer avec un commentaire
Exemple de demande : Je veux ouvrir la conversation 192783634529321 pour vérifier l'échange avant de la fermer avec la note Problème résolu.
Résultat attendu : La conversation est récupérée, puis son état peut être modifié avec un commentaire de clôture.
À préciser : Identifiant de conversation ; Message ou commentaire de clôture ; Vérification préalable de l'état actuel de la conversation
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/intercom/actions/retrieve-conversation ; https://pipedream.com/apps/intercom/actions/manage-conversation
Usage : Préparer une réponse ou un message sortant
Exemple de demande : Je veux préparer une réponse à la conversation de Paul Lefevre avec le texte Merci pour votre retour et vérifier l'admin à utiliser.
Résultat attendu : Les identifiants utiles sont retrouvés, puis un message ou une réponse peut être préparé pour envoi.
À préciser : Identifiant de conversation ou de contact ; Texte de la réponse ou du message ; Admin, équipe ou destinataire à sélectionner selon l'action
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/intercom/actions/list-admin-id-options ; https://pipedream.com/apps/intercom/actions/list-team-assignee-id-options ; https://pipedream.com/apps/intercom/actions/reply-to-conversation ; https://pipedream.com/apps/intercom/actions/search-contacts
Limites propres au service : Les conversations doivent être retrouvées par recherche ou récupération avant certaines actions. Plusieurs opérations nécessitent de résoudre d'abord des identifiants d'admin, d'équipe ou d'étiquette. Les listes renvoient des pages bornées et peuvent demander une pagination supplémentaire. Les déclencheurs sont documentés, mais ils ne remplacent pas les actions de lecture ou d'écriture.
Vocabulaire français : Ajouter une étiquette à un contact — Ajoute une étiquette précise à un contact Intercom après avoir retrouvé le contact et l'étiquette valides. (https://pipedream.com/apps/intercom/actions/add-tag-to-contact)
Vocabulaire français : Créer une note — Ajoute une note sur la fiche d'un contact dans Intercom. (https://pipedream.com/apps/intercom/actions/create-note)
Vocabulaire français : Lister les options d'identifiant d'admin — Renvoie les administrateurs disponibles avec leurs identifiants pour les actions qui exigent un admin. (https://pipedream.com/apps/intercom/actions/list-admin-id-options)
Vocabulaire français : Lister les options d'identifiant d'assignation — Renvoie les équipes disponibles avec leurs identifiants pour affecter une conversation. (https://pipedream.com/apps/intercom/actions/list-team-assignee-id-options)
Vocabulaire français : Lister les conversations — Renvoie une page bornée de conversations et permet de retrouver l'identifiant d'une conversation. (https://pipedream.com/apps/intercom/actions/list-conversations)
Vocabulaire français : Lister les options d'identifiant d'étiquette — Renvoie les étiquettes disponibles avec leurs identifiants pour l'action d'ajout d'étiquette. (https://pipedream.com/apps/intercom/actions/list-tag-id-options)
Vocabulaire français : Gérer une conversation — Ferme, met en veille, ouvre ou attribue une conversation à partir de son identifiant. (https://pipedream.com/apps/intercom/actions/manage-conversation)
Vocabulaire français : Répondre à une conversation — Publie une réponse sur une conversation existante au nom d'un admin ou d'un contact. (https://pipedream.com/apps/intercom/actions/reply-to-conversation)
Vocabulaire français : Récupérer une conversation — Renvoie la conversation complète à partir de son identifiant, avec son fil et ses informations d'assignation. (https://pipedream.com/apps/intercom/actions/retrieve-conversation)
Vocabulaire français : Rechercher des contacts — Recherche des contacts Intercom à partir d'une requête et renvoie leurs identifiants utiles. (https://pipedream.com/apps/intercom/actions/search-contacts)
Vocabulaire français : Envoyer un message entrant — Crée une conversation entrante dans Intercom au nom d'un contact. (https://pipedream.com/apps/intercom/actions/send-incoming-message)
Vocabulaire français : Envoyer un message à un contact — Envoie un message sortant depuis un admin vers un contact Intercom. (https://pipedream.com/apps/intercom/actions/send-message-to-contact)
Vocabulaire français : Créer ou mettre à jour un contact — Crée un contact ou met à jour un contact existant si l'adresse e-mail correspond déjà. (https://pipedream.com/apps/intercom/actions/upsert-contact)
Vocabulaire français : Nouvelles entreprises — Déclenche un événement à chaque nouvelle entreprise ajoutée. (https://pipedream.com/apps/intercom/triggers/new-company)
Vocabulaire français : Nouvelle réponse d'admin — Déclenche un événement à chaque réponse d'un admin à une conversation. (https://pipedream.com/apps/intercom/triggers/new-admin-reply)
Vocabulaire français : Nouvelles conversations — Déclenche un événement à chaque nouvelle conversation ajoutée. (https://pipedream.com/apps/intercom/triggers/new-conversation)
Vocabulaire français : Nouvelle réponse d'utilisateur — Déclenche un événement à chaque réponse d'un utilisateur à une conversation. (https://pipedream.com/apps/intercom/triggers/new-user-reply)
Vocabulaire français : Nouvelles désinscriptions — Déclenche un événement à chaque désinscription d'un utilisateur aux e-mails. (https://pipedream.com/apps/intercom/triggers/new-unsubscription)
Vocabulaire français : Nouveaux utilisateurs — Déclenche un événement à chaque nouvel utilisateur ajouté. (https://pipedream.com/apps/intercom/triggers/new-user)
Vocabulaire français : E-mail ajouté par un prospect — Déclenche un événement quand un prospect ajoute son adresse e-mail. (https://pipedream.com/apps/intercom/triggers/lead-added-email)
Vocabulaire français : Nouvelle conversation fermée — Déclenche un événement à chaque conversation fermée. (https://pipedream.com/apps/intercom/triggers/conversation-closed)
Vocabulaire français : Nouvelle évaluation de conversation — Déclenche un événement quand une nouvelle évaluation est ajoutée à une conversation. (https://pipedream.com/apps/intercom/triggers/new-conversation-rating-added)
Vocabulaire français : Nouvel événement — Déclenche un événement pour chaque nouvel événement Intercom lié à un utilisateur. (https://pipedream.com/apps/intercom/triggers/new-event)
Vocabulaire français : Nouveaux prospects — Déclenche un événement à chaque nouveau prospect ajouté. (https://pipedream.com/apps/intercom/triggers/new-lead)
Vocabulaire français : Nouveaux tickets — Déclenche un événement quand un nouveau ticket est créé dans Intercom. (https://pipedream.com/apps/intercom/triggers/new-ticket)
Vocabulaire français : Nouveau sujet, instantané — Déclenche un événement pour chaque nouveau sujet souscrit dans votre webhook. (https://pipedream.com/apps/intercom/triggers/new-topic)
Vocabulaire français : Étiquette ajoutée à une conversation — Déclenche un événement à chaque ajout d'étiquette à une conversation. (https://pipedream.com/apps/intercom/triggers/tag-added-to-conversation)
Vocabulaire français : Étiquette ajoutée à un prospect — Déclenche un événement à chaque ajout d'étiquette à un prospect. (https://pipedream.com/apps/intercom/triggers/tag-added-to-lead)
Vocabulaire français : Étiquette ajoutée à un utilisateur — Déclenche un événement à chaque ajout d'étiquette à un utilisateur. (https://pipedream.com/apps/intercom/triggers/tag-added-to-user)
- action : Add Tag To Contact — Adds a specific tag to a contact in Intercom. Use Search Contacts to find the contact's ID and List Tag ID Options to find valid tag IDs before calling this action. Example: set Contact ID to 63a07ddf05a32042dffac965 and Tag ID to 7522907 to tag that contact. Returns the updated tag object on success. See the documentation. (https://pipedream.com/apps/intercom/actions/add-tag-to-contact)
- action : Create Note — Creates a note on a contact's record in Intercom. The note is automatically attributed to the currently authenticated admin — no Admin ID prop is required. Use Search Contacts to find the contact's ID before calling this action. Example: set User to 63a07ddf05a32042dffac965 and Body to Followed up via email on 2024-01-15 to log a note on that contact. Returns the new note object including id , body , and author . See the documentation (https://pipedream.com/apps/intercom/actions/create-note)
- action : List Admin ID Options — Retrieves all admins in your Intercom workspace and returns their IDs and names. Call this action before any action that requires an Admin ID — such as Manage A Conversation , Reply To Conversation , or Send Message To Contact — to discover valid values. Example: returns [{ label: "Jane Doe", value: "25" }, ...] . See the documentation. (https://pipedream.com/apps/intercom/actions/list-admin-id-options)
- action : List Assignee ID Options — Retrieves all teams in your Intercom workspace and returns their IDs and names. Call this action before Manage A Conversation to discover valid team IDs for conversation assignment. Example: returns [{ label: "Support", value: "334" }, ...] . Use 0 to represent Unassigned. See the documentation. (https://pipedream.com/apps/intercom/actions/list-team-assignee-id-options)
- action : List Conversations — Lists conversations in your Intercom workspace, most recently updated first (GET /conversations). Use this to discover a conversation's ID before calling Reply To Conversation , Manage A Conversation , or Retrieve Conversation — there is no other way to look one up. Returns a bounded page of conversations, each including id , state , created_at , and the latest message part. If pages.next.starting_after is present in the response, call this action again with that cursor in Starting After to retrieve the next page. Pass Fields (e.g. ["id", "state", "created_at"] ) to limit each returned conversation to only those keys. Example: leave all props empty to fetch the 20 most recently updated conversations. See the documentation. (https://pipedream.com/apps/intercom/actions/list-conversations)
- action : List Tag ID Options — Retrieves all tags in your Intercom workspace and returns their IDs and names. Call this action before Add Tag To Contact to discover valid tag IDs. Example: returns [{ label: "VIP", value: "7522907" }, ...] . See the documentation. (https://pipedream.com/apps/intercom/actions/list-tag-id-options)
- action : Manage A Conversation — Close, snooze, open, or assign a conversation by its ID. Which of the optional props apply depends on Message Type : close uses Body , snoozed uses Snoozed Until , assignment uses Type together with Assignee ID or Team Assignee ID , and open uses none of them. Example: set Conversation ID to 192783634529321 , Message Type to close , and Body to Issue resolved to close that conversation with a closing comment. See the documentation. (https://pipedream.com/apps/intercom/actions/manage-conversation)
- action : Reply To Conversation — Reply to an existing Intercom conversation as an admin or on behalf of a contact (POST /conversations/{conversation_id}/reply). Use List Admin ID Options to find a valid Admin ID, and Search Contacts to find a contact's Intercom user ID, email, or external user ID. Example: set Conversation ID to 192783634529321 , Reply Type to admin , Message Type to comment , Body to Thanks for reaching out! , and Admin ID to 25 to post that comment as an admin reply. See the documentation. (https://pipedream.com/apps/intercom/actions/reply-to-conversation)
- action : Retrieve A Conversation — Fetches a single Intercom conversation by ID and returns the full conversation object, including id , title , state , created_at , conversation_parts (the message thread), and assignee information. Use this to inspect conversation history or verify state before calling Manage A Conversation or Reply To Conversation . Example: set Conversation ID to 123456789 to retrieve that conversation. Pass Fields (e.g. ["id", "state", "assignee", "created_at"] ) to limit the returned object to only those keys. See the documentation. (https://pipedream.com/apps/intercom/actions/retrieve-conversation)
- action : Search Contacts — Search Intercom contacts by a query string (POST /contacts/search). Returns a bounded page of matching contacts, each including id , email , and external_id so you can copy the appropriate value into Reply To Conversation 's Intercom User ID, Email, or User ID prop. If pages.next.starting_after is present in the response, call this action again with that cursor in Starting After to retrieve the next page. Pass Fields (e.g. ["id", "email", "external_id"] ) to limit each returned contact to only those keys. Example: set Query to acme to find all contacts whose email contains acme . See the documentation. (https://pipedream.com/apps/intercom/actions/search-contacts)
- action : Send Incoming Message — Creates a new inbound conversation in Intercom on behalf of a contact (POST /conversations). The action first fetches the contact's role via GET /contacts/{id} to set the correct message sender type — this counts as an additional API call. Use Search Contacts to find valid contact IDs before calling this action. Example: set User to 63a07ddf05a32042dffac965 and Body to Hi, I need help with my order to open a new conversation from that contact. Returns the new conversation object including id . See the documentation (https://pipedream.com/apps/intercom/actions/send-incoming-message)
- action : Send Message To Contact — Sends an outbound message from an admin to a contact in Intercom (POST /messages). Set Message Type to in_app for an in-app message or email for an email — email messages require Subject and support Template ( plain or personal ). Use List Admin ID Options to find a valid From ID and Search Contacts to find a valid To ID . Example: set Message Type to email , Subject to Welcome! , Template to personal , From ID to 25 , To Type to user , and To ID to 536e564f316c83104c000020 to send a personal welcome email to that contact. See the documentation. (https://pipedream.com/apps/intercom/actions/send-message-to-contact)
- action : Upsert Contact — Create a new contact, or update an existing one if a contact with the same Email already exists — Email is the match key for this upsert (any other props you set only apply to the created/updated record, they do not affect matching). Example: set Email to jane.doe@acme.com , Name to Jane Doe , and Custom Attributes to {"plan": "pro"} to create Jane's contact, or update her name / plan if a contact with that email already exists. Returns the full contact object, including its Intercom id . See the documentation. (https://pipedream.com/apps/intercom/actions/upsert-contact)
- trigger : New Companies — Emit new event each time a new company is added. (https://pipedream.com/apps/intercom/triggers/new-company)
- trigger : New Reply From Admin — Emit new event each time an admin replies to a conversation. (https://pipedream.com/apps/intercom/triggers/new-admin-reply)
- trigger : New Conversations — Emit new event each time a new conversation is added. (https://pipedream.com/apps/intercom/triggers/new-conversation)
- trigger : New Reply From User — Emit new event each time a user replies to a conversation. (https://pipedream.com/apps/intercom/triggers/new-user-reply)
- trigger : New Unsubscriptions — Emit new event each time a user unsubscribes from receiving emails. (https://pipedream.com/apps/intercom/triggers/new-unsubscription)
- trigger : New Users — Emit new event each time a new user is added. (https://pipedream.com/apps/intercom/triggers/new-user)
- trigger : Lead Added Email — Emit new event each time a lead adds their email address. (https://pipedream.com/apps/intercom/triggers/lead-added-email)
- trigger : New Closed Conversation — Emit new event each time a conversation is closed. (https://pipedream.com/apps/intercom/triggers/conversation-closed)
- trigger : New Conversation Rating Added — Emit new event each time a new rating is added to a conversation. (https://pipedream.com/apps/intercom/triggers/new-conversation-rating-added)
- trigger : New Event — Emit new event for each new Intercom event for a user. (https://pipedream.com/apps/intercom/triggers/new-event)
- trigger : New Leads — Emit new event each time a new lead is added. (https://pipedream.com/apps/intercom/triggers/new-lead)
- trigger : New Tickets — Emit new event when a new ticket is created in Intercom. (https://pipedream.com/apps/intercom/triggers/new-ticket)
- trigger : New Topic (Instant) — Emit new event for each new topic that you subscribed in your webhook. See more here. (https://pipedream.com/apps/intercom/triggers/new-topic)
- trigger : Tag Added To Conversation — Emit new event each time a new tag is added to a conversation. (https://pipedream.com/apps/intercom/triggers/tag-added-to-conversation)
- trigger : Tag Added To Lead — Emit new event each time a new tag is added to a lead. (https://pipedream.com/apps/intercom/triggers/tag-added-to-lead)
- trigger : Tag Added To User — Emit new event each time a new tag is added to a user. (https://pipedream.com/apps/intercom/triggers/tag-added-to-user)