Crea Issues de GitHub directamente desde Conversaciones o Tickets de Intercom con un solo clic, eliminando la necesidad de copiar y pegar entre herramientas.

BETA: Automatiza la creación de tus Issues de GitHub con el poder de Workflows y GitHub Actions

Puedes integrar GitHub con Intercom simplemente siguiendo unos pocos pasos cortos.

Primero, ve a la App Store de Intercom, luego busca la aplicación de GitHub y haz clic en Instalar ahora.

GitHub se abrirá en una nueva pestaña y se te pedirá autorizar la aplicación. Autorizar la aplicación permitirá que Intercom reciba webhooks de GitHub cuando un issue conectado se actualice.

Una vez que autorices la aplicación, en la pestaña Configuración verás una lista de los repositorios a los que tienes acceso y que puedes conectar a Intercom.

Cada compañero solo podrá añadir los repositorios a los que tenga acceso en GitHub. Debes seleccionar el repositorio donde registras issues para tu producto con tu equipo de desarrollo, así como cualquier otro que quieras vincular a Intercom.

Ahora, haz clic en Añadir repo para conectar un repositorio de GitHub a Intercom.

Si añades más de un repositorio, asegúrate de "Elegir tu repo principal" en la parte superior de la pestaña Configuración.

Nota sobre repositorios: Cada compañero solo verá los repositorios de GitHub a los que tiene acceso en la pestaña Configuración de la aplicación de GitHub. Esto significa que es posible que el repositorio predeterminado sea (o se cambie a) uno al que otro compañero no tenga acceso, por lo que no podría usarlo. Debes asegurarte de que tu repo principal sea uno al que todos los compañeros que crean issues tengan acceso.

Es fácil crear issues de GitHub directamente desde una conversación en Intercom.

Solo pasa el cursor sobre un comentario o nota que quieras crear como un issue de GitHub y haz clic en el icono de tres puntos:

Luego, selecciona Nuevo issue de GitHub:

Tu nuevo issue de GitHub se abrirá ahora en una nueva pestaña. Incluirá automáticamente el texto de la conversación, imágenes, un enlace a la conversación y detalles del cliente. Luego puedes editar este issue si es necesario y hacer clic en Enviar nuevo issue en GitHub para crearlo:

Una vez que crees el issue, Fin dejará una nota en la conversación vinculada a ese issue:

Fin también dejará una nota cuando el issue se haya cerrado y reabrirá cualquier Conversación o Ticket pospuesta o cerrada vinculada a ese issue de GitHub, para que puedas actualizar a tu cliente.

Para repositorios distintos al principal, puedes vincular Conversaciones o Tickets de Intercom a Issues de GitHub pegando su URL en el Issue o Comentario del Issue de GitHub. Puedes hacer esto en cualquier repositorio que hayas añadido en la pestaña Configuración. El agente Fin AI añadirá una nota y te notificará cuando la conversación se cierre.

También puedes vincular Issues de GitHub a conversaciones añadiendo la URL del Issue de GitHub en una nota en una conversación o ticket en Intercom. La conversación o ticket se reabrirá cuando el Issue de GitHub se cierre.

Si tienes acceso a Workflows de Intercom, encontrarás nuevas Plantillas de Workflow de GitHub cuando crees un nuevo Workflow.

Hay tres plantillas de Workflow que vienen preinstaladas con la aplicación de GitHub y puedes personalizarlas para cumplir con tus requisitos específicos:

Puedes usar las plantillas predeterminadas o editarlas usando el poder de Workflows.

Para editar qué información de Intercom se pasa al issue de GitHub, haz clic en el icono de tres puntos en el paso de GitHub Action y elige Editar.

Puedes añadir más atributos a la Acción Crear Issue de GitHub editando y usando el Selector de Atributos en cualquier campo: Título, Cuerpo, Etiquetas y Asignados. Las Etiquetas y Asignados deben separarse por comas y coincidir con las Etiquetas y Asignados en tu repositorio de GitHub.

Una vez que hagas tus cambios, haz clic en Guardar en la Acción Crear Issue de GitHub. Luego verás los atributos añadidos mostrados en el paso de la acción.

Cuando estés satisfecho de que tu Workflow y Acción de GitHub están listos, haz clic en Activar para poner el Workflow en vivo.

El Workflow se ejecutará cuando se cumplan las condiciones de su disparador.

Es posible integrar varias cuentas de GitHub con Intercom. Pero solo podrás crear issues desde Intercom en tu repo principal; esta configuración aplicará para todos los compañeros. Cuando vayas a la Configuración de la aplicación de GitHub, la lista de repositorios que ves será de la cuenta de GitHub en la que hayas iniciado sesión en tu navegador actual.

La primera plantilla encontrada en esta lista se usará con la información prellenada de la conversación de Intercom añadida después de la plantilla.

Puedes revocar el acceso de Intercom a tu cuenta de GitHub yendo a la configuración de aplicaciones de GitHub.

Si eliminas la integración y luego la vuelves a integrar, se conectará automáticamente a la cuenta original de GitHub que habías autorizado. Si quieres conectar una cuenta diferente, necesitas cerrar sesión en Intercom y luego volver a iniciar sesión (y asegurarte de que estás conectado a la nueva cuenta de GitHub en el mismo navegador) y luego reinstalar y configurar la aplicación.

Si usas tu propia plantilla para issues de GitHub, Intercom conservará la plantilla pero añadirá la información prellenada de la Conversación o Ticket al final de la plantilla.

Si quieres permitir que la aplicación de GitHub acceda a repositorios a nivel de organización o empresa, necesitarás aprobar explícitamente el acceso de la aplicación Intercom a esas organizaciones a través de la configuración de cuenta personal de GitHub.

Pasos:

Un paso útil para solucionar problemas es reconectar tu aplicación a GitHub. En la App Store en la configuración de la aplicación de GitHub, puedes hacer clic en Conectar a GitHub y seguir el flujo de autorización de GitHub para reconectar la aplicación.

También es posible que se te solicite pedir acceso a la Organización para ver todos tus repositorios de GitHub.

Ve a tu repositorio y en Configuración > Webhooks, asegúrate de que haya un ✅ junto al webhook de Intercom.

Si no, necesitarás reautorizar el repositorio, lo que debería solucionar el problema.