Eventos de webhook - Reenviar

#Visão Geral

Este endpoint solicita o reenvio (replay) de um evento aos endpoints elegíveis para aquele tipo de evento. É útil quando ocorrem falhas na entrega original ou quando você precisa ressincronizar sistemas externos.

#Descrição

Ao receber o eventId, a API localiza o evento, coleta todos os endpoints (ativos, no mesmo ambiente) inscritos naquele tipo e dispara uma nova entrega (replay forçado) para cada um. Para reentregar a um endpoint específico, use o Reenviar Dispatch.

#Requisição

POST /v1/webhooks/events/{eventId}/resend

Cabeçalho: SelectKey: sk_live_... (ou sk_test_...). Escopo necessário: webhooks:update. Não há corpo de requisição.

#Parâmetros de Caminho

#Resposta

#Aceito (202 Accepted)

{
  "accepted": true,
  "id": "wbh_01hqzvabc"
}

#Atributos da Resposta

#Exemplo de Uso

POST /v1/webhooks/events/wbh_01hqzvabc/resend

#Considerações

1. Processamento Assíncrono: a resposta 202 indica que o reenvio foi disparado; o resultado de cada entrega aparece nos Dispatches.

2. Idempotência: garanta que seu endpoint processe o mesmo evento múltiplas vezes sem efeitos colaterais. Deduplique pelo id do evento.

3. Replay forçado: o reenvio dispara a entrega mesmo que já tenha havido sucesso anterior naquele endpoint.

4. Escopo de ambiente: o reenvio alcança apenas endpoints do mesmo ambiente (sandbox/live) da sua chave de API.

#Códigos de Erro

#Casos de Uso Comuns

1. Recuperação de Falhas: reenviar eventos que falharam por problemas temporários no endpoint.
2. Ressincronização: garantir que sistemas externos receberam todos os eventos após uma manutenção.
3. Diagnóstico: identificar se as falhas de entrega são persistentes ou temporárias.