Verificar entregas de webhook e corrigir falhas.

Leia o registro de entrega de um endpoint de webhook Notiondesk, entenda as novas tentativas e as pausas, retome um endpoint pausado e corrija as entregas com falha.

5 min de leitura

Cada ponto de extremidade mantém um registro das solicitações enviadas a ele. Use-o para ver o que seu servidor recebeu, por que uma solicitação falhou e quando ela será tentada novamente.

Caminho rápido: Acesse Configurações > Desenvolvedores > Webhooks , abra um endpoint e role até Entregas recentes . Clique em uma linha para ver a resposta e o corpo da solicitação.

Leia as entregas recentes

  1. Acesse Configurações > Desenvolvedores > Webhooks .
  1. Clique no ponto final.
  1. Deslize para a seção Entregas recentes .

A lista exibe as 100 entregas mais recentes dos últimos 14 dias. Cada linha mostra o evento, a central de ajuda de onde veio (ou Workspace ), o resultado e a hora.

Ícone Status O que significa
visto verde Entregue Seu servidor respondeu com um código de status 2xx
Relógio laranja Pendente Ainda não foi enviado ou está aguardando a próxima tentativa. Uma tentativa falha mostra o resultado seguido de "tentando novamente ", como em "503, tentando novamente".
Cruz vermelha Fracassado Todas as tentativas falharam. A linha mostra o último resultado.
Cinza menos Cancelado Não foi enviado porque o endpoint foi pausado ou desligado, ou porque sua central de ajuda não pôde mais receber eventos, antes da próxima tentativa.

Abra uma entrega

Clique em uma linha para abri-la:

  • ID de entrega : o mesmo valor do cabeçalho X-ND-Delivery, para que você possa encontrar a solicitação nos registros do seu servidor.
  • Resposta : o código de status ou motivo da falha, quanto tempo seu servidor levou e quantas tentativas foram feitas.
  • Corpo da solicitação : o JSON exato que foi enviado. Clique em Copiar para copiá-lo.

Os corpos das respostas não são armazenados. Para eventos que contêm dados pessoais, como mensagens de contato, feedback, colegas de equipe e solicitações de participação, o corpo da solicitação é removido assim que a entrega é concluída.

Tentativas repetidas

Uma entrega falha quando seu servidor responde com qualquer código de status diferente de 2xx, redireciona, não começa a responder em 5 segundos ou leva mais de 10 segundos no total. Notiondesk tenta novamente:

Tentar Quando
1 Agora mesmo
2 1 minuto após a primeira tentativa
3 10 minutos após a segunda tentativa
4 1 hora após a terceira tentativa
5 6 horas após a quarta tentativa

Após 5 tentativas falhas, a entrega é marcada como Falhou . Eventos de teste e entregas marcadas como Falha na assinatura não são repetidas.

Quando muitos eventos acontecem simultaneamente, por exemplo, durante uma sincronização em grande escala, as entregas podem aguardar antes de serem enviadas: geralmente alguns minutos, podendo chegar a uma hora se o seu servidor demorar a responder. Elas permanecem pendentes e não são descartadas.

Quando um ponto de extremidade é pausado

Notiondesk pausa um endpoint quando 10 entregas consecutivas falham após todas as tentativas, e a primeira dessas falhas ocorreu há pelo menos 24 horas. Eventos de teste não são contabilizados.

Quando um endpoint é pausado:

  • Aparece o status "Pausado" e para de receber eventos. As tentativas que já estavam planejadas são canceladas.
  • O proprietário do espaço de trabalho e os administradores recebem um único e-mail, "Ponto de extremidade do webhook pausado", com o nome do ponto de extremidade, seu host e um link para as configurações do webhook.
  • Os eventos ocorridos durante o período de pausa não serão enviados posteriormente.

Resumindo:

  1. Corrija o problema no seu servidor. Os motivos da falha em Entregas recentes indicam o que deu errado.
  1. Clique em Enviar evento de teste e verifique se ele aparece como Entregue .
  1. Clique em Retomar .

O ponto de extremidade volta a receber novos eventos e sua contagem de falhas recomeça.

Se o seu endpoint ainda estiver ativo, mas as entregas continuarem falhando, a página do endpoint exibirá "Falhando desde" com a data da primeira falha, como um aviso antes de ser pausado.

Corrigir entregas com falha

Quando o servidor responde, a linha exibe o código de status. Caso contrário, exibe o motivo.

Razão O que você vê O que aconteceu Como resolver isso
Status de erro O código de status, como 500 ou 401. Seu servidor respondeu com um erro. Verifique os logs do seu servidor referentes a esse horário. Certifique-se de que o endpoint aceite solicitações POST e que sua verificação de assinatura utilize o segredo correto.
Redirecionamento recusado Um código de redirecionamento, como 301 ou 302. Seu servidor redirecionou a solicitação. Insira o URL final nas configurações do endpoint.
Endereço bloqueado Endereço bloqueado Seu domínio aponta para um endereço privado ou interno. Aponte o domínio para um servidor público.
Falha na conexão Falha na conexão Notiondesk não conseguiu acessar seu servidor Verifique se o domínio está sendo resolvido, se o certificado TLS é válido e se a porta 443 ou 8443 está aberta.
Tempo limite excedido Tempo limite excedido Seu servidor não começou a responder em 5 segundos ou levou mais de 10 segundos. Responda primeiro com 200, depois faça o trabalho em segundo plano.
A assinatura falhou A assinatura falhou Notiondesk não conseguiu assinar a solicitação Isso está do nosso lado e não será repetido. Envie um evento de teste e entre em contato conosco se o problema ocorrer novamente.

Enviar um evento de teste

Clique em Enviar evento de teste na página do endpoint para enviar um evento ping para esse endpoint. Ele aparece no topo de Entregas recentes .

  • Um evento de teste é enviado uma única vez, sem novas tentativas.
  • Você pode enviar a solicitação enquanto o endpoint estiver pausado, para verificar a correção antes de retomar a operação.
  • Cada espaço de trabalho pode enviar até 20 eventos de teste por hora. Se ultrapassar esse limite, você verá a mensagem "Muitos eventos de teste. Tente novamente mais tarde."

Perguntas frequentes

Posso reenviar uma entrega que falhou?

Não. Abra a entrega e clique em Copiar para obter o conteúdo da solicitação, caso precise processá-la você mesmo.

Por que o corpo da solicitação de entrega está faltando?

O evento continha dados pessoais, portanto, seu conteúdo foi removido após a conclusão da entrega.

Por quanto tempo as entregas são armazenadas?

14 dias. As entregas recentes mostram as 100 últimas.

Um evento de teste bem-sucedido reativa um endpoint pausado?

Não. Ele apenas verifica seu servidor. Clique em "Retomar" para voltar a receber eventos.

O que acontece aos eventos enfileirados se eu excluir um endpoint?

Eles não são enviados e o registro de entrega do endpoint é excluído juntamente com eles.

Artigos relacionados

Esta página foi útil?

Still need help? Ask us