GitScrum / Docs

Configurar Endpoints

Configure URLs de endpoints de webhook nas Configurações do Projeto GitScrum. Gerencie assinaturas de eventos, teste endpoints e monitore webhooks ativos.

Configure endpoints de webhook no GitScrum para receber notificações em tempo real de eventos do projeto. Cada tipo de evento tem sua própria URL de endpoint, dando controle granular sobre quais eventos vão para onde.

Acessando as Configurações de Webhook

  1. Abra seu projeto no GitScrum
  2. Clique em Settings na barra lateral do projeto
  3. Selecione a aba Webhooks

A página de configuração de webhooks exibe uma tabela com todos os eventos disponíveis organizados por categoria.

Visão Geral da Interface

Cabeçalho

O cabeçalho mostra:

  • Título Webhook Endpoints
  • Contagem carregada — Número total de eventos de webhook disponíveis
  • Contagem ativa — Número de eventos com endpoints configurados
  • Botão Test All — Envia requisições de teste para todos os webhooks ativos

Tabela de Eventos

Cada linha na tabela contém:

ColunaDescrição
StatusPonto verde = ativo, ponto cinza = inativo
EventNome e identificador do evento
EndpointCampo de entrada de URL para o servidor receptor
ActionsBotões de Teste (ícone de pulso) e Excluir (ícone X)

Categorias

Os eventos são agrupados em quatro categorias expansíveis:

  • Tasks — Criação de tarefas, atualizações, movimentações, responsáveis, controle de tempo, comentários, anexos, vídeos
  • User Stories — Criação, atualizações, votação e exclusão de user stories
  • Sprints — Criação, atualizações e exclusão de sprints
  • Others — Votação de discussões

Clique no cabeçalho de uma categoria para expandir ou recolher seus eventos. O cabeçalho mostra a contagem ativo/total (ex: "3/12").

Adicionando um Endpoint

  1. Expanda a categoria que contém seu evento alvo
  2. Clique no campo de URL do endpoint na linha do evento
  3. Insira uma URL HTTP ou HTTPS válida
  4. Pressione Enter ou clique fora do campo
  5. O indicador de status fica verde em caso de sucesso

O endpoint é salvo imediatamente via API. Nenhum botão adicional "Salvar" é necessário.

Removendo um Endpoint

  1. Clique no ícone X na coluna Actions
  2. A URL do endpoint é limpa
  3. O indicador de status fica cinza
  4. Nenhum evento adicional é enviado para aquele endpoint

Testando Webhooks

Testar um Único Endpoint

  1. Configure uma URL de endpoint para um evento
  2. Clique no ícone de teste (ícone de pulso) na coluna Actions
  3. Um payload de teste é enviado para seu endpoint
  4. Verifique a mensagem de status abaixo do campo de entrada

Testar Todos os Endpoints

Clique no botão Test All no cabeçalho para enviar requisições de teste para todos os webhooks ativos simultaneamente. Isso verifica toda sua configuração de uma vez.

Usando a Mesma URL para Múltiplos Eventos

Você pode configurar a mesma URL de endpoint para múltiplos eventos. Seu servidor pode diferenciar eventos examinando o payload da requisição, que inclui o tipo de recurso.

Para configurar em massa, insira a mesma URL no campo de endpoint de cada evento.

Permissões

Apenas usuários com roles de Manager ou Owner podem configurar webhooks. Outros membros da equipe podem visualizar a configuração de webhooks, mas não podem modificar endpoints.

Requisitos do Plano

Webhooks requerem um plano Pro ou superior. A interface de configuração de webhooks é visível em todos os planos, mas a ativação de endpoints é restrita ao recurso Pro.

Relacionado