Skip to main content
Entender os estados de uma instância ajuda você a construir um sistema resiliente, que sabe exatamente quando pedir para o usuário pegar o celular e escanear o QR Code de novo.

​
Os Status da Instância

Ao consultar uma instância GET /v1/whatsapp/instances/:id, o campo status revela a saúde da conexão atual:
  • PENDING A instância foi criada, mas ainda não tem nenhum número de WhatsApp vinculado. Ela está aguardando a leitura do QR Code.
  • ACTIVE Tudo certo! O WhatsApp está conectado, a sessão está aberta e pronta para enviar e receber mensagens.
  • DISCONNECTED A conexão foi perdida. Pode ser falta de internet no aparelho físico, bateria fraca ou o usuário clicou em “Sair” no WhatsApp.
  • SUSPENDED (Raro) A instância foi suspensa por violação de termos ou bloqueio severo por parte do provedor.

​
O Fluxo de Conexão

Para colocar um número online, o fluxo é idêntico ao de conectar no WhatsApp Web, mas via API:
  1. Criação: Você chama o endpoint POST /v1/whatsapp/instances informando o nome da instância. O status nasce como PENDING.
  2. Geração do QR Code: A Notifique se comunica com os servidores da Meta e gera um QR Code. Nós disparamos o webhook instance.qrcode com a imagem em base64.
  3. Leitura: O usuário abre o app do WhatsApp no celular e escaneia a imagem.
  4. Conexão: Assim que a rede confirma, o status muda para ACTIVE e disparamos o webhook instance.connected