Reenviar entregas

Este endpoint reenvia (redeliver) uma entrega específica ao seu endpoint de destino. Diferente do reenvio de evento(/docs/guide/webhook-events/resend) — que reentrega o evento a todos os endpoints ele

Visão Geral

Este endpoint reenvia (redeliver) uma entrega específica ao seu endpoint de destino. Diferente do reenvio de evento — que reentrega o evento a todos os endpoints elegíveis —, aqui a reentrega é direcionada ao endpoint exato daquele dispatch, reaproveitando o mesmo registro de entrega. É útil para reprocessar uma falha pontual sem afetar as demais entregas do mesmo evento.

Descrição

Ao receber o dispatchId, a API localiza o dispatch (junto do evento e do endpoint associados), reconstrói o payload do evento e dispara uma nova tentativa de entrega para aquele endpoint específico. A resposta confirma que o reenvio foi disparado; o recebimento efetivo depende do seu servidor.

Requisição

POST /v1/webhooks/dispatches/{dispatchId}/redispatch

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

Parâmetros de Caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
`dispatchId`	string	Sim	ID do dispatch a reentregar (`wdi_*`)	`wdi_01hqzvabc`

Exemplo de Requisição

POST /v1/webhooks/dispatches/wdi_01hqzvabc/redispatch

Resposta

Aceito (202 Accepted)

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

Atributos da Resposta

Atributo	Tipo	Descrição
`accepted`	boolean	Sempre `true` quando a reentrega foi disparada
`id`	string	ID do dispatch reentregue (`wdi_*`)

Considerações

Reentrega direcionada: a reentrega vai apenas ao endpoint daquele dispatch, não a todos os endpoints do evento.
Idempotência: garanta que seu endpoint processe o mesmo evento múltiplas vezes sem efeitos colaterais — uma reentrega pode chegar após a entrega original.
Confirmação ≠ recebimento: a resposta 202 indica que a reentrega foi disparada; o resultado real aparece em seguida no status/responseStatusCode do dispatch (consulte a listagem).
Dispatches legados não são reentregáveis: dispatches sintéticos reconstruídos de eventos legados (ID no formato wdi_legacy_*) não possuem um registro real e retornam 404 ao tentar reentregar.

Códigos de Erro

Código HTTP	`code`	Descrição
401	—	Não autorizado (`SelectKey` ausente/inválida)
403	—	Acesso negado (sem o escopo `webhooks:update`)
404	`webhookDispatchNotFound`	Dispatch não encontrado na sua conta (ou evento/endpoint associado ausente)
500	—	Erro interno do servidor

Dispatch não encontrado (404 Not Found)

{
  "error": {
    "status": "Not Found",
    "statusCode": 404,
    "category": "resource",
    "message": "Webhook dispatch not found.",
    "docUrl": "https://docs.api.selectwin.io/errors/resource",
    "supportUrls": [
      "https://suporte.selectwin.io/ajuda"
    ]
  }
}

Casos de Uso Comuns

Recuperação de falha pontual: reentregar um dispatch failed após corrigir uma indisponibilidade temporária do seu servidor.
Reprocessamento direcionado: forçar a reentrega a um endpoint específico sem reenviar o evento aos demais.
Diagnóstico: confirmar se uma falha é persistente ou transitória observando o resultado da nova tentativa.

Reenviar entregas

On this page