Voici les réponses aux questions fréquemment posées concernant :

Vous pouvez créer un nouvel espace de travail développeur pour développer des applications. Les espaces de travail développeur sont gratuits et destinés uniquement au développement. Une fois l’espace créé, vous pouvez suivre ce guide pour créer une application et effectuer votre premier appel API.

Vous pouvez créer une nouvelle application pour votre espace de travail de production et obtenir le jeton d’accès en vous rendant sur https://app.intercom.com/a/apps/{your-workspace-id}/developer-hub/

Lorsque vous activez votre Articles Help Center, votre contenu est disponible par défaut via intercom.help. Votre URL ressemblera à ceci : intercom.help/exampleapp.

Si vous souhaitez utiliser une URL différente, vous pouvez en créer une en configurant manuellement un domaine personnalisé. Cela implique d’entrer le domaine personnalisé dans les paramètres de votre Help Center, de créer un enregistrement CNAME personnalisé et, éventuellement, de configurer le SSL. Retrouvez les instructions complètes dans notre documentation développeur.

Le SSL (ou TLS) est la méthode la plus utilisée pour sécuriser la connexion entre votre serveur et votre navigateur. Il garantit que la connexion est chiffrée et sécurisée, et apparaît sous la forme HTTPS.

Il existe deux façons de configurer le SSL avec Articles sur votre domaine personnalisé :

