Crie Issues do GitHub diretamente de Conversas ou Tickets do Intercom com um único clique, eliminando a necessidade de copiar e colar entre ferramentas.

BETA: Automatize a criação de Issues do GitHub com o poder dos Workflows e GitHub Actions

Você pode integrar o GitHub com o Intercom simplesmente clicando em alguns passos rápidos.

Primeiro, vá para a App Store do Intercom, depois procure o aplicativo GitHub e clique em Instalar agora.

O GitHub abrirá em uma nova aba e você será solicitado a autorizar o aplicativo. Autorizar o aplicativo permitirá que o Intercom receba webhooks do GitHub quando um issue conectado for atualizado.

Depois de autorizar o aplicativo, na aba Configurações você verá uma lista dos repositórios aos quais tem acesso e que pode conectar ao Intercom.

Cada colega só poderá adicionar os repositórios aos quais tem acesso no GitHub. Você deve selecionar o repositório onde registra issues para seu produto com sua equipe de desenvolvimento, assim como quaisquer outros que queira vincular ao Intercom.

Agora, clique em Adicionar repo para conectar um repositório GitHub ao Intercom.

Se adicionar mais de um repositório, certifique-se de "Escolher seu repo principal" no topo da aba Configurações.

Nota sobre repositórios: Cada colega verá apenas os repositórios GitHub aos quais tem acesso na aba Configurações do aplicativo GitHub. Isso significa que é possível que o repositório padrão seja (ou seja alterado para) um repositório ao qual outro colega não tenha acesso, impedindo seu uso. Você deve garantir que seu repo principal seja acessível a todos os colegas que criam issues.

É fácil criar issues do GitHub diretamente de uma conversa no Intercom.

Basta passar o mouse sobre um comentário ou nota que deseja criar como um issue do GitHub e clicar no ícone de três pontos:

Então, selecione Novo issue do GitHub:

Seu novo issue do GitHub abrirá em uma nova aba. Ele incluirá automaticamente o texto da conversa, imagens, um link para a conversa e detalhes do cliente. Você pode editar esse issue se necessário e clicar em Enviar novo issue no GitHub para criá-lo:

Depois de criar o issue, Fin deixará uma nota na conversa vinculada a esse issue:

Fin também deixará uma nota quando o issue for fechado e reabrirá quaisquer Conversas ou Tickets silenciados ou fechados vinculados a esse issue do GitHub, para que você possa atualizar seu cliente.

Para repositórios que não sejam o seu principal, você pode vincular Conversas ou Tickets do Intercom a Issues do GitHub colando a URL deles no Issue ou Comentário do Issue do GitHub. Você pode fazer isso em qualquer repositório que adicionou na aba Configurações. O agente Fin AI então adicionará uma nota e notificará você quando a conversa for fechada.

Você também pode vincular Issues do GitHub a conversas adicionando a URL do Issue do GitHub em uma nota em uma conversa ou ticket no Intercom. A conversa ou ticket será reaberto quando o Issue do GitHub for fechado.

Se você tem acesso a Workflows do Intercom, encontrará novos Modelos de Workflow do GitHub ao criar um novo Workflow.

Existem três modelos de Workflow pré-instalados com o aplicativo GitHub que você pode personalizar para atender às suas necessidades específicas:

Você pode usar os modelos padrão ou editá-los usando o poder dos Workflows.

Para editar quais informações do Intercom são passadas para o issue do GitHub, clique no ícone de três pontos na etapa da GitHub Action e escolha Editar.

Você pode adicionar mais atributos à GitHub Create Issue Action editando e usando o Seletor de Atributos em qualquer campo: Título, Corpo, Labels e Assignees. Labels e Assignees devem ser separados por vírgula e corresponder aos Labels e Assignees no seu repositório GitHub.

Depois de fazer suas alterações, clique em Salvar na GitHub Create Issue Action. Você verá os atributos adicionados exibidos na etapa da ação.

Quando estiver satisfeito que seu Workflow e Action do GitHub estão prontos, clique em Ativar para colocar o Workflow em funcionamento.

O Workflow será executado quando as condições do seu gatilho forem atendidas.

É possível integrar várias contas do GitHub com o Intercom. Mas você só poderá criar issues do Intercom no seu repo principal - essa configuração valerá para todos os colegas. Quando você acessar as Configurações do aplicativo GitHub, a lista de repositórios que verá será da conta do GitHub na qual está logado na sessão atual do navegador.

O primeiro modelo encontrado nesta lista será usado com as informações pré-preenchidas da conversa do Intercom anexadas após o modelo.

Você pode revogar o acesso do Intercom à sua conta do GitHub indo para as Configurações de Aplicativos do GitHub.

Se você remover a integração e depois reintegrá-la, ela se conectará automaticamente à conta original do GitHub que você autorizou. Se quiser conectar a uma conta diferente, precisa sair do Intercom e entrar novamente (e garantir que está logado na nova conta do GitHub no mesmo navegador) e então reinstalar e configurar o aplicativo.

Se você usar seu próprio modelo para issues do GitHub, o Intercom manterá o modelo, mas adicionará as informações pré-preenchidas da Conversa ou Ticket ao final do modelo.

Se quiser permitir que o aplicativo GitHub acesse repositórios em nível de organização ou empresa, precisará aprovar explicitamente o acesso do aplicativo Intercom a essas organizações através das configurações da conta pessoal do GitHub.

Passos:

Uma etapa útil para solução de problemas é reconectar seu aplicativo ao GitHub. Na App Store, nas Configurações do aplicativo GitHub, você pode clicar em Conectar ao GitHub e seguir o fluxo de autorização do GitHub para reconectar o aplicativo.

Você também pode ser solicitado a pedir acesso à Organização para ver todos os seus repositórios GitHub.

Vá para seu repositório e em Configurações > Webhooks, certifique-se de que há um ✅ ao lado do Intercom webhook.

Se não, você precisará reautorizar o repositório, o que deve resolver o problema.