A Integração com o GitHub

Publicado em 9 maio

Quem pode usar este recurso
gray-cloud.svgDisponível no monday dev

 

É crucial ter uma integração robusta entre sua ferramenta de código-fonte e a monday.com, por isso, é apresentado a você a Integração com GitHub.

A integração de instalação única com o GitHub oferece modelos poderosos para que sua equipe trabalhe com um fluxo de desenvolvimento de software contínuo, desde o planejamento e acompanhamento de sprints no monday dev até a execução do código perfeito no GitHub.

A integração é uma integração de permissão em nível de conta. Uma vez que a integração é pré-instalada em apenas alguns passos, qualquer pessoa da sua equipe pode criar novos modelos.

 

Dica: Para que a integração com o GitHub sincronize com sucesso, você precisará primeiro instalar o aplicativo da monday.com no GitHub. Você também precisará ser um Administrador da sua conta da monday.com e ter permissão de Administrador na organização do GitHub para instalar o aplicativo. 
Para começar, vá para github.com/apps/monday-com-github, e instale o aplicativo da monday.com no GitHub:

Devs Install GitHub.png

 

Você será solicitado a escolher uma organização na sua conta:

Devs Choose Organization.png

 

Em seguida, você será solicitado a autorizar a monday.com na sua conta do GitHub:

Devs monday Permissions.png

Uma vez que isso esteja instalado, os usuários podem adicionar novos modelos do GitHub e serão automaticamente autenticados com sua conta do GitHub.

 

Clique aqui para aprender o que essas permissões significam

É importante notar que monday.com acessa apenas os dados necessários, como nomes e locais dos seus dados, para garantir a funcionalidade. Essas permissões incluem:

  • Acesso ao seu código – Específico para o modelo TODO, monday.com lê as alterações no PR, sem salvar o código, a fim de conectá-lo ao seu item da monday. 
  • Problemasmonday.com precisa acessar informações sobre problemas para acionar a automação relevante da monday
  • Metadadosmonday.com precisa de acesso a uma coleção de endpoints somente leitura com metadados para acionar a automação relevante da monday. Esses endpoints não fornecem informações sensíveis ou privadas do repositório.
  • Pull requestsmonday.com precisa ler as alterações no PR, bem como acessar permissões de escrita em relação aos pull requests, a fim de acionar a automação relevante da monday e os modelos de sincronização bidirecional da monday

 

Adicione ao seu fluxo de trabalho 

Para adicionar os modelos de integração do GitHub ao seu quadro desejado, você pode ir até esse quadro e clicar em Integrar no canto superior direito:Group 64 (54).png

 

Uma vez na página de Automação do Quadro, pesquise por GitHub na barra de pesquisa:Group 1 - 2025-07-14T142223.422.png

 

Clique no banner do GitHub e você encontrará os modelos que nossa integração oferece:Screenshot 2025-07-14 at 14.16.06 1.png

 

Então você pode selecionar os modelos que deseja adicionar ao seu quadro.

 

Os modelos de integração suportados pela monday.com são:
  • Quando um problema é rotulado com algo neste repositório, crie um item
  • Quando um pull request é mesclado em estes repositórios, e o ID do item é mencionado nele, altere o status para algo
  • Quando um problema é criado em estes repositórios, crie um item
  • Quando um pull request é criado em estes repositórios, e o ID do item é mencionado nele, altere o status para algo
  • Quando um pull request é criado em estes repositórios, e o ID do item é mencionado nele, adicione o link do pull request à coluna de links
  • Quando um branch é criado em estes repositórios, crie um item
  • Quando o status de um problema muda para algo em estes repositórios, e o ID do item é mencionado nele, defina o status para algo
  • Quando o usuário do github envia um comentário TODO para estes repositórios, crie um item
  • Quando um problema é criado em estes repositórios, e o ID do item é mencionado nele, adicione o link a esta coluna de links
  • Quando o status de um pull request muda para algo em estes repositórios, e o ID do item é mencionado nele, defina o status para algo
  • Quando um problema é rotulado com algo em este repositório, e o ID do item é mencionado nele, defina o status para algo
  • Quando o status de um pull request muda para algo em estes repositórios, e o ID do item é mencionado nele, crie uma atualização
  • Quando um pull request é rotulado com algo em este repositório, e o ID do item é mencionado nele, defina o status para algo
  • Quando um problema é criado em estes repositórios, crie um item e sincronize futuras alterações
  • Quando um problema é criado com estes rótulos em este repositório, crie um item e sincronize futuras alterações
  • Quando um pull request é criado ou atualizado em estes repositórios, crie um item e sincronize futuras alterações
  • quando um item é criado ou atualizado, crie um problema em este repositório, com estes campos e sincronize futuras

 

Criar uma sincronização bidirecional

Uma sincronização bidirecional ocorre quando os dados são enviados tanto da monday.com para o GitHub quanto puxados do GitHub para a monday.com. Dessa forma, seus dados correspondem em ambas as plataformas e permanecem atualizados.

Group 64 (56).png

 

Para criar uma sincronização bidirecional, selecione ambas as direções no menu suspenso.