Oui ! Si vous activez « HTTPS (quick setup) » dans les paramètres de votre Help Center, Intercom provisionnera et gérera automatiquement un certificat SSL pour votre domaine personnalisé (comme https://help.ourdomain.com). Il n’est pas nécessaire de configurer manuellement le SSL — il suffit de pointer votre CNAME vers us.intercomhelpcenter.com, et nous nous occupons du reste.

Si vous souhaitez passer votre domaine personnalisé en HTTPS :

Vous pouvez configurer le SSL pour votre domaine personnalisé afin de garder les informations sensibles chiffrées. Si vous souhaitez le faire, assurez-vous d’avoir configuré votre CNAME avec un fournisseur DNS qui supporte le SSL, comme Cloudflare.

Suivez le guide dans notre documentation développeur pour configurer le SSL. Notez que selon le fournisseur choisi, les étapes peuvent varier.

1. Domaine non sécurisé

La version actuelle de l'API est 2.15. Vous pouvez trouver la documentation de l'API sur notre site de documentation pour développeurs. Vous pouvez aussi changer la version utilisée par votre application dans votre Developer Hub en suivant les étapes indiquées dans ce guide.

Si vous utilisez l'API Intercom, vous pouvez aussi changer la version dans l'en-tête HTTP de votre requête.

Les endpoints suivants sont disponibles dans la version 2.15 de l'API Intercom :

Oui, si vous souhaitez déclencher un article dans le Messenger, vous pouvez utiliser la méthode showArticle de l'API JavaScript. L'article s'ouvrira dans le Messenger et cliquer sur le bouton retour du Messenger reviendra au contexte précédent. Si le Messenger est fermé lors de l'appel de la méthode, il s'ouvrira d'abord puis l'article sera affiché. Ceci est disponible sur toutes les plateformes dans le Messenger.

Dans Intercom, les users sont considérés comme des contacts. Il n'existe pas de endpoint pour créer des contacts en masse via l'API, mais vous pouvez utiliser le endpoint de création de contacts pour créer un script qui importe des users ou suivre ce tutoriel qui vous fournira des exemples de code pour commencer.

Assurez-vous de mettre en place un contrôle de limitation de débit pour éviter d'atteindre la limite, qui est actuellement de 10 000 appels API par minute pour chaque application et 25 000 appels API par minute par workspace.

Pour récupérer les données d'un contact archivé, vous devez d'abord désarchiver le contact, ce que vous pouvez faire avec le endpoint API de désarchivage de contact si vous avez l'ID du contact.

Vous pourrez alors accéder aux données du contact via le endpoint API d'obtention d'un contact et à leurs conversations via le endpoint API de récupération d'une conversation.

Non, il n'est actuellement pas possible de supprimer des notes individuelles ou en masse sur les contacts via l'API. Si cette fonctionnalité est importante pour vos opérations, veuillez visiter la liste de souhaits produit pour créer, commenter ou voter pour une demande de fonctionnalité. Les notes peuvent être supprimées manuellement dans l'espace de travail, mais une par une.

Si vous souhaitez assigner une conversation à une équipe en utilisant l'API, vous avez deux options.

La première option est d'assigner une conversation directement à un administrateur ou à une équipe en utilisant le point de terminaison API gérer une conversation. Vous devez avoir accès à l'identifiant provisionné Intercom de la conversation ainsi qu'à l'admin_id et à l'assignee_id.

L'autre option est d'exécuter des règles d'assignation que vous avez déjà configurées sur la conversation en utilisant le point de terminaison API exécuter des règles d'assignation sur une conversation. Vous devez avoir accès à l'identifiant provisionné Intercom de la conversation.

Vous pouvez tester la fonctionnalité depuis la fonction "Try It" dans notre documentation pour développeurs, la collection Postman Intercom, ou dans votre propre terminal ou IDE. N'oubliez pas d'utiliser votre jeton d'accès Intercom comme jeton bearer.

Une note est un commentaire interne visible uniquement par les coéquipiers. Pour ajouter une note à une conversation, vous pouvez utiliser le point de terminaison API répondre à une conversation. Vous devrez choisir un message_type de note et un type "admin" ainsi que l'admin_id d'où la note doit provenir.

Vous pouvez tester la fonctionnalité depuis la fonction "Try It" dans notre documentation pour développeurs, la collection Postman Intercom, ou dans votre propre terminal ou IDE. N'oubliez pas d'utiliser votre jeton d'accès Intercom comme jeton bearer.

Si vous avez déjà créé un tag dans l'interface utilisateur, vous pouvez utiliser ce tag pour l'appliquer aux conversations. Vous pouvez aussi créer un nouveau tag en utilisant l'API.

Pour utiliser le point de terminaison API ajouter un tag à une conversation, vous devrez avoir accès au conversation_id de la conversation à taguer, à l'identifiant provisionné Intercom du tag et à l'admin_id.

Vous pouvez tester la fonctionnalité depuis la fonction "Try It" dans notre documentation pour développeurs, la collection Postman Intercom, ou dans votre propre terminal ou IDE. N'oubliez pas d'utiliser votre jeton d'accès Intercom comme jeton bearer.

Vous pouvez créer une conversation depuis l'API qui a été initiée par un contact (c'est-à-dire un user ou lead) en utilisant le point de terminaison API créer une conversation. La conversation peut être uniquement un message in-app.

Vous aurez également besoin de l'identifiant provisionné Intercom pour le contact et du texte du corps. Utilisez-le pour démarrer la conversation.

Vous pouvez tester la fonctionnalité depuis la fonction "Try It" dans notre documentation pour développeurs, la collection Postman Intercom, ou dans votre propre terminal ou IDE. N'oubliez pas d'utiliser votre jeton d'accès Intercom comme jeton bearer.

Pour fermer une conversation en utilisant l'API, vous pouvez utiliser le point de terminaison API gérer une conversation. Vous devrez avoir l'identifiant provisionné Intercom de la conversation, votre admin_id et utiliser un message_type de "close".

Si vous devez expurger seulement une certaine partie de la conversation, utilisez le point de terminaison API expurger une partie de conversation.

Vous pouvez tester la fonctionnalité depuis la fonction "Try It" dans notre documentation pour développeurs, la collection Postman Intercom, ou dans votre propre terminal ou IDE. N'oubliez pas d'utiliser votre jeton d'accès Intercom comme jeton bearer.

Pour configurer une notification personnalisée lorsqu'une action est effectuée, comme l'assignation d'un coéquipier à une conversation, vous pouvez utiliser les webhooks.

