Integrações do Projeto

A aba Integrações permite conectar o GitScrum com serviços externos para sincronizar fluxos de desenvolvimento e receber notificações em tempo real. Conecte plataformas de controle de versão para vincular commits e issues a tarefas, ou configure ferramentas de comunicação para receber atualizações do projeto nos canais de chat da sua equipe.

Visão Geral

A interface exibe um layout de dois painéis. A barra lateral esquerda lista todos os provedores de integração disponíveis organizados por categoria. O painel direito mostra as opções de configuração para o provedor selecionado. Um contador no cabeçalho mostra quantas integrações estão atualmente ativas.

Integrações Disponíveis

Integrações Nativas:

Slack - Notificações via webhook para canais
Microsoft Teams - Notificações via webhook para canais
Discord - Notificações via webhook para canais
GitHub (Pro) - Conexão de repositório com sincronização de issues/commits
GitLab (Pro) - Conexão de repositório com sincronização de issues/commits
Bitbucket (Pro) - Conexão de repositório com sincronização de commits

Integrações Externas:

Zapier - Conecte com mais de 3.000 aplicativos
Pabbly - Automações de fluxo de trabalho
Documentação da API - Link para documentação da API REST

Integrações de Comunicação

Slack, Discord e Microsoft Teams usam URLs de webhook para receber notificações. O processo de configuração é idêntico para os três provedores.

Conectando uma Plataforma de Comunicação

Selecione o provedor na barra lateral esquerda (Slack, Discord ou Teams)
Obtenha uma URL de webhook da sua plataforma:

Slack: Crie um Incoming Webhook nas configurações do workspace
Discord: Crie um webhook nas configurações do canal
Teams: Adicione um conector Incoming Webhook ao seu canal

Cole a URL do webhook no campo URL do Webhook
Clique em Validar para testar a conexão
Opcionalmente insira um Nome do Canal para referência
Ative Integração Ativa para habilitar notificações
Clique em Ativar Integração para salvar

Opções de Configuração do Webhook

URL do Webhook: A URL completa do webhook da sua plataforma. Campo obrigatório.

Nome do Canal: Rótulo opcional para sua referência. Não afeta a funcionalidade.

Integração Ativa: Controle principal para ativar ou desativar todas as notificações desta integração.

Notificar Próprias Ações: Quando ativado, você recebe notificações por ações que você mesmo executa. Quando desativado, apenas ações de outros membros da equipe disparam notificações.

Eventos de Notificação

Após ativar uma integração, configure quais eventos disparam notificações. Os eventos são organizados em categorias expansíveis:

Ciclo de Vida da Tarefa:

Tarefa criada
Tarefa excluída

Status da Tarefa:

Tarefa movida para diferente estágio do workflow
Tarefa concluída
Tarefa bloqueada
Tarefa desbloqueada

Atribuição de Tarefa:

Tarefa atribuída a membro da equipe

Comentários:

Comentário criado na tarefa
Usuário mencionado em comentário

Sprint:

Sprint iniciado
Sprint concluído

Equipe:

Membro entrou no projeto
Membro saiu do projeto

Cada evento possui um toggle individual. Use os links Ativar Todos ou Desativar Todos nos cabeçalhos das categorias para configurar rapidamente múltiplos eventos.

Testando e Gerenciando

Testar Conexão: Clique em Testar no cabeçalho para enviar uma notificação de teste e verificar se o webhook funciona corretamente.

Remover Integração: Clique em Remover no cabeçalho para excluir a configuração da integração. Um modal de confirmação requer reconhecimento antes da exclusão.

Integrações de Controle de Versão

As integrações do GitHub, GitLab e Bitbucket conectam repositórios para sincronizar issues, comentários e commits com tarefas do GitScrum. Essas integrações requerem assinatura Pro.

Configuração do GitHub

Selecione GitHub na barra lateral
Gere um Personal Access Token no GitHub com escopos repo e admin:repo_hook
Cole o token no campo Personal Access Token
Clique em Salvar Token para validar e armazenar
Clique no botão de atualização para carregar seus repositórios
Selecione um repositório no dropdown
Clique em Conectar Repositório

Configurações de Sincronização do GitHub

Após conectar um repositório, configure as opções de sincronização:

Issues:

Criar quando issue é aberta: Cria uma tarefa GitScrum quando uma issue do GitHub é aberta. Opcionalmente atribua a um estágio específico do workflow.
Atualizar quando issue é fechada: Move a tarefa vinculada quando a issue do GitHub fecha. Opcionalmente mova para um estágio específico do workflow.
Atualizar quando issue é reaberta: Atualiza o status da tarefa quando a issue é reaberta.
Atualizar quando issue é editada: Sincroniza alterações de título/descrição.
Excluir quando issue é excluída: Remove a tarefa vinculada quando a issue é excluída.

Comentários:

Sincronizar novos comentários: Adiciona comentários de issues do GitHub às tarefas vinculadas.
Sincronizar comentários editados: Atualiza comentários da tarefa quando comentários do GitHub são alterados.
Remover comentários excluídos: Exclui comentários da tarefa quando comentários do GitHub são removidos.

Commits e Pull Requests:

Vincular commits a tarefas: Associa commits que mencionam IDs de tarefas com as tarefas. Use códigos de tarefa nas mensagens de commit para vincular automaticamente.
Mover ao mesclar: Opcionalmente mova tarefas vinculadas para um estágio específico do workflow quando commits são mesclados.

Ações Adicionais do GitHub

Importar Issues: Clique em Importar Issues para importar issues existentes do GitHub como tarefas do GitScrum.

Desconectar: Clique em Desconectar GitHub para remover a conexão do repositório.

GitLab e Bitbucket

GitLab e Bitbucket seguem o mesmo padrão de configuração:

Gere um Personal Access Token da sua plataforma
Insira o token e valide
Selecione e conecte um repositório
Configure as configurações de sincronização para issues, comentários e commits

Integrações Externas

A barra lateral inclui links para plataformas de integração externas:

Zapier: Abre a página de integração do GitScrum no Zapier onde você pode conectar com mais de 3.000 aplicativos usando fluxos de trabalho automatizados.

Pabbly: Abre a página de integração do GitScrum no Pabbly para criar automações de fluxo de trabalho.

Documentação da API: Abre a documentação da API REST do GitScrum para construir integrações personalizadas.

Esses links abrem em novas abas do navegador e não requerem configuração dentro do GitScrum.

Indicadores de Status da Integração

Cada provedor na barra lateral mostra seu status atual:

Ponto verde + "Conectado" - Integração está ativa e funcionando
"Não configurado" - Nenhuma integração configurada para este provedor
Contador ativo - Cabeçalho mostra o total de integrações ativas

Boas Práticas

Comece com eventos essenciais: Habilite apenas notificações críticas inicialmente, depois expanda com base no feedback da equipe.
Use nomes de canal: Adicione nomes de canal descritivos para identificar facilmente qual canal recebe quais notificações.
Teste antes de implantar: Sempre use os botões Validar e Testar antes de confiar em uma integração.
Revise regularmente: Revise periodicamente os eventos habilitados para prevenir fadiga de notificações.

Recursos Relacionados

Webhooks - Configuração de webhook personalizado para automação avançada
Acesso à API - Gere tokens de API para integrações personalizadas