# Reenviar entrega

Fonte: https://apiwpp.com/docs/api/registros/reenviar-entrega
Seção: Registros
Atualizado em: 2026-09-28

`POST /webhooks/deliveries/{id}/resend`

Coloca uma entrega de webhook de novo na fila, para agora, com as tentativas zeradas (mais 6 tentativas). Serve para uma entrega `dead` ou em `retry` (neste caso, a próxima tentativa é antecipada); uma entrega já entregue responde `409`. Escopo necessário: `webhooks:write`.

## Cabeçalhos

| Nome | Obrigatório | Descrição |
| --- | --- | --- |
| `Authorization` | sim | `Bearer <chave de API>`; ou envie a chave em `X-Api-Key`. |

## Parâmetros de caminho

| Nome | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | `string` | sim | Identificador da entrega: o `id` de uma linha de `GET /webhooks/deliveries`. |

## Exemplo de requisição

### cURL

```bash
curl -X POST \
  https://api.apiwpp.com/webhooks/deliveries/$DELIVERY_ID/resend \
  -H "Authorization: Bearer $API_KEY"
```

### Node.js

```javascript
const res = await fetch(`https://api.apiwpp.com/webhooks/deliveries/${deliveryId}/resend`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
  },
})
const data = await res.json()
```

### PHP

```php
$response = Http::withToken($apiKey)
    ->post("https://api.apiwpp.com/webhooks/deliveries/{$deliveryId}/resend");
```

### Python

```python
import requests

response = requests.post(
    f"https://api.apiwpp.com/webhooks/deliveries/{delivery_id}/resend",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
```

## Respostas

| Código | Erro | Descrição |
| --- | --- | --- |
| 200 |  | A entrega, já na fila: `state` `retry`, `attempts` `0` e `nextAttemptAt` agora. `httpStatus`, `error` e `latencyMs` ainda são da última tentativa antes do reenvio. |
| 400 | `FST_ERR_VALIDATION` | O `id` não segue o schema da operação. Na prática não acontece, porque o `id` aceita qualquer texto; um `id` que não existe responde `404`; `message` diz o que está errado. |
| 401 |  | Sem chave de API, ou com uma chave inválida: desconhecida, revogada ou expirada. O corpo é `{"error": "Unauthorized"}`. |
| 403 |  | A chave não tem o escopo `webhooks:write`; a mensagem cita o escopo (`This credential lacks the webhooks:write scope`). |
| 404 |  | A entrega não existe, saiu do registro (depois da retenção) ou não é do projeto da chave (`{"error": "Delivery not found"}`). |
| 409 |  | A entrega já foi feita com sucesso (`Delivery already succeeded; nothing to resend`), ou o corpo dela não foi guardado por ter mais de 256 KB e ela já saiu da fila interna, então não há como montá-la de novo (`Payload not available for resend (too large to be logged)`). Neste caso a entrega fica como estava. |
| 429 |  | Requisições demais deste IP de origem (por padrão, 600 por minuto), ou autenticações com falha demais (por padrão, 20 a cada 5 minutos): espere os segundos de `Retry-After`. Veja [Limites](https://apiwpp.com/docs/referencia/limites). Cabeçalhos: `Retry-After`. |

### 200 OK

```json
{
  "id": "9c2d5e6f-7a8b-4c9d-8e0f-3a4b5c6d7e8f",
  "tenantId": "3f6c2a8e-9d41-4b7a-8c15-2e7d9a0b4c61",
  "connectionId": "8b1d4e7f-2c3a-4f5b-9e6d-7a8b9c0d1e2f",
  "eventType": "message.delivery",
  "url": "https://crm.example.com/api/whatsapp/events",
  "state": "retry",
  "httpStatus": 500,
  "error": "HTTP 500",
  "latencyMs": 80,
  "attempts": 0,
  "maxAttempts": 6,
  "nextAttemptAt": "2026-09-24T12:00:00.000Z",
  "signed": true,
  "payload": {
    "type": "message.delivery",
    "connectionId": "8b1d4e7f-2c3a-4f5b-9e6d-7a8b9c0d1e2f",
    "tenantId": "3f6c2a8e-9d41-4b7a-8c15-2e7d9a0b4c61",
    "externalId": "shop-42",
    "timestamp": "2026-09-24T12:00:02.000Z",
    "data": {
      "messageId": "3EB0C767D26A1D8A3F52",
      "status": "delivered",
      "recipient": "5511988887777",
      "jid": "5511988887777@s.whatsapp.net",
      "phone": "+5511988887777",
      "clientRef": "crm-msg-1"
    }
  },
  "createdAt": "2026-09-24T12:00:02.000Z",
  "updatedAt": "2026-09-24T12:00:02.000Z"
}
```

## Detalhes

O evento sai de novo com o mesmo corpo, envelope incluído, e é assinado de novo com o segredo atual do projeto. Trate os eventos pelo que já recebeu: a entrega é pelo menos uma vez.

Acompanhe o resultado em `GET /webhooks/deliveries`: a mesma linha (mesmo `id`) é atualizada a cada tentativa.

Guia: [Webhooks e assinatura](https://apiwpp.com/docs/guias/webhooks-e-assinatura).