Por exemplo, se você deseja mapear a coluna Proprietário do seu item na monday.com para o campo Atribuídos no GitHub, você selecionará esses campos em cada menu suspenso respectivo. Em seguida, sob o menu suspenso Escolher direção, escolha ambas as direções.

GitHub Two-Way Sync.gif

 

O que é o ID do item?

Alguns dos modelos de integração precisam de uma “conexão única” entre a monday.com e o GitHub para sincronizar as duas plataformas, e o ID do item serve como esse número único associado ao item.

 

Group 64 (57) (1) 1.png

 

Vamos usar o modelo de integração como exemplo: “Quando um pull request é criado neste repositório, e o ID do item é mencionado no nome do pull request, altere o status para algo.”

Uma vez que o pull request é criado no GitHub, o sistema usa o ID do item na monday.com para identificar qual item precisa ser alterado.

Dica: Você pode clicar na coluna ID do item para copiar facilmente o valor automaticamente do seu quadro.

Essa menção também funcionará com o ID do item amigável (por exemplo, TASK-12)

 

Como rastrear um item de sprint

Receba atualizações instantâneas de status do monday dev toda vez que um branch for criado e um PR for mesclado. Para isso, recomenda-se usar a seguinte receita do GitHub para acompanhar sprints:

  • Quando um branch é criado nestes repositórios, e o ID do item é mencionado nele, defina o status para algo.

GitHub 3.png
Essa receita conecta itens ao GitHub usando o ID do item. Cole o ID do item no nome do branch para começar!

Essa conexão permite que você rastreie sprints em ambas as plataformas.

 

GitHub Actions

GitHub Actions é uma ferramenta integrada ao GitHub que permite automatizar tarefas dentro do seu fluxo de trabalho de desenvolvimento de software. Isso ajudará a eliminar tarefas repetitivas, tornando o processo de desenvolvimento mais eficiente.Screenshot 2024-07-07 at 17.29.51 1.png

O que o GitHub Actions pode fazer?

  • Automatizar o pipeline de CI/CD: Isso permitirá que você configure processos automáticos para construir, testar e implantar seu código sempre que houver alterações. Isso ajuda a detectar bugs mais cedo e agiliza o processo de lançamento.
  • Executar fluxos de trabalho com base em eventos: O GitHub Actions pode acionar fluxos de trabalho com base em vários eventos em seu repositório. Por exemplo, você pode criar um fluxo de trabalho que executa testes automaticamente sempre que um pull request é enviado.
  • Usar uma grande comunidade de ações: Há uma vasta coleção de ações pré-construídas disponíveis que você pode usar para várias tarefas. Essas podem ser desde implantar seu código em diferentes plataformas até criar tickets em ferramentas de gerenciamento de projetos. Você também pode criar suas próprias ações personalizadas.

Você encontrará o modelo para a integração do GitHub que abre um item em fluxos de trabalho específicos que terminam com conclusões específicas. O item pode ser preenchido com dados do fluxo de trabalho.

Para usar o modelo, navegue até a página de automação do Quadro e pesquise por GitHub. A partir daí, clique no modelo conforme abaixo.Group 1 - 2025-07-14T142521.010.png 

Nota: Para usar o GitHub Actions, o administrador da organização do GitHub deve permitir a configuração “Permissão de Leitura de Ações”. Se você encontrar algum problema com isso, entre em contato conosco. 

 

O que mais você precisa saber?

A integração funcionará mesmo se você não instalar o aplicativo no GitHub?

  • Não, a integração não é possível sem que o aplicativo esteja instalado no GitHub.

Você pode conectar minha conta da monday.com a várias organizações no GitHub?

  • Sim! Você pode conectar suas contas da monday.com a várias organizações do GitHub.

Em seguida, para desinstalar o aplicativo da monday.com do GitHub, você pode ir até sua conta do GitHub > Configurações > Aplicativos e encontrar a monday.com. Role para baixo até a Zona de Perigo e clique em Desinstalar.

 

 


Precisa de mais ajuda? O suporte da monday.com está à disposição.

E se você busca otimizar o uso da monday.com no seu time, a Audatia (parceira oficial no Brasil) tem especialistas prontos para ajudar com consultoria e treinamentos. Fale com um consultor →

Audatia é parceira autorizada monday.com no Brasil. Entre em Contato e contrate serviços.

Conteúdo relacionado

Como personalizar seu perfil

5 min de leitura Recurso Ao criar sua conta na monday.com pela primeira vez, você verá suas iniciais colocadas em um fundo colorido como sua foto de perfil. No…

Permissões do quadro no Enterprise

Perfil & administração 5 min de leitura Quem pode usar este recurso: Disponível no plano Enterprise As permissões de quadro no plano Enterprise permitem que os…

monday.com AI Notetaker

Integrações & IA 7 min de leitura Quem pode usar este recurso Disponível no monday CRM , monday work management , monday service , monday dev Disponível como…

Centro de Aprendizado da monday.com

Procurando dominar um recurso, configurar sua conta ou se manter atualizado sobre novos lançamentos? O Centro de Aprendizado é o seu hub para tutoriais,…