Webhooks

Webhooks enviam um POST HTTPS para seu servidor sempre que algo acontece no Serpfull. Gerencie-os em Integrações → Webhooks (proprietários e administradores). Para o formato do payload, cabeçalhos e código de verificação, veja a referência da API de Webhooks.

Verificando assinaturas

• Abra Integrações → Webhooks e pressione Adicionar endpoint.
• Digite uma URL https pública na porta 443. Endereços privados, internos, loopback, link-local e metadados de nuvem são recusados (verificamos todos os endereços que o host resolve, ao salvar e novamente a cada entrega), e redirecionamentos não são seguidos.
• Adicione uma descrição opcional, escolha os sites que cobre (todos os sites, incluindo futuros, ou alguns selecionados) e marque os eventos a enviar.
• Copie o segredo de assinatura mostrado após salvar. Você pode revelá-lo novamente no cartão do endpoint, ou rotacioná-lo.

Novas tentativas

Responda com qualquer 2xx em 10 segundos. Qualquer outra coisa, ou um tempo limite, será tentado novamente após 1 minuto, 5 minutos, 30 minutos, 2 horas, 6 horas, 12 horas e 24 horas; após 8 tentativas, a entrega é marcada como falha. Responda 410 Gone para interromper novas tentativas desse evento. Configurações → Webhooks mostra entregas recentes, permite tentar novamente uma que falhou e enviar um test.ping.

Idempotência

As entregas são pelo menos uma vez. Cada solicitação carrega Serpfull-Event-Id (também o campo id no corpo); armazene-o e ignore as repetições. Serpfull-Delivery-Attempt informa qual tentativa é essa.

Regras de endpoint

Os endpoints devem ser URLs HTTPS públicos na porta 443. Endereços privados, de loopback e de link local são recusados ​​e os redirecionamentos não são seguidos.

Repetições e desativação

Responda com qualquer 2xx dentro de 10 segundos. Caso contrário, tentamos novamente após 1 minuto, 5 minutos, 30 minutos, 2 horas, 6 horas, 12 horas e 24 horas (8 tentativas, cerca de 45 horas). Responda 410 Gone para parar de tentar esse evento. Se um endpoint continuar falhando por 3 dias (e pelo menos 10 tentativas consecutivas), desativamos ele, descartamos seus eventos na fila e notificamos sua equipe no app. A integração de Webhooks então mostra Precisa de atenção. Corrija o receptor e reative o endpoint.

Rotacionando o segredo

Rotacionar segredo fornece um novo segredo imediatamente. Nas próximas 24 horas, cada requisição é assinada com o segredo novo e o antigo (dois valores v1), para que você possa atualizar seu receptor sem perder eventos.

De um assistente

O conector de IA tem webhooks_list_endpoints, webhooks_create_endpoint, webhooks_update_endpoint, webhooks_delete_endpoint, webhooks_send_test, webhooks_list_deliveries e webhooks_redeliver. Segredos são mostrados apenas no dashboard.