instance.proxy_failed

EVENTOinstance.proxy_faileddesde M11envelope v1

Proxy da instância falhou.

Quando é emitido

Emitido quando a instância passa a não alcançar o WhatsApp pelo proxy dela (estado reconnecting com motivo proxy_unreachable) e repetido a cada 5 minutos enquanto a queda durar. A volta é o próximo instance.status. error traz o último erro de conexão do worker, sem usuário/senha do proxy, números de telefone nem tokens.

Campos de data

Campo	Tipo	Descrição
reason	string	Sempre proxy_unreachable.
since	string	Início da queda atual.
duration_seconds	integer	Duração até agora.
outages_last_hour	integer	Quedas iniciadas na última hora, contando esta.
repeat	integer	0 no primeiro aviso; cresce a cada lembrete.
error	string	Último erro de conexão (opcional, sem credenciais).

O envelope (id, type, version, instance_id, timestamp,data) está em Visão geral. Campos novos podem ser adicionados emdata sem mudar a versão: ignore os que não conhecer.

Exemplos

Corpo do POST

{
  "id": "evt_3d9a1f7c5e2b4068",
  "type": "instance.proxy_failed",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T15:12:44.020Z",
  "data": {
    "reason": "proxy_unreachable",
    "since": "2026-10-18T15:12:44Z",
    "duration_seconds": 0,
    "outages_last_hour": 1,
    "repeat": 0,
    "error": "socks connect tcp socks5://[redacted]@proxy.example:1080->web.whatsapp.com:443: connection refused"
  }
}

Entrega e ordem

• Por webhook: pelo menos uma vez, com retry por até 24 horas. O mesmo evento pode chegar duas vezes: deduplique porX-LiteZap-Event-Id. Veja Entrega e retentativas.
• A ordem entre eventos não é garantida (retentativas reordenam): use timestamp.
• Por SSE: ao vivo, sem replay. Veja Tempo real com SSE.
• Para assinar só este tipo: "events": ["instance.proxy_failed"] no webhook, ou?types=instance.proxy_failed no SSE.

Relacionados: instance.status

Equivalente na Z-API: Webhook de falha de proxy.