Erstellen Sie GitHub Issues direkt aus Intercom Conversations oder Tickets mit nur einem Klick, ohne zeitaufwändiges Kopieren zwischen Tools.

BETA: Automatisieren Sie Ihre GitHub Issue-Erstellung mit der Kraft von Workflows und GitHub Actions

Sie können GitHub einfach integrieren, indem Sie ein paar kurze Schritte in Intercom durchklicken.

Gehen Sie zuerst zum Intercom App Store und suchen Sie die GitHub app, dann klicken Sie auf Jetzt installieren.

GitHub öffnet sich in einem neuen Tab und Sie werden aufgefordert, die Anwendung zu autorisieren. Die Autorisierung ermöglicht es Intercom, webhooks von GitHub zu empfangen, wenn ein verbundenes Issue aktualisiert wird.

Sobald Sie die Anwendung autorisieren, sehen Sie auf dem Einstellungen-Tab eine Liste der Repositories, auf die Sie Zugriff haben und die Sie mit Intercom verbinden können.

Jeder Teamkollege kann nur die Repositories hinzufügen, auf die er in GitHub Zugriff hat. Sie sollten das Repository auswählen, in dem Sie Issues für Ihr Produkt mit Ihrem Entwicklungsteam protokollieren, sowie alle anderen, die Sie mit Intercom verknüpfen möchten.

Klicken Sie nun auf Repo hinzufügen, um ein GitHub-Repository mit Intercom zu verbinden.

Wenn Sie mehr als ein Repository hinzufügen, stellen Sie sicher, dass Sie oben im Einstellungen-Tab "Wählen Sie Ihr Haupt-Repo" auswählen.

Hinweis zu Repositories: Jeder Teamkollege sieht im Einstellungen-Tab der GitHub app nur die GitHub-Repositories, auf die er Zugriff hat. Das bedeutet, dass das Standard-Repository ein Repository sein kann (oder geändert werden kann), auf das ein anderer Teamkollege keinen Zugriff hat und es daher nicht verwenden kann. Sie sollten sicherstellen, dass Ihr Haupt-Repo eines ist, auf das alle Teamkollegen, die Issues erstellen, Zugriff haben.

Es ist einfach, GitHub issues direkt aus einer Konversation in Intercom zu erstellen.

Bewegen Sie einfach den Mauszeiger über einen Kommentar oder eine Notiz, die Sie als GitHub issue erstellen möchten, und klicken Sie auf das Drei-Punkte-Symbol:

Wählen Sie dann Neues GitHub issue aus:

Ihr neues GitHub issue öffnet sich nun in einem neuen Tab. Es enthält automatisch den Konversationstext, Bilder, einen Link zur Konversation und Kundendetails. Sie können dieses Issue bei Bedarf bearbeiten und dann in GitHub auf Neues Issue erstellen klicken, um es zu erstellen:

Sobald Sie das Issue erstellen, hinterlässt Fin eine Notiz in der mit diesem Issue verknüpften Konversation:

Fin hinterlässt auch eine Notiz, wenn das Issue geschlossen wurde, und öffnet alle geschlossenen oder pausierten Conversations oder Tickets, die mit diesem GitHub issue verknüpft sind, wieder, damit Sie Ihren Kunden informieren können.

Für andere Repositories als Ihr Haupt-Repo können Sie Intercom Conversations oder Tickets mit GitHub Issues verknüpfen, indem Sie deren URL in das GitHub Issue oder den Issue-Kommentar einfügen. Dies können Sie in jedem Repository tun, das Sie im Einstellungen-Tab hinzugefügt haben. Der Fin AI Agent fügt dann eine Notiz hinzu und benachrichtigt Sie, wenn die Konversation geschlossen wird.

Sie können GitHub Issues auch mit Konversationen verknüpfen, indem Sie die URL des GitHub Issues in einer Notiz zu einer Konversation oder einem ticket in Intercom hinzufügen. Die Konversation oder das ticket wird wieder geöffnet, wenn das GitHub Issue geschlossen wird.

