Evento: channel.disconnected

Quando e Disparado

Este evento e disparado quando um canal perde a conexao com o WhatsApp. Isso pode ocorrer por diversos motivos, como problemas de rede, logout no dispositivo, revogacao de acesso ou instabilidade do servidor do WhatsApp.

Quando um canal e desconectado, mensagens nao podem mais ser enviadas ou recebidas por esse canal ate que a conexao seja restabelecida.

Payload

{
  "event": "channel.disconnected",
  "timestamp": "2024-06-10T18:45:00.123Z",
  "data": {
    "channelId": "665d9a0b1c2d3e4f5a6b7c8d",
    "type": "WHATSAPP_BAILEYS",
    "reason": "Sessao encerrada pelo dispositivo",
    "disconnectedAt": "2024-06-10T18:45:00.123Z"
  }
}

Campos do Payload

Campo	Tipo	Descricao
event	string	Nome do evento. Sempre channel.disconnected.
timestamp	string	Data/hora do evento em formato ISO 8601.
data.channelId	string	Identificador unico do canal.
data.type	string	Tipo do canal: WHATSAPP_BAILEYS ou WHATSAPP_WABA.
data.reason	string	Motivo da desconexao. Exemplos: Sessao encerrada pelo dispositivo, Timeout de conexao, Logout detectado, Erro de autenticacao.
data.disconnectedAt	string	Data/hora da desconexao em formato ISO 8601.

Motivos Comuns de Desconexao

Motivo	Descricao	Acao Recomendada
Sessao encerrada pelo dispositivo	O WhatsApp foi deslogado no celular.	Reconectar o canal via QR Code.
Timeout de conexao	Perda temporaria de conectividade.	Aguardar reconexao automatica ou reconectar manualmente.
Logout detectado	O usuario deslogou a sessao web/API.	Reconectar o canal.
Erro de autenticacao	Credenciais invalidas ou expiradas (WABA).	Verificar e atualizar as credenciais do canal.
Conflito de sessao	Outra sessao foi aberta com o mesmo numero.	Verificar se o numero esta em uso em outro servico.

Atencao

Configure alertas na sua aplicacao para este evento. Canais desconectados param de enviar e receber mensagens, o que pode impactar diretamente o atendimento ao cliente.