Intercom est une plateforme de communication client de premier plan qui vous permet de gérer et d'automatiser vos interactions avec les contacts, les entreprises, les conversations, les tickets et les messages, le tout en un seul endroit. L'intégration d'Intercom dans Sim permet à vos agents de gérer par programmation les relations clients, les demandes d'assistance et les conversations directement à partir de vos flux de travail automatisés.
Avec les outils Intercom, vous pouvez :
- Gestion des contacts : créer, obtenir, mettre à jour, lister, rechercher et supprimer des contacts — automatisez vos processus de CRM et gardez vos dossiers clients à jour.
- Gestion des entreprises : créer de nouvelles entreprises, récupérer les détails d'une entreprise et lister toutes les entreprises liées à vos utilisateurs ou clients professionnels.
- Gestion des conversations : obtenir, lister, répondre et rechercher dans les conversations — permettant aux agents de suivre les fils de support en cours, de fournir des réponses et d'automatiser les actions de suivi.
- Gestion des tickets : créer et récupérer des tickets par programmation, vous aidant à automatiser le service client, le suivi des problèmes d'assistance et les escalades de flux de travail.
- Envoi de messages : déclencher des messages aux utilisateurs ou prospects pour l'intégration, le support ou le marketing, le tout depuis votre automatisation de flux de travail.
En intégrant les outils Intercom dans Sim, vous permettez à vos flux de travail de communiquer directement avec vos utilisateurs, d'automatiser les processus d'assistance client, de gérer les prospects et de rationaliser les communications à grande échelle. Que vous ayez besoin de créer de nouveaux contacts, de synchroniser les données clients, de gérer les tickets d'assistance ou d'envoyer des messages d'engagement personnalisés, les outils Intercom offrent un moyen complet de gérer les interactions client dans le cadre de vos automatisations intelligentes.
Intégrez Intercom dans le flux de travail. Peut créer, obtenir, mettre à jour, lister, rechercher et supprimer des contacts ; créer, obtenir et lister des entreprises ; obtenir, lister, répondre et rechercher des conversations ; créer et obtenir des tickets ; et créer des messages.
Créer un nouveau contact dans Intercom avec email, external_id ou role
| Paramètre | Type | Obligatoire | Description |
|---|
role | string | Non | Le rôle du contact. Accepte « user » ou « lead ». Par défaut « lead » si non spécifié. |
email | string | Non | L'adresse e-mail du contact |
external_id | string | Non | Un identifiant unique pour le contact fourni par le client |
phone | string | Non | Le numéro de téléphone du contact |
name | string | Non | Le nom du contact |
avatar | string | Non | Une URL d'image d'avatar pour le contact |
signed_up_at | number | Non | L'heure d'inscription de l'utilisateur sous forme d'horodatage Unix |
last_seen_at | number | Non | L'heure de dernière activité de l'utilisateur sous forme d'horodatage Unix |
owner_id | string | Non | L'identifiant d'un administrateur auquel la propriété du compte du contact a été attribuée |
unsubscribed_from_emails | boolean | Non | Indique si le contact s'est désabonné des e-mails |
custom_attributes | string | Non | Attributs personnalisés sous forme d'objet JSON (par ex., {"nom_attribut": "valeur"}) |
company_id | string | Non | Identifiant de l'entreprise à associer au contact lors de la création |
| Paramètre | Type | Description |
|---|
contact | object | Objet contact créé |
Obtenir un seul contact par ID depuis Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
contactId | string | Oui | ID du contact à récupérer |
| Paramètre | Type | Description |
|---|
contact | object | Objet contact |
Mettre à jour un contact existant dans Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
contactId | string | Oui | Identifiant du contact à mettre à jour |
role | string | Non | Le rôle du contact. Accepte « user » ou « lead ». |
external_id | string | Non | Un identifiant unique pour le contact fourni par le client |
email | string | Non | L'adresse e-mail du contact |
phone | string | Non | Le numéro de téléphone du contact |
name | string | Non | Le nom du contact |
avatar | string | Non | Une URL d'image d'avatar pour le contact |
signed_up_at | number | Non | L'heure d'inscription de l'utilisateur sous forme d'horodatage Unix |
last_seen_at | number | Non | L'heure de dernière activité de l'utilisateur sous forme d'horodatage Unix |
owner_id | string | Non | L'identifiant d'un administrateur auquel la propriété du compte du contact a été attribuée |
unsubscribed_from_emails | boolean | Non | Indique si le contact s'est désabonné des e-mails |
custom_attributes | string | Non | Attributs personnalisés sous forme d'objet JSON (par ex., {"nom_attribut": "valeur"}) |
company_id | string | Non | Identifiant de l'entreprise à associer au contact |
| Paramètre | Type | Description |
|---|
contact | object | Objet contact mis à jour |
Lister tous les contacts d'Intercom avec prise en charge de la pagination
| Paramètre | Type | Obligatoire | Description |
|---|
per_page | nombre | Non | Nombre de résultats par page (max : 150) |
starting_after | chaîne | Non | Curseur pour la pagination - ID pour commencer après |
| Paramètre | Type | Description |
|---|
contacts | array | Tableau d'objets contact |
Rechercher des contacts dans Intercom à l'aide d'une requête
| Paramètre | Type | Obligatoire | Description |
|---|
query | string | Oui | Requête de recherche (par ex., {"field":"email","operator":"=","value":"user@example.com"}) |
per_page | number | Non | Nombre de résultats par page (max : 150) |
starting_after | string | Non | Curseur pour la pagination |
sort_field | string | Non | Champ de tri (par ex., "name", "created_at", "last_seen_at") |
sort_order | string | Non | Ordre de tri : "ascending" ou "descending" |
| Paramètre | Type | Description |
|---|
contacts | array | Tableau d'objets contact correspondants |
Supprimer un contact d'Intercom par ID
| Paramètre | Type | Obligatoire | Description |
|---|
contactId | chaîne | Oui | ID du contact à supprimer |
| Paramètre | Type | Description |
|---|
id | string | ID du contact supprimé |
deleted | boolean | Indique si le contact a été supprimé |
metadata | object | Métadonnées de l'opération |
Créer ou mettre à jour une entreprise dans Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
company_id | string | Oui | Votre identifiant unique pour l'entreprise |
name | string | Non | Le nom de l'entreprise |
website | string | Non | Le site web de l'entreprise |
plan | string | Non | Le nom du plan de l'entreprise |
size | number | Non | Le nombre d'employés dans l'entreprise |
industry | string | Non | Le secteur d'activité de l'entreprise |
monthly_spend | number | Non | Le chiffre d'affaires que l'entreprise génère pour votre activité. Remarque : ce champ tronque les nombres décimaux en entiers (par ex., 155,98 devient 155) |
custom_attributes | string | Non | Attributs personnalisés sous forme d'objet JSON |
remote_created_at | number | Non | La date de création de l'entreprise par vous sous forme d'horodatage Unix |
| Paramètre | Type | Description |
|---|
company | object | Objet entreprise créé ou mis à jour |
Récupérer une seule entreprise par ID depuis Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
companyId | chaîne | Oui | ID de l'entreprise à récupérer |
| Paramètre | Type | Description |
|---|
company | object | Objet entreprise |
Liste toutes les entreprises d'Intercom avec prise en charge de la pagination. Remarque : cet endpoint a une limite de 10 000 entreprises qui peuvent être renvoyées en utilisant la pagination. Pour les ensembles de données de plus de 10 000 entreprises, utilisez plutôt l'API Scroll.
| Paramètre | Type | Obligatoire | Description |
|---|
per_page | number | Non | Nombre de résultats par page |
page | number | Non | Numéro de page |
starting_after | string | Non | Curseur pour la pagination (préféré à la pagination par page) |
| Paramètre | Type | Description |
|---|
companies | array | Tableau d'objets entreprise |
Récupérer une seule conversation par ID depuis Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
conversationId | string | Oui | ID de la conversation à récupérer |
display_as | string | Non | Définir sur "plaintext" pour récupérer les messages en texte brut |
include_translations | boolean | Non | Lorsque true, les parties de la conversation seront traduites dans la langue détectée de la conversation |
| Paramètre | Type | Description |
|---|
conversation | object | Objet conversation |
Lister toutes les conversations depuis Intercom avec prise en charge de la pagination
| Paramètre | Type | Obligatoire | Description |
|---|
per_page | number | Non | Nombre de résultats par page (max : 150) |
starting_after | string | Non | Curseur pour la pagination |
sort | string | Non | Champ de tri (ex., "waiting_since", "updated_at", "created_at") |
order | string | Non | Ordre de tri : "asc" (croissant) ou "desc" (décroissant) |
| Paramètre | Type | Description |
|---|
conversations | array | Tableau d'objets conversation |
Répondre à une conversation en tant qu'administrateur dans Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
conversationId | string | Oui | ID de la conversation à laquelle répondre |
message_type | string | Oui | Type de message : "comment" ou "note" |
body | string | Oui | Corps du texte de la réponse |
admin_id | string | Non | ID de l'administrateur qui rédige la réponse. Si non fourni, un administrateur par défaut (Operator/Fin) sera utilisé. |
attachment_urls | string | Non | Liste d'URL d'images séparées par des virgules (max 10) |
created_at | number | Non | Horodatage Unix du moment où la réponse a été créée. Si non fourni, l'heure actuelle est utilisée. |
| Paramètre | Type | Description |
|---|
conversation | object | Objet conversation mis à jour |
Rechercher des conversations dans Intercom à l'aide d'une requête
| Paramètre | Type | Obligatoire | Description |
|---|
query | string | Oui | Requête de recherche sous forme d'objet JSON |
per_page | number | Non | Nombre de résultats par page (max : 150) |
starting_after | string | Non | Curseur pour la pagination |
sort_field | string | Non | Champ de tri (par exemple, "created_at", "updated_at") |
sort_order | string | Non | Ordre de tri : "ascending" ou "descending" |
| Paramètre | Type | Description |
|---|
conversations | array | Tableau d'objets conversation correspondants |
Créer un nouveau ticket dans Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
ticket_type_id | string | Oui | L'ID du type de ticket |
contacts | string | Oui | Tableau JSON d'identifiants de contacts (par exemple, [{"id": "contact_id"}]) |
ticket_attributes | string | Oui | Objet JSON avec les attributs du ticket incluant default_title et default_description |
company_id | string | Non | ID de l'entreprise à associer au ticket |
created_at | number | Non | Horodatage Unix du moment où le ticket a été créé. Si non fourni, l'heure actuelle est utilisée. |
conversation_to_link_id | string | Non | ID d'une conversation existante à lier à ce ticket |
disable_notifications | boolean | Non | Lorsque défini sur true, supprime les notifications lors de la création du ticket |
| Paramètre | Type | Description |
|---|
ticket | object | Objet ticket créé |
Récupérer un ticket unique par ID depuis Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
ticketId | string | Oui | ID du ticket à récupérer |
| Paramètre | Type | Description |
|---|
ticket | object | Objet ticket |
Créer et envoyer un nouveau message initié par l'administrateur dans Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
message_type | string | Oui | Type de message : "inapp" pour les messages in-app ou "email" pour les messages e-mail |
template | string | Oui | Style du modèle de message : "plain" pour texte brut ou "personal" pour style personnalisé |
subject | string | Non | Le sujet du message (pour le type e-mail) |
body | string | Oui | Le corps du message |
from_type | string | Oui | Type d'expéditeur : "admin" |
from_id | string | Oui | L'ID de l'administrateur qui envoie le message |
to_type | string | Oui | Type de destinataire : "contact" |
to_id | string | Oui | L'ID du contact qui reçoit le message |
created_at | number | Non | Horodatage Unix du moment où le message a été créé. Si non fourni, l'heure actuelle est utilisée. |
| Paramètre | Type | Description |
|---|
message | object | Objet message créé |
- Catégorie :
tools
- Type :
intercom
Créer et envoyer un nouveau message initié par un administrateur dans Intercom. Renvoie uniquement les champs alignés sur l'API.
| Paramètre | Type | Obligatoire | Description |
|---|
message_type | string | Oui | Type de message : « inapp » pour les messages in-app ou « email » pour les messages e-mail |
template | string | Oui | Style du modèle de message : « plain » pour texte brut ou « personal » pour style personnalisé |
subject | string | Non | L'objet du message (pour le type e-mail) |
body | string | Oui | Le corps du message |
from_type | string | Oui | Type d'expéditeur : « admin » |
from_id | string | Oui | L'identifiant de l'administrateur envoyant le message |
to_type | string | Oui | Type de destinataire : « contact » |
to_id | string | Oui | L'identifiant du contact recevant le message |
created_at | number | Non | Horodatage Unix indiquant quand le message a été créé. Si non fourni, l'heure actuelle est utilisée. |
| Paramètre | Type | Description |
|---|
message | object | Objet message créé |
↳ id | string | Identifiant unique du message |
↳ type | string | Type d'objet (message) |
↳ created_at | number | Horodatage Unix de création du message |
↳ body | string | Corps du message |
↳ message_type | string | Type du message (in_app ou email) |
↳ conversation_id | string | Identifiant de la conversation créée |
↳ owner | object | Propriétaire du message |
messageId | string | Identifiant du message créé |
success | boolean | Statut de réussite de l'opération |
Récupérer une liste de tous les administrateurs de l'espace de travail
| Paramètre | Type | Obligatoire | Description |
|---|
| Paramètre | Type | Description |
|---|
admins | array | Tableau d'objets administrateur |
↳ id | string | Identifiant unique de l'administrateur |
↳ type | string | Type d'objet (admin) |
↳ name | string | Nom de l'administrateur |
↳ email | string | E-mail de l'administrateur |
↳ job_title | string | Titre du poste de l'administrateur |
↳ away_mode_enabled | boolean | Indique si l'administrateur est en mode absent |
↳ away_mode_reassign | boolean | Indique s'il faut réattribuer les conversations en cas d'absence |
↳ has_inbox_seat | boolean | Indique si l'administrateur dispose d'un siège de boîte de réception payant |
↳ team_ids | array | Liste des ID d'équipe auxquelles appartient l'administrateur |
↳ avatar | object | Informations sur l'avatar |
↳ email_verified | boolean | Indique si l'e-mail est vérifié |
type | string | Type d'objet (admin.list) |
Fermer une conversation dans Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
conversationId | string | Oui | L'ID de la conversation à fermer |
admin_id | string | Oui | L'ID de l'administrateur effectuant l'action |
body | string | Non | Message de clôture optionnel à ajouter à la conversation |
| Paramètre | Type | Description |
|---|
conversation | object | L'objet conversation fermée |
↳ id | string | Identifiant unique de la conversation |
↳ type | string | Type d'objet (conversation) |
↳ state | string | État de la conversation (fermée) |
↳ open | boolean | Indique si la conversation est ouverte (false) |
↳ read | boolean | Indique si la conversation a été lue |
↳ created_at | number | Horodatage Unix de création de la conversation |
↳ updated_at | number | Horodatage Unix de dernière mise à jour de la conversation |
conversationId | string | ID de la conversation fermée |
state | string | État de la conversation (fermée) |
Ouvrir une conversation fermée ou en veille dans Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
conversationId | string | Oui | L'ID de la conversation à ouvrir |
admin_id | string | Oui | L'ID de l'administrateur effectuant l'action |
| Paramètre | Type | Description |
|---|
conversation | object | L'objet conversation ouverte |
↳ id | string | Identifiant unique de la conversation |
↳ type | string | Type d'objet (conversation) |
↳ state | string | État de la conversation (ouverte) |
↳ open | boolean | Indique si la conversation est ouverte (true) |
↳ read | boolean | Indique si la conversation a été lue |
↳ created_at | number | Horodatage Unix de création de la conversation |
↳ updated_at | number | Horodatage Unix de dernière mise à jour de la conversation |
conversationId | string | ID de la conversation ouverte |
state | string | État de la conversation (ouverte) |
Mettre en veille une conversation pour la rouvrir ultérieurement
| Paramètre | Type | Obligatoire | Description |
|---|
conversationId | string | Oui | L'ID de la conversation à mettre en veille |
admin_id | string | Oui | L'ID de l'administrateur effectuant l'action |
snoozed_until | number | Oui | Horodatage Unix indiquant quand la conversation doit se rouvrir |
| Paramètre | Type | Description |
|---|
conversation | object | L'objet conversation mise en veille |
↳ id | string | Identifiant unique de la conversation |
↳ type | string | Type d'objet (conversation) |
↳ state | string | État de la conversation (snoozed) |
↳ open | boolean | Indique si la conversation est ouverte |
↳ snoozed_until | number | Horodatage Unix indiquant quand la conversation se rouvrira |
↳ created_at | number | Horodatage Unix de création de la conversation |
↳ updated_at | number | Horodatage Unix de dernière mise à jour de la conversation |
conversationId | string | ID de la conversation mise en veille |
state | string | État de la conversation (snoozed) |
snoozed_until | number | Horodatage Unix indiquant quand la conversation se rouvrira |
Attribuer une conversation à un administrateur ou une équipe dans Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
conversationId | string | Oui | L'ID de la conversation à attribuer |
admin_id | string | Oui | L'ID de l'administrateur effectuant l'attribution |
assignee_id | string | Oui | L'ID de l'administrateur ou de l'équipe à qui attribuer la conversation. Définir sur « 0 » pour désattribuer. |
body | string | Non | Message optionnel à ajouter lors de l'attribution (par ex., « Transmission à l'équipe support ») |
| Paramètre | Type | Description |
|---|
conversation | object | L'objet conversation assigné |
↳ id | string | Identifiant unique de la conversation |
↳ type | string | Type d'objet (conversation) |
↳ state | string | État de la conversation |
↳ open | boolean | Indique si la conversation est ouverte |
↳ admin_assignee_id | number | ID de l'administrateur assigné |
↳ team_assignee_id | string | ID de l'équipe assignée |
↳ created_at | number | Horodatage Unix de création de la conversation |
↳ updated_at | number | Horodatage Unix de dernière mise à jour de la conversation |
conversationId | string | ID de la conversation assignée |
admin_assignee_id | number | ID de l'administrateur assigné |
team_assignee_id | string | ID de l'équipe assignée |
Récupérer une liste de tous les tags dans l'espace de travail
| Paramètre | Type | Obligatoire | Description |
|---|
| Paramètre | Type | Description |
|---|
tags | array | Tableau d'objets tag |
↳ id | string | Identifiant unique du tag |
↳ type | string | Type d'objet (tag) |
↳ name | string | Nom du tag |
type | string | Type d'objet (list) |
Créer une nouvelle étiquette ou mettre à jour le nom d'une étiquette existante
| Paramètre | Type | Obligatoire | Description |
|---|
name | string | Oui | Le nom de l'étiquette. Créera une nouvelle étiquette si elle n'est pas trouvée, ou mettra à jour le nom si l'id est fourni. |
id | string | Non | L'ID d'une étiquette existante à mettre à jour. Omettre pour créer une nouvelle étiquette. |
| Paramètre | Type | Description |
|---|
id | string | Identifiant unique de l'étiquette |
name | string | Nom de l'étiquette |
type | string | Type d'objet (tag) |
Ajouter une étiquette à un contact spécifique
| Paramètre | Type | Obligatoire | Description |
|---|
contactId | string | Oui | L'ID du contact à étiqueter |
tagId | string | Oui | L'ID de l'étiquette à appliquer |
| Paramètre | Type | Description |
|---|
id | string | Identifiant unique de l'étiquette |
name | string | Nom de l'étiquette |
type | string | Type d'objet (tag) |
Retirer une étiquette d'un contact spécifique
| Paramètre | Type | Obligatoire | Description |
|---|
contactId | string | Oui | L'ID du contact dont retirer l'étiquette |
tagId | string | Oui | L'ID de l'étiquette à retirer |
| Paramètre | Type | Description |
|---|
id | string | Identifiant unique du tag qui a été supprimé |
name | string | Nom du tag qui a été supprimé |
type | string | Type d'objet (tag) |
Ajouter un tag à une conversation spécifique
| Paramètre | Type | Obligatoire | Description |
|---|
conversationId | string | Oui | L'ID de la conversation à taguer |
tagId | string | Oui | L'ID du tag à appliquer |
admin_id | string | Oui | L'ID de l'administrateur appliquant le tag |
| Paramètre | Type | Description |
|---|
id | string | Identifiant unique du tag |
name | string | Nom du tag |
type | string | Type d'objet (tag) |
Ajouter une note à un contact spécifique
| Paramètre | Type | Obligatoire | Description |
|---|
contactId | string | Oui | L'ID du contact auquel ajouter la note |
body | string | Oui | Le contenu textuel de la note |
admin_id | string | Non | L'ID de l'administrateur créant la note |
| Paramètre | Type | Description |
|---|
id | string | Identifiant unique de la note |
body | string | Le contenu texte de la note |
created_at | number | Horodatage Unix de création de la note |
type | string | Type d'objet (note) |
author | object | L'administrateur qui a créé la note |
↳ type | string | Type d'auteur (admin) |
↳ id | string | ID de l'auteur |
↳ name | string | Nom de l'auteur |
↳ email | string | E-mail de l'auteur |
contact | object | Le contact pour lequel la note a été créée |
↳ type | string | Type de contact |
↳ id | string | ID du contact |
Suivre un événement personnalisé pour un contact dans Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
event_name | string | Oui | Le nom de l'événement (par ex., « commande-terminée »). Utilisez le format verbe-nom au passé pour une meilleure lisibilité. |
created_at | number | Non | Horodatage Unix du moment où l'événement s'est produit. Fortement recommandé pour l'unicité. |
user_id | string | Non | Votre identifiant pour l'utilisateur (external_id) |
email | string | Non | Adresse e-mail de l'utilisateur. À utiliser uniquement si votre application utilise l'e-mail pour identifier de manière unique les utilisateurs. |
id | string | Non | L'ID de contact Intercom |
metadata | string | Non | Objet JSON avec jusqu'à 10 paires clé-valeur de métadonnées sur l'événement (par ex., {"valeur_commande": 99.99}) |
| Paramètre | Type | Description |
|---|
accepted | boolean | Indique si l'événement a été accepté (202 Accepted) |
Associer un contact à une entreprise dans Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
contactId | string | Oui | L'identifiant du contact à associer à l'entreprise |
companyId | string | Oui | L'identifiant de l'entreprise à laquelle associer le contact |
| Paramètre | Type | Description |
|---|
company | object | L'objet entreprise auquel le contact a été associé |
↳ id | string | Identifiant unique de l'entreprise |
↳ type | string | Type d'objet (company) |
↳ company_id | string | Le company_id que vous avez défini |
↳ name | string | Nom de l'entreprise |
↳ created_at | number | Horodatage Unix de création de l'entreprise |
↳ updated_at | number | Horodatage Unix de mise à jour de l'entreprise |
↳ user_count | number | Nombre d'utilisateurs dans l'entreprise |
↳ session_count | number | Nombre de sessions |
↳ monthly_spend | number | Montant des dépenses mensuelles |
↳ plan | object | Détails du plan de l'entreprise |
companyId | string | Identifiant de l'entreprise |
name | string | Nom de l'entreprise |
Retirer un contact d'une entreprise dans Intercom
| Paramètre | Type | Obligatoire | Description |
|---|
contactId | string | Oui | L'ID du contact à détacher de l'entreprise |
companyId | string | Oui | L'ID de l'entreprise dont détacher le contact |
| Paramètre | Type | Description |
|---|
company | object | L'objet entreprise dont le contact a été détaché |
↳ id | string | Identifiant unique de l'entreprise |
↳ type | string | Type d'objet (company) |
↳ company_id | string | Le company_id que vous avez défini |
↳ name | string | Nom de l'entreprise |
companyId | string | ID de l'entreprise |
name | string | Nom de l'entreprise |