Créez des issues GitHub directement depuis les conversations ou tickets Intercom en un seul clic, sans avoir à copier-coller entre les outils.

BÊTA : Automatisez la création de vos issues GitHub grâce à la puissance des Workflows et GitHub Actions

Vous pouvez intégrer GitHub à Intercom simplement en suivant quelques étapes courtes.

Tout d’abord, allez sur l’ App Store d’Intercom, puis cherchez l’application GitHub et cliquez sur Installer maintenant.

GitHub s’ouvrira dans un nouvel onglet et vous serez invité à autoriser l’application. Autoriser l’application permettra à Intercom de recevoir des webhooks de GitHub lorsqu’une issue connectée est mise à jour.

Une fois que vous avez autorisé l’application, dans l’onglet Paramètres, vous verrez la liste des dépôts auxquels vous avez accès et que vous pouvez connecter à Intercom.

Chaque coéquipier ne pourra ajouter que les dépôts auxquels il a accès sur GitHub. Vous devez sélectionner le dépôt où vous enregistrez les issues pour votre produit avec votre équipe de développement, ainsi que tout autre dépôt que vous souhaitez lier à Intercom.

Cliquez maintenant sur Ajouter un dépôt pour connecter un dépôt GitHub à Intercom.

Si vous ajoutez plusieurs dépôts, assurez-vous de « Choisir votre dépôt principal » en haut de l’onglet Paramètres.

Note sur les dépôts : Chaque coéquipier ne verra que les dépôts GitHub auxquels il a accès dans l’onglet Paramètres de l’application GitHub. Cela signifie qu’il est possible que le dépôt par défaut soit (ou soit changé pour être) un dépôt auquel un autre coéquipier n’a pas accès, donc il ne pourrait pas l’utiliser. Vous devez vous assurer que votre dépôt principal est accessible à tous les coéquipiers qui créent des issues.

Il est facile de créer des issues GitHub directement depuis une conversation dans Intercom.

Il suffit de survoler un commentaire ou une note que vous souhaitez créer comme issue GitHub, puis de cliquer sur l’icône à trois points :

Ensuite, sélectionnez Nouvelle issue GitHub :

Votre nouvelle issue GitHub s’ouvrira maintenant dans un nouvel onglet. Elle inclura automatiquement le texte de la conversation, les images, un lien vers la conversation et les détails du client. Vous pouvez ensuite modifier cette issue si nécessaire et cliquer sur Soumettre la nouvelle issue dans GitHub pour la créer :

Une fois que vous créez l’issue, Fin laissera une note dans la conversation liée à cette issue :

Fin laissera également une note lorsque l’issue est fermée et rouvrira toutes les Conversations ou Tickets en snooze ou fermées liées à cette issue GitHub, afin que vous puissiez informer votre client.

Pour les dépôts autres que votre dépôt principal, vous pouvez lier les Conversations ou Tickets Intercom aux issues GitHub en collant leur URL dans l’issue GitHub ou dans un commentaire d’issue. Vous pouvez faire cela dans n’importe quel dépôt que vous avez ajouté dans l’onglet Paramètres. L’agent Fin AI ajoutera alors une note et vous notifiera lorsque la conversation sera fermée.

Vous pouvez aussi lier des issues GitHub aux conversations en ajoutant l’URL de l’issue GitHub dans une note sur une conversation ou un ticket dans Intercom. La conversation ou le ticket sera rouvert lorsque l’issue GitHub sera fermée.

Si vous avez accès aux Workflows Intercom, vous trouverez de nouveaux Modèles de Workflow GitHub lorsque vous créerez un nouveau Workflow.

Il y a trois modèles de Workflow préinstallés avec l’application GitHub que vous pouvez personnaliser selon vos besoins spécifiques :

Vous pouvez soit utiliser les modèles par défaut, soit les modifier en utilisant la puissance des Workflows.

Pour modifier les informations Intercom transmises à l’issue GitHub, cliquez sur l’icône à trois points de l’étape GitHub Action et choisissez Modifier.

Vous pouvez ajouter plus d’attributs à l’Action de création d’issue GitHub en modifiant et en utilisant le Sélecteur d’attributs dans n’importe quel champ : Titre, Corps, Étiquettes et Assignés. Les Étiquettes et Assignés doivent être séparés par une virgule et correspondre aux Étiquettes et Assignés de votre dépôt GitHub.

Une fois vos modifications effectuées, cliquez sur Enregistrer dans l’Action de création d’issue GitHub. Vous verrez alors les attributs ajoutés affichés dans l’étape d’action.

Une fois que vous êtes satisfait que votre Workflow et Action GitHub sont prêts, cliquez sur Mettre en ligne pour activer le Workflow.

Le Workflow s’exécutera lorsque les conditions de son déclencheur seront remplies.

Il est possible d’intégrer plusieurs comptes GitHub avec Intercom. Mais vous ne pourrez créer des issues depuis Intercom que dans votre dépôt principal - ce paramètre s’appliquera à tous les coéquipiers. Lorsque vous allez dans les Paramètres de l’application GitHub, la liste des dépôts que vous voyez provient du compte GitHub dans lequel vous êtes connecté dans votre session de navigateur actuelle.

Le premier modèle trouvé dans cette liste sera utilisé avec les informations pré-remplies de la conversation Intercom ajoutées après le modèle.

Vous pouvez révoquer l’accès d’Intercom à votre compte GitHub en allant dans vos paramètres d’application GitHub.

Si vous supprimez l’intégration puis la réintégrez, elle se connectera automatiquement au compte GitHub original que vous aviez autorisé. Si vous souhaitez vous connecter à un autre compte, vous devez vous déconnecter d’Intercom puis vous reconnecter (et vous assurer d’être connecté au nouveau compte GitHub dans le même navigateur) puis réinstaller et configurer l’application.

Si vous utilisez votre propre modèle pour les issues GitHub, Intercom conservera le modèle mais ajoutera les informations pré-remplies de la Conversation ou du Ticket en bas du modèle.

Si vous souhaitez permettre à l’application GitHub d’accéder aux dépôts d’organisation ou d’entreprise, vous devrez approuver explicitement l’accès de l’application Intercom à ces organisations via les paramètres de compte personnel GitHub.

Étapes :

Une étape utile pour résoudre les problèmes est de reconnecter votre application à GitHub. Dans l’App Store, dans les paramètres de l’application GitHub, vous pouvez cliquer sur Connecter à GitHub et suivre le flux d’autorisation GitHub pour reconnecter l’application.

Il se peut aussi que vous soyez invité à demander l’accès à l’organisation pour voir tous vos dépôts GitHub.

Rendez-vous dans votre dépôt et sous Paramètres > Webhooks, assurez-vous qu’il y a un ✅ à côté de l’intercom webhook.

Sinon, vous devrez réautoriser le dépôt, ce qui devrait résoudre le problème.