Wenn Sie Zugriff auf Intercom Workflows haben, finden Sie neue GitHub Workflow-Vorlagen, wenn Sie einen neuen Workflow erstellen.

Es gibt drei Workflow-Vorlagen, die mit der GitHub app vorinstalliert sind und die Sie an Ihre spezifischen Anforderungen anpassen können:

Sie können entweder die Standardvorlagen verwenden oder diese mit der Kraft von Workflows bearbeiten.

Um zu bearbeiten, welche Intercom-Informationen an das GitHub issue übergeben werden, klicken Sie auf das Drei-Punkte-Symbol im GitHub Action-Schritt und wählen Sie Bearbeiten.

Sie können dem GitHub Create Issue Action weitere Attribute hinzufügen, indem Sie den Attribut-Selektor in den Feldern Titel, Inhalt, Labels und Assignees bearbeiten und verwenden. Labels und Assignees sollten durch ein Komma getrennt sein und den Labels und Assignees in Ihrem GitHub-Repository entsprechen.

Nachdem Sie Ihre Änderungen vorgenommen haben, klicken Sie auf Speichern im GitHub Create Issue Action. Sie sehen dann Ihre hinzugefügten Attribute im Aktionsschritt angezeigt.

Wenn Sie mit Ihrem GitHub Workflow und der Action zufrieden sind, klicken Sie auf Live schalten, um den Workflow zu aktivieren.

Der Workflow wird ausgeführt, wenn die Bedingungen seines Triggers erfüllt sind.

Es ist möglich, mehrere GitHub-Konten mit Intercom zu integrieren. Sie können jedoch nur in Ihrem Haupt-Repo Issues aus Intercom erstellen – diese Einstellung gilt für alle Teamkollegen. Wenn Sie zu Ihren GitHub app Einstellungen gehen, stammt die Liste der Repositories von dem GitHub-Konto, bei dem Sie in Ihrer aktuellen Browsersitzung angemeldet sind.

Die erste in dieser Liste gefundene Vorlage wird verwendet, wobei die vorab ausgefüllten Informationen aus der Intercom-Konversation an die Vorlage angehängt werden.

Sie können Intercoms Zugriff auf Ihr GitHub-Konto widerrufen, indem Sie zu Ihren GitHub-Anwendungseinstellungen gehen.

Wenn Sie die Integration entfernen und dann erneut integrieren, wird sie automatisch mit dem ursprünglichen GitHub-Konto verbunden, das Sie autorisiert hatten. Wenn Sie sich mit einem anderen Konto verbinden möchten, müssen Sie sich bei Intercom abmelden, dann erneut anmelden (und sicherstellen, dass Sie im selben Browser beim neuen GitHub-Konto angemeldet sind) und dann die app neu installieren und einrichten.

Wenn Sie Ihre eigene Vorlage für GitHub issues verwenden, behält Intercom die Vorlage bei, fügt jedoch die vorab ausgefüllten Informationen aus der Konversation oder dem Ticket unten an die Vorlage an.

Wenn Sie der GitHub app den Zugriff auf Organisations- oder Enterprise-Level-Repositories erlauben möchten, müssen Sie den Zugriff der Intercom app auf diese Organisationen explizit über die persönlichen Kontoeinstellungen von GitHub genehmigen.

Schritte:

Ein nützlicher Schritt zur Fehlerbehebung ist, Ihre app erneut mit GitHub zu verbinden. Im App Store in den GitHub app Einstellungen können Sie auf Mit GitHub verbinden klicken und dem GitHub-Autorisierungsprozess folgen, um die app erneut zu verbinden.

Möglicherweise werden Sie auch aufgefordert, Organisationszugriff anzufordern, um alle Ihre GitHub-Repositories sehen zu können.

Gehen Sie zu Ihrem Repository und stellen Sie unter Einstellungen > Webhooks sicher, dass neben Intercom webhook ein ✅ steht.

Wenn nicht, müssen Sie das Repository erneut autorisieren, was das Problem beheben sollte.