Limites e erros

Formato de erro, códigos HTTP e limites de uso.

Em falha, a resposta segue o envelope {"result":{},"message":"CODIGO","isValid":false}. Os códigos são próprios da Wozapfy onde a compatibilidade com a Zapfy não foi confirmada.

• 400 VALIDATION_FAILED: entrada inválida (ou INVALID_WEBHOOK_URL em /updateWebhook).
• 401 UNAUTHENTICATED: key ou token inválidos.
• 403 ACCOUNT_SUSPENDED: conta suspensa.
• 404 NOT_FOUND: mensagem não encontrada.
• 409 CONFLICT: WhatsApp não autenticado, instância pausada ou estado incompatível. 409 SUBSCRIPTION_REQUIRED: assinatura sem acesso a envios. 409 OPERATION_UNCERTAIN: resultado incerto no provedor; confira o WhatsApp antes de reenviar.
• 429 RATE_LIMITED: 120 requisições por minuto por rota e instância.
• 502 PROVIDER_ERROR / 503: falha ou indisponibilidade do provedor.
• Mídia até 10 MiB. URLs precisam ser HTTPS, públicas e sem redirecionamento.
• Texto até 65.536 caracteres; o WhatsApp pode impor limites adicionais.