Editar, girar, desativar ou excluir um webhook

Alterar o URL, o nome ou os eventos de um endpoint de webhook Notiondesk, rotacionar seu segredo de assinatura, desativá-lo ou ativá-lo, ou excluí-lo.

3 min de leitura

Você pode alterar um endpoint a qualquer momento a partir da página dele: editar o URL, o nome ou os eventos, rotacionar a chave de assinatura, desativá-lo temporariamente ou excluí-lo.

Caminho rápido: Acesse Configurações > Desenvolvedores > Webhooks e clique no endpoint. Edite-o e clique em Salvar alterações ou use Mais ações ( ... ) para desativá-lo ou excluí-lo.

Antes de começar

Você é o proprietário do espaço de trabalho ou um administrador. Outras funções não podem abrir a página de Webhooks.

Editar um ponto final

  1. Acesse Configurações > Desenvolvedores > Webhooks e clique no endpoint.
  1. Altere o URL ou o nome .
  1. Em Eventos , clique em Adicionar um evento para adicionar eventos ou clique no "x" ao lado de um evento para removê-lo. Mantenha pelo menos um evento.
  1. Clique em Salvar alterações .

Os novos eventos utilizam as configurações atualizadas. Ao alterar o URL, a contagem de falhas recomeça e as novas tentativas já agendadas são direcionadas para o novo URL.

Gire o segredo de assinatura

Gire o segredo caso ele tenha vazado ou se você o perdeu.

  1. Na página do endpoint, em Segredo de assinatura , clique em Girar .
  1. Clique em Girar para confirmar.
  1. Clique em Copiar , armazene o novo segredo no seu servidor e, em seguida, clique em Eu salvei .
A senha secreta antiga deixa de funcionar imediatamente. Todas as requisições enviadas após a rotação, incluindo novas tentativas, são assinadas com a nova senha secreta, portanto, atualize seu servidor ao mesmo tempo.

Verificar se um webhook vem de Notiondesk mostra como seu servidor usa o segredo.

Desativar ou ativar um endpoint

Desative um endpoint para interromper o envio de eventos sem excluí-lo, por exemplo, enquanto você trabalha no seu servidor.

  1. Na página do endpoint, clique em Mais ações ( ... ).
  1. Clique em Desativar .

O endpoint mostra "Desativado" . Embora esteja desativado:

  • Não recebe nenhum evento. Os eventos que ocorrem nesse ínterim não são salvos e nunca são enviados, mesmo depois de você habilitá-lo novamente.
  • Os novos testes que já estavam planejados foram cancelados.
  • Você ainda pode clicar em Enviar evento de teste .

Para reativá-lo, clique em Mais ações ( ... ), depois em Ativar . Ele receberá novos eventos novamente e sua contagem de falhas recomeçará.

Se o endpoint mostrar "Pausado" , significa que o Notiondesk o desativou após repetidas falhas. Clique em "Retomar" quando o servidor estiver funcionando. A verificação das entregas de webhook e a correção de falhas explicam por que os endpoints são pausados.

Excluir um endpoint

  1. Na página do endpoint, clique em Mais ações ( ... ).
  1. Clique em Excluir .
  1. Clique em Excluir para confirmar.
A exclusão é irreversível. O log de entrega do endpoint é excluído junto com a ação, e os eventos enfileirados não são enviados.

Perguntas frequentes

Perco eventos enquanto um endpoint estiver desativado?

Sim. Os eventos que ocorrem enquanto o recurso está desativado nunca são enviados. Se você precisar apenas alterar a URL ou os eventos, edite o endpoint.

Posso ver o antigo segredo de assinatura após a rotação?

Não. Cada segredo é exibido apenas uma vez, quando você adiciona o endpoint ou o rotaciona. A página do endpoint mostra apenas seus primeiros caracteres.

Alterar os eventos afeta as entregas anteriores?

Não. As entregas anteriores permanecem em Entregas recentes . Somente os eventos que ocorrem depois de você salvar utilizam a nova lista.

Posso restaurar um endpoint excluído?

Não. Adicione um novo endpoint com a mesma URL e eventos. Ele receberá um novo segredo de assinatura.

Artigos relacionados

Esta página foi útil?

Still need help? Ask us