Erros

Quando algo dá errado, a API responde com um status HTTP de erro e sempre o mesmo JSON. Este é o mapa para tratar cada caso.

O formatoCopiar link desta seção

Todo erro, de qualquer rota, vem assim:

{
  "error": {
    "code": "whatsapp_window_closed",
    "message": "The 24-hour customer service window is closed. Send an approved template instead."
  }
}

Um jeito simples de ler:

const res = await fetch(url, options);
if (!res.ok) {
  const { error } = await res.json().catch(() => ({ error: {} }));
  const retryAfter = res.headers.get("Retry-After"); // no 429 e no 409 idempotency_key_in_progress
  throw Object.assign(new Error(error.message), { status: res.status, code: error.code, details: error, retryAfter });
}

Status HTTPCopiar link desta seção

Códigos geraisCopiar link desta seção

Valem para todas as rotas.

Erros de envio pelo WhatsAppCopiar link desta seção

Vêm de POST /messages/send e POST /templates/send, e aparecem por item no envio em massa.

Quando o WhatsApp chegou a receber a tentativa, ela fica gravada na conversa como failed. Em GET /messages/:id, errorCode traz então o código da própria Meta (por exemplo 131047 para janela fechada, 131026 para número sem WhatsApp).

Códigos de outras rotasCopiar link desta seção

Quando tentar de novoCopiar link desta seção