Vous devrez utiliser le sujet de conversation conversation.admin.assigned. Vous pouvez trouver tous les sujets de conversation dans notre documentation pour développeurs.

Vous pouvez ensuite vous abonner à ce sujet webhook dans le hub développeur en suivant les étapes de ce guide. Vous devrez également disposer d'une URL de point de terminaison accessible publiquement pour que l'action soit effectuée une fois que le webhook est déclenché afin de livrer la notification à votre canal préféré.

Les side conversations n'ont pas leur propre point de terminaison dédié, vous ne pouvez donc pas les récupérer directement. Cependant, lorsque vous récupérez une conversation à laquelle la side conversation est attachée, vous verrez des parties de conversation qui apparaissent comme "part_type": "side_conversation_reply" avec le contenu des messages de l'user dans la side conversation.

Pour créer un ticket en utilisant l'API Intercom, vous devez d'abord créer ou obtenir le type de ticket pour étiqueter le nouveau ticket. Ensuite, vous pouvez créer le ticket en utilisant une requête curl ou avec un langage de programmation de votre choix.

Suivez ce guide dans notre documentation pour développeurs pour créer un type de ticket et créer un nouveau ticket.

Si vous utilisez l'API pour récupérer des tickets et des données de ticket, vous pouvez utiliser le point de terminaison API rechercher des tickets. Pour exclure les types de tickets back office, définissez le champ sur ticket_type_id et utilisez l'opérateur != pour exclure le ticket_type_id attribué aux types de tickets back office.

Si vous utilisez l'API pour récupérer une conversation ou lister des conversations avec des tickets back office associés aux conversations et que vous souhaitez les exclure, vous pouvez de même filtrer tous les résultats qui ont le type de ticket back office comme attribut. Les tickets liés peuvent être trouvés dans le paramètre tickets de la réponse ou sous linked_objects.

Une autre option disponible est d'utiliser l'API pour taguer des conversations avec un ticket back office associé. Vous pouvez ensuite utiliser le tag pour filtrer par catégorie de ticket.

Si vous recevez un message 403 API Plan restricted dans une réponse, cela signifie que l'API que vous essayez d'utiliser n'est pas disponible dans le plan de votre application.

Pour accéder à l'API, vous devrez mettre à niveau votre plan. Vous pouvez en savoir plus sur les plans Intercom sur cette page. Vous pouvez trouver une liste complète des codes d'erreur et des réponses HTTP dans notre documentation pour développeurs.

Si vous recevez un message 409 conflict dans une réponse, cela signifie qu'il existe des données dans votre espace de travail Intercom qui entrent en conflit avec les données de la requête. Cela peut se produire si vous essayez de créer un contact et qu'un contact avec cette adresse e-mail est déjà ajouté dans votre application.

Pour éviter cette erreur, vous pouvez utiliser le point de terminaison de mise à jour ou créer un nouveau contact par user_id. Vous pouvez trouver une liste complète des codes d'erreur et des réponses HTTP dans notre documentation pour développeurs.

Si vous recevez un message 429, cela signifie que le client a atteint ou dépassé une limite de taux, ou que le serveur est surchargé. Chaque application a une limite de taux par défaut de 10 000 appels API par minute pour chaque application et 25 000 appels API par minute par espace de travail. Plus d'informations sur les limites de taux sont disponibles dans notre documentation pour développeurs.

Pour éviter cette erreur, vous pouvez configurer un contrôle de limitation de taux pour vous assurer de ne pas atteindre la limite. Vous pouvez trouver une liste complète des codes d'erreur et des réponses HTTP dans notre documentation pour développeurs.

Les applications privées ont une limite de taux par défaut de 10 000 appels API par minute par application et 25 000 appels API par minute par espace de travail. Cela signifie que si un espace de travail a plusieurs applications privées installées, chacune contribue au nombre total de requêtes.

Les applications publiques ont une limite de taux par défaut de 10 000 appels API par minute pour chaque application et 25 000 appels API par minute par espace de travail. Cela signifie que si un espace de travail a plusieurs applications publiques installées, chacune a sa propre limite de requêtes sans contribuer aux autres. Plus d'informations sur les limites de taux sont disponibles dans notre documentation pour développeurs.

