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.
Leia as entregas recentes
- Acesse Configurações > Desenvolvedores > Webhooks .
- Clique no ponto final.
- 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:
- Corrija o problema no seu servidor. Os motivos da falha em Entregas recentes indicam o que deu errado.
- Clique em Enviar evento de teste e verifique se ele aparece como Entregue .
- 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.