6 min leitura • Guide 96 of 877
Conectando Integrações
Equipes de desenvolvimento modernas usam muitas ferramentas—GitHub, Slack, aplicativos de calendário, sistemas CI/CD e mais. As integrações do GitScrum conectam essas ferramentas para que as informações fluam automaticamente, reduzindo a troca de contexto e mantendo tudo sincronizado.
Categorias de Integração
| Categoria | Integrações | Propósito |
|---|---|---|
| Controle de Versão | GitHub, GitLab, Bitbucket | Código ↔ Tarefas |
| Comunicação | Slack, Teams, Email | Notificações |
| Calendário | Google, Outlook | Datas de vencimento, reuniões |
| Automação | Zapier, Webhooks | Fluxos de trabalho personalizados |
| CI/CD | GitHub Actions, Jenkins | Status de build |
Integrações Principais
Integração com GitHub
INTEGRAÇÃO COM GITHUB
═════════════════════
RECURSOS:
├── Vincular commits a tarefas
├── Atualização automática na fusão de PR
├── Criação de branches a partir de tarefas
├── Visibilidade do status de build
└── Rastreamento de revisão de PR
CONFIGURAÇÃO:
1. Configurações → Integrações → GitHub
2. Clique em "Conectar GitHub"
3. Autorizar aplicativo GitScrum
4. Selecionar repositórios
5. Mapear para projetos
CONFIGURAÇÃO:
├── Padrão de ID de tarefa: GS-[0-9]+
├── Transição automática na fusão: ✓
├── Mostrar commits na tarefa: ✓
├── Criar branches: ✓
└── Sincronizar comentários de PR: Opcional
Integração com Slack
INTEGRAÇÃO COM SLACK
════════════════════
RECURSOS:
├── Notificações de tarefas para canais
├── Criar tarefas do Slack
├── Resumos diários/semanais
├── Alertas de menção
└── Comandos slash
CONFIGURAÇÃO:
1. Configurações → Integrações → Slack
2. Clique em "Adicionar ao Slack"
3. Autorizar permissões
4. Selecionar workspace
5. Configurar canais
MAPEAMENTO DE CANAIS:
┌─────────────────────────────────────────────────┐
│ Projeto/Evento │ Canal Slack │
├─────────────────────────────────────────────────┤
│ Projeto Website │ #website-dev │
│ Bugs Críticos │ #alerts │
│ Atualizações Sprint │ #team-standups │
│ Todos os Comentários │ (Desabilitado) │
└─────────────────────────────────────────────────┘
COMANDOS SLASH:
├── /gs create [nome da tarefa] - Criar tarefa
├── /gs search [consulta] - Encontrar tarefas
├── /gs my - Minhas tarefas abertas
└── /gs sprint - Resumo do sprint
Integração com Calendário
INTEGRAÇÃO COM CALENDÁRIO
═════════════════════════
RECURSOS:
├── Datas de vencimento como eventos de calendário
├── Sincronização de datas de sprint
├── Sincronização de tarefas de reunião
├── Visualização de disponibilidade
└── Eventos de lembrete
CONFIGURAÇÃO DO GOOGLE CALENDAR:
1. Configurações → Integrações → Google Calendar
2. Conectar conta Google
3. Selecionar calendários
4. Configurar opções de sincronização
OPÇÕES DE SINCRONIZAÇÃO:
├── Datas de vencimento → Eventos de calendário: ✓
├── Sprints → Blocos de calendário: ✓
├── Apenas tarefas atribuídas: ✓
├── Incluir subtarefas: ✗
└── Lembrete antes do vencimento: 1 dia
VISUALIZAÇÃO DO CALENDÁRIO:
┌─────────────────────────────────────────────────┐
│ Março 2024 │
├─────────────────────────────────────────────────┤
│ Seg 18 │ GS-123: Revisão de API vence │
│ Qua 20 │ Sprint 15 termina │
│ Qui 21 │ Sprint 16 começa │
│ Sex 22 │ GS-456: Implantar v2.1 │
└─────────────────────────────────────────────────┘
Integrações de Automação
Integração com Zapier
INTEGRAÇÃO COM ZAPIER
═════════════════════
GATILHOS (GitScrum → Outros):
├── Tarefa criada
├── Status da tarefa alterado
├── Tarefa atribuída
├── Comentário adicionado
├── Sprint iniciado/terminado
└── Data de vencimento se aproximando
AÇÕES (Outros → GitScrum):
├── Criar tarefa
├── Atualizar tarefa
├── Adicionar comentário
├── Atribuir tarefa
├── Adicionar rótulo
└── Criar projeto
EXEMPLOS DE ZAPS:
─────────────────────────────────────
ZAP 1: Suporte ao Cliente → Dev
Gatilho: Novo ticket Zendesk (bug)
Ação: Criar tarefa GitScrum
Mapear: Prioridade, descrição, link
ZAP 2: Tarefa → CRM
Gatilho: Tarefa concluída (rótulo:cliente)
Ação: Atualizar estágio do negócio HubSpot
ZAP 3: Formulário → Tarefa
Gatilho: Envio do Typeform
Ação: Criar tarefa GitScrum
Incluir: Respostas do formulário
─────────────────────────────────────
Webhooks
CONFIGURAÇÃO DE WEBHOOK
═══════════════════════
WEBHOOKS DE SAÍDA (GitScrum → Seu Servidor):
Evento: Status da tarefa alterado
URL: https://seu-servidor.com/webhook
Método: POST
Cabeçalhos:
├── Content-Type: application/json
├── X-GitScrum-Signature: [hmac]
└── Authorization: Bearer [token]
Carga útil:
{
"event": "task.status_changed",
"task": {
"id": "GS-123",
"title": "Nome da tarefa",
"status": "done",
"previous_status": "in_review"
},
"actor": {
"id": "user_456",
"name": "João Silva"
},
"timestamp": "2024-03-15T10:30:00Z"
}
WEBHOOKS DE ENTRADA (Externo → GitScrum):
URL: https://api.gitscrum.com/webhook/abc123
Uso: Criar tarefas, atualizar status via API
Acesso à API
INTEGRAÇÃO COM API
══════════════════
AUTENTICAÇÃO:
├── Tokens de Acesso Pessoal
├── OAuth 2.0 para aplicativos
└── Chaves de API para serviços
ENDPOINTS:
├── GET /api/v1/tasks
├── POST /api/v1/tasks
├── PUT /api/v1/tasks/{id}
├── GET /api/v1/projects
├── GET /api/v1/sprints
└── POST /api/v1/comments
LIMITES DE TAXA:
├── 100 solicitações/minuto (padrão)
├── 1000 solicitações/minuto (enterprise)
└── Burst: 10 solicitações/segundo
EXEMPLO:
curl -X POST https://api.gitscrum.com/v1/tasks \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json" \
-d '{"title": "Nova tarefa", "project_id": "proj_123"}'
Gerenciamento de Integrações
Dashboard
DASHBOARD DE INTEGRAÇÃO
═══════════════════════
┌─────────────────────────────────────────────────────────┐
│ Integrações Conectadas │
├─────────────────────────────────────────────────────────┤
│ │
│ GitHub ✓ Conectado │
│ ├── 5 repositórios │
│ ├── Última sincronização: há 2 min │
│ └── [Configurar] [Desconectar] │
│ │
│ Slack ✓ Conectado │
│ ├── 3 canais configurados │
│ ├── 247 notificações hoje │
│ └── [Configurar] [Desconectar] │
│ │
│ Google Calendar ✓ Conectado │
│ ├── 2 calendários sincronizados │
│ ├── 12 eventos sincronizados │
│ └── [Configurar] [Desconectar] │
│ │
│ Zapier ✓ Conectado │
│ ├── 4 zaps ativos │
│ └── [Ver no Zapier] │
│ │
├─────────────────────────────────────────────────────────┤
│ [+ Adicionar Integração] │
└─────────────────────────────────────────────────────────┘
Solução de Problemas
SAÚDE DA INTEGRAÇÃO
═══════════════════
PROBLEMAS COMUNS:
├── Token expirado → Reautorizar
├── Limitação de taxa → Verificar uso
├── Webhook falhou → Verificar endpoint
├── Sincronização atrasada → Verificar status
└── Dados ausentes → Verificar mapeamento
LOGS:
┌─────────────────────────────────────────────────────────┐
│ Logs de Integração (últimas 24h) │
├─────────────────────────────────────────────────────────┤
│ 10:30 ✓ GitHub: PR #234 sincronizado com GS-123 │
│ 10:28 ✓ Slack: Notificação enviada para #dev │
│ 10:25 ✗ Webhook: Tempo limite de conexão (tentando) │
│ 10:20 ✓ Calendário: 3 eventos sincronizados │
└─────────────────────────────────────────────────────────┘
Melhores Práticas
Para Integrações
- Comece essencial — GitHub + Slack primeiro
- Mapeie com cuidado — Canais certos para eventos certos
- Não exagere nas notificações — Filtre para eventos importantes
- Monitore a saúde — Verifique o status das integrações
- Proteja tokens — Rotacione regularmente
Anti-Padrões
ERROS DE INTEGRAÇÃO:
✗ Muitas notificações
✗ Não testar endpoints de webhook
✗ Ignorar sincronizações falhadas
✗ Expor tokens de API
✗ Cadeias complexas do Zapier
✗ Sem documentação de integração