Si vous créez vos propres rapports en utilisant l'API, vous pouvez remarquer certaines différences entre les deux rapports. Cela peut arriver pour plusieurs raisons.

Un problème courant est lorsque les dates et heures ne correspondent pas. Cela est souvent dû au fait que le fuseau horaire que vous utilisez dans votre espace de travail Intercom est différent du fuseau horaire que vous utilisez pour interroger l'API. Pour corriger cela, ajustez soit vos paramètres de requête API pour correspondre au fuseau horaire de votre espace de travail, soit changez le fuseau horaire de votre rapport personnalisé.

Un autre problème est que vous pouvez utiliser des métriques qui ne correspondent pas aux métriques de l'interface de reporting Intercom. Certaines métriques disponibles dans l'interface de reporting ne sont pas accessibles via l'API car ce sont des métriques calculées. Certaines peuvent être créées en utilisant l'API et en effectuant les calculs de votre côté. Consultez le guide pour créer vos propres rapports dans la documentation développeur d'Intercom.

Si vous consultez les rapports de conversations disponibles dans l'interface utilisateur par rapport aux rapports extraits via l'API conversations, vous remarquerez peut-être une différence dans le nombre de conversations. Cela s'explique par le fait que les tickets back office associés à une conversation sont inclus lorsqu'ils sont extraits via l'API.

Pour résoudre ce problème, vous pouvez filtrer les résultats après les avoir récupérés via les API list conversations, retrieve a conversation ou search for conversations, et séparer les tickets des conversations en utilisant le champ ticket dans la réponse de l'API conversation. Le champ ticket sera rempli avec un objet s'il s'agit d'un ticket et sera nul s'il s'agit d'une conversation.

Les webhooks vous permettent de vous abonner à des notifications en temps réel des événements se produisant dans Intercom, comme lorsqu'un contact est créé ou qu'un message entrant est reçu.

Vous pouvez voir les webhooks disponibles pour chaque version dans notre documentation développeur. Une fois que vous avez identifié le webhook dont vous avez besoin, suivez ce guide pour les configurer.

Il n'y a pas de plans pour ajouter de nouveaux webhooks dans notre feuille de route, mais si votre équipe a besoin d'un webhook, veuillez soumettre une demande à l'équipe ou l'ajouter à la liste de souhaits produit dans la communauté Intercom.

Les API Intercom pour lister et chercher des ressources offrent une pagination basée sur un curseur. Cela permet, lorsque vous demandez une grande quantité de données — comme de nombreuses conversations avec toutes leurs parties — de les recevoir et de les traiter en plus petits morceaux.

Pour des exemples d'utilisation de la pagination avec les API de liste Intercom, qui acceptent des paramètres de chemin, et les API de recherche, qui utilisent des paramètres de requête, consultez notre guide de pagination.

Pour la pagination basée sur un curseur, Intercom utilise un pointeur qui fait référence à un enregistrement spécifique en fonction de la limite que vous définissez par le nombre de pages que vous spécifiez par requête.

Lorsqu'il est renvoyé dans un objet, le pointeur ressemble à quelque chose comme 'WzXXXXXXXXXXXXXX'.

Vous pouvez ensuite utiliser le pointeur de la réponse pour effectuer la requête suivante pour le lot de données suivant.

Le formatage de la pagination dans la requête diffère légèrement entre les API de liste et les API de recherche, mais les réponses fonctionnent de la même manière.

Vous pouvez voir des exemples de requêtes curl sur notre page Pagination, ainsi que des tutoriels sur l'utilisation des API de liste et des API de recherche.

Toutes les applications qui interagissent avec les données d'un espace de travail tiers et les applications construites avec Canvas Kit nécessitent OAuth. Vous ne devez jamais demander aux users leur jeton d'accès et utiliser uniquement OAuth pour interagir avec leurs données.

