Intercom

Intercom est un connecteur : il relie une application MeDo à un espace de travail Intercom afin que l'application puisse rechercher des conversations et des contacts, ouvrir un fil complet, rechercher des entreprises, travailler avec des tickets et des articles publiés du centre d'aide, et envoyer une réponse ou un ticket confirmé. Il ne supprime pas de contacts, n'exécute pas Fin ni les appels, et ne donne pas à chaque visiteur sa propre connexion Intercom.

#Ce que vous pouvez construire

• Une boîte de support privée. Listez les conversations ouvertes et ouvrez le fil complet lorsque vous en choisissez une.
• Une prise de tickets. Trouvez ou créez un contact par e-mail, puis créez un ticket après avoir confirmé le type et la description.
• Une recherche de contact. Recherchez par e-mail et affichez le contact plus les conversations récentes.
• Un espace de réponse. Affichez une conversation et envoyez votre réponse confirmée en tant qu'administrateur sélectionné.

Intercom convient lorsque l'application doit travailler avec de vraies conversations de support, des contacts et des tickets que le propriétaire conserve déjà dans Intercom. Ce n'est pas une console d'administration Intercom complète, voir Limites.

#Exemples de construction

Copiez l'un de ces textes dans la zone de saisie. Le premier est le point de départ le plus simple et déjà utile.

Use @Intercom to build a private inbox that lists my open conversations and shows the full thread when I pick one.

Use @Intercom to build a private ticket intake that finds or creates a contact by email, then creates a ticket after I confirm the type and description.

Use @Intercom to build a private contact lookup where I search by email and see the contact plus recent conversations.

Use @Intercom to build a private reply workspace that shows a conversation and sends my confirmed reply as a selected admin.

La formulation compte : nommez le client, l'e-mail ou le ticket visé. « Afficher les conversations ouvertes pour la facturation » produit une application différente de « une page qui liste tous les contacts ».

#Préparer et connecter

Vous avez besoin d'un espace de travail Intercom qui peut déjà voir les conversations, contacts et tickets que l'application doit utiliser. Aucune clé API n'est requise.

1. Ouvrez Skills & Connectors dans la barre latérale et recherchez Intercom.
2. Ouvrez la carte Intercom et cliquez sur Connect.
3. Connectez-vous à Intercom et autorisez l'accès demandé par MeDo.
4. Le bouton passe à Connected. C'est l'état de succès ; vous n'avez rien à recopier dans l'application.

Si vous commencez à construire avant de connecter, MeDo le détecte et affiche un bouton de connexion Intercom sous sa réponse. Vous pouvez connecter depuis là. Si aucun bouton n'apparaît, utilisez la carte du connecteur décrite ci-dessus.

#Utilisation dans votre application

• L'application utilise l'espace de travail Intercom connecté du propriétaire, pas la connexion Intercom de chaque visiteur. Toute personne qui ouvre la boîte voit les mêmes conversations. Placez les recherches et les écritures derrière la propre connexion de votre application, et limitez-les aux personnes qui doivent y avoir accès. Une page intitulée « privée » n'est pas un contrôle d'accès à elle seule.
• Partez d'une recherche ou d'un ID connu. Copiez les ID de conversation, de contact et de ticket depuis les résultats. Des listes vides signifient qu'il n'y a aucun enregistrement correspondant dans cet espace de travail.
• Les réponses sont réellement envoyées. Une réponse ou une mise à jour de ticket confirmée va au client en tant qu'administrateur sélectionné. Confirmez le nom, le texte du message et le type de ticket avant d'écrire.
• La recherche du centre d'aide couvre les articles publiés. Les brouillons peuvent ne pas apparaître.
• Les lectures s'actualisent à la demande. Il n'y a pas de synchronisation en direct avec Intercom. Ajoutez un contrôle d'actualisation plutôt que d'attendre que de nouveaux messages apparaissent tout seuls.
• Les données propres à l'application restent dans l'application. Libellés, statuts de relecture et notes qui ne sont pas des champs Intercom appartiennent aux tables de votre application, avec pour clé le vrai ID de conversation ou de ticket.

#Limites et dépannage

« Connexion requise » s'affiche dans l'application. Demandez au propriétaire de l'application d'ouvrir la carte du connecteur et de cliquer sur Connect, puis de recharger.

La liste des conversations est vide ou refusée. Vérifiez Intercom Inbox directement. Si Inbox est désactivé, utilisez les contacts ou les tickets à la place.

Une réponse a été refusée. Envoyer une réponse ou créer un ticket exige une confirmation explicite dans l'application. Vérifiez que l'étape de confirmation a bien eu lieu avant de réessayer.

Les visiteurs voient des conversations alors qu'ils ne devraient pas. La connexion est partagée. Ajoutez une connexion et des restrictions côté serveur à l'application ; voir Gérer l'accès et les rôles.

#Voir aussi

• Catalogue de connecteurs — les autres connecteurs et leur usage.
• HubSpot — contacts, entreprises et transactions CRM, pas des tickets de support.
• Skills et Connecteurs — comment les Skills sont appelés, tarifés et limités.
• Gérer l'accès et les rôles — restreignez qui peut lire et modifier les données connectées.