Assinar entregas de webhook

Cada entrega de webhook de saída é assinada com HMAC-SHA256. Um webhook salvo sem um segredo recebe um, que é exibido uma única vez; um webhook sem segredo é exibido como Não Assinado — nenhum segredo definido e suas entregas não são enviadas até que um seja definido.

• Plataforma › Eventos e Webhooks › Webhooks › Novo: um webhook salvo sem uma chave secreta de assinatura (ou salvo novamente como ativo sem uma) recebe uma chave secreta forte, exibida uma única vez, com um botão de copiar. Copie-a para o destinatário; ela nunca mais será exibida.
• Definir segredo de assinatura em um webhook o define ou o substitui: digite um com pelo menos 32 caracteres ou deixe em branco para gerar um e visualizá-lo uma única vez. Um segredo mais curto será rejeitado.
• HMAC-SHA256 é a única assinatura oferecida para webhooks de saída.
• Os webhooks e as entregas de webhook possuem uma coluna de assinatura. Um webhook sem segredo é exibido como "Não assinado — nenhum segredo definido" e cada uma de suas entregas falha com a mensagem "Não enviado: nenhum segredo de assinatura está definido neste webhook" em vez de ser enviado sem assinatura. Defina um segredo (ou salve o webhook novamente enquanto estiver ativo) e as entregas serão enviadas assinadas.

Uma entrega que falha porque o nome do destinatário não pôde ser encontrado (uma falha de DNS) é repetida até o limite de tentativas do webhook, como uma conexão falha. Um destino que a plataforma rejeita completamente (um endereço privado ou de metadados, um esquema que ela não utiliza) ainda falha na primeira tentativa.