Consultez la documentation pour les instructions pour configurer OAuth.

Vous devrez configurer OAuth si vous créez une intégration avec Intercom qui accède aux données Intercom d'autres personnes. Cela inclut les applications publiques que vous prévoyez de lister sur la boutique d'applications Intercom ainsi que les applications et intégrations que vous demanderez aux users d'installer via votre propre site web. En savoir plus sur OAuth dans notre documentation développeur.

Si vous accédez uniquement aux données de votre propre espace de travail Intercom, vous pouvez utiliser un jeton d'accès.

Si vous créez une application privée qui n'accède qu'aux données de votre espace de travail Intercom, vous pouvez utiliser votre jeton d'accès Intercom pour l'authentification. Trouvez votre jeton d'accès dans votre hub développeur et en savoir plus sur l'authentification ici.

Vous pouvez utiliser votre jeton d'accès Intercom si vous utilisez l'API pour accéder aux données de votre propre espace de travail Intercom. Trouvez votre jeton d'accès dans votre hub développeur et en savoir plus sur l'authentification ici.

Pour trouver votre jeton d'accès API, suivez ces étapes :

Vous pouvez créer une application pour votre Inbox Intercom en utilisant Canvas Kit, un kit d'outils qui vous permet de créer des applications fonctionnant directement dans l'interface Intercom.

Suivez ce tutoriel pour apprendre à créer votre première application Inbox. Vous pouvez également en savoir plus sur Canvas Kit et trouver la documentation de référence dans notre documentation développeur.

Vous pouvez créer une application pour votre Messenger Intercom en utilisant Canvas Kit, un kit d'outils qui vous permet de créer des applications fonctionnant directement dans l'interface Intercom.

Notez que les personnalisations sont limitées à ce qui est possible via Canvas Kit et doivent être créées dans le Messenger : il n'est pas possible de recréer ou de re-skinner le Messenger.

Suivez ce tutoriel pour apprendre à créer votre première application Inbox. Vous pouvez également en savoir plus sur Canvas Kit et trouver la documentation de référence dans notre documentation développeur.

Si vous visitez la page Test & Publish > Your Workspaces de votre application dans le Developer Hub, vous devriez voir tous les espaces de travail dont vous (en tant que membre de l'équipe Intercom) faites partie.

Vous pouvez cliquer sur Installer l'application à côté de l'espace de travail sur lequel vous souhaitez installer l'application donnée. Cette application sera alors installée et un jeton d'accès sera fourni pour cet espace de travail afin que vous puissiez accéder à ses données via l'API.

Pour les instructions d'installation tierces, consultez notre documentation développeur.

Lorsque vous êtes prêt à publier votre application, vous pouvez suivre les étapes dans le developer hub. Vous trouverez un guide sur la façon de publier votre application dans notre documentation pour développeurs.

Le SDK Intercom pour iOS vous permet d'utiliser le Intercom Messenger dans votre application, d'avoir des conversations avec vos clients, d'envoyer des messages sortants enrichis, d'afficher votre Help Center et de suivre les événements.

Vous pouvez installer Intercom pour iOS en utilisant Cocoapods, Swift Package Manager ou manuellement. Lisez les détails ici. Vous pouvez trouver Intercom pour iOS sur GitHub ainsi qu'une application exemple que vous pouvez utiliser pour tester le SDK ici.

Le SDK Intercom pour Android vous permet d'utiliser le Intercom Messenger dans votre application, d'avoir des conversations avec vos clients, d'envoyer des messages sortants enrichis, d'afficher votre Help Center et de suivre les événements.

Vous pouvez installer Intercom pour Android en utilisant Gradle ou manuellement. Lisez les détails ici. Vous pouvez trouver Intercom pour Android sur GitHub ainsi qu'une application exemple que vous pouvez utiliser pour tester le SDK ici.

Le wrapper React Native d'Intercom vous permet d'utiliser Intercom pour iOS et Intercom pour Android dans vos applications React Native. Suivez les étapes d'installation ici.