Visão Geral das Integrações
O GitScrum Studio conecta-se com as ferramentas que já usa. Desde controlo de versão a plataformas de comunicação, as integrações estendem o seu workflow para além da gestão de projetos.
Integrações Disponíveis
Controlo de Versão
| Integração | Funcionalidades |
|---|---|
| GitHub | Ligar PRs, sincronizar issues, auto-atualizações |
| GitLab | Links de merge request, sincronização de issues |
| Bitbucket | Integração de pull request |
Comunicação
| Integração | Funcionalidades |
|---|---|
| Slack | Notificações, criação de tarefas de mensagens |
| Discord | Notificações de canal |
| Microsoft Teams | Alertas e atualizações |
Calendário
| Integração | Funcionalidades |
|---|---|
| Google Calendar | Sincronizar deadlines, reuniões |
| Outlook Calendar | Datas de entrega como eventos |
Desenvolvimento
| Integração | Funcionalidades |
|---|---|
| Webhooks | Notificações de eventos personalizadas |
| API | Acesso programático completo |
Configurar Integrações
Nível Workspace
Algumas integrações aplicam-se a todo o workspace:
- Vá a Definições de Workspace
- Selecione Integrações
- Escolha a integração
- Siga o fluxo de autorização
- Configure definições
Nível Projeto
Outras são específicas de projeto:
- Abra Definições do Projeto
- Selecione separador Integrações
- Ative integrações desejadas
- Configure por integração
Integração GitHub
Conectar
- Vá a Definições de Workspace > Integrações
- Clique "Conectar GitHub"
- Autorize o GitScrum
- Selecione repositórios
Funcionalidades
Link de Pull Request
- Referencie tarefa #123 no título/descrição do PR
- Tarefa mostra PR linkado com estado
- Merge de PR pode auto-transicionar tarefa
Referências de Commit
- Inclua número de tarefa na mensagem de commit
- Commits aparecem na atividade da tarefa
Criação de Branch
- Crie branch a partir da tarefa
- Convenção de nome:
feature/123-titulo-tarefa
Integração Slack
Conectar
- Vá a Definições de Workspace > Integrações
- Clique "Adicionar ao Slack"
- Escolha workspace
- Selecione canal padrão
Funcionalidades
Notificações
- Tarefa criada/atualizada
- Comentários adicionados
- Atribuições alteradas
- Datas de entrega a aproximar
Comandos
/gitscrum create- Criar tarefa do Slack/gitscrum search- Encontrar tarefas/gitscrum timer- Iniciar rastreamento de tempo
Integração Webhook
Casos de Uso
- Notificações personalizadas para seus sistemas
- Integração com ferramentas internas
- Logging de auditoria
- Desencadear workflows externos
Configurar Webhooks
- Vá a Definições do Projeto > Webhooks
- Clique "Adicionar Webhook"
- Introduza:
- URL do endpoint (HTTPS obrigatório)
- Chave secreta (para verificação de assinatura)
- Eventos a desencadear
- Guardar
Eventos Disponíveis
| Evento | Desencadeia |
|---|---|
task.created | Nova tarefa adicionada |
task.updated | Tarefa modificada |
task.deleted | Tarefa removida |
task.moved | Estado alterado |
comment.created | Novo comentário |
sprint.started | Sprint começa |
sprint.ended | Sprint termina |
time.logged | Entrada de tempo adicionada |
Acesso API
Chaves API
- Vá a Definições de Workspace > API
- Clique "Gerar Chave API"
- Nomeie a chave
- Copie a chave (mostrada apenas uma vez)
Documentação
Documentação completa da API disponível em:
- Referência da API
- Playground interativo nas definições
- Download de spec OpenAPI/Swagger
Sincronização de Calendário
Google Calendar
- Conecte conta Google
- Selecione calendário para sincronização
- Configure definições de sincronização:
- Datas de entrega como eventos
- Datas de sprint como eventos
- Datas de milestone
Permissões de Integração
Quem Pode Configurar
| Ação | Função Necessária |
|---|---|
| Adicionar integrações workspace | Agency Owner |
| Configurar integrações projeto | Manager, Agency Owner |
| Usar integrações | Todos os membros |
| Gerar chaves API | Agency Owner |
Resolução de Problemas
Integração Não Funciona
- Verifique estado da conexão nas definições
- Verifique se OAuth não expirou
- Re-autorize se necessário
- Verifique logs de entrega de webhook
Falhas de Webhook
Veja histórico de entrega:
- Vá a Definições do Projeto > Webhooks
- Clique no webhook
- Veja entregas recentes
- Verifique códigos de resposta
Como Reportar um Problema ou Solicitar uma Funcionalidade
Se uma integração não funciona ou precisa de uma nova integração, submeta feedback através do GitScrum Studio. Na Barra Lateral, clique em Tickets de Suporte e abra um ticket.