Conceitos

Número e JID

Números pessoais: E.164 sem `+` nem espaços — `5511999999999`. A Wagzap monta o JID `5511999999999@s.whatsapp.net`.

Grupos usam JID `120363...@g.us`. Canais usam `@newsletter`. Em vários endpoints você pode passar o JID completo no campo `number`.

messageId

ID do WhatsApp (stanza). A resposta de todo envio devolve `messageId` na raiz e em `data.messageId`.

Guarde esse ID para reagir, editar, apagar, encaminhar, marcar como lida ou consultar status de entrega.

Status da instância

`disconnected` — socket fechado. Pode ter sessão salva (disconnect) ou ter sido despareada (logout).

`qr` — pairing aberto, aguardando scan.

`connected` — cliente whatsmeow autenticado. Só neste estado os envios funcionam e o cronômetro de crédito roda.

Disconnect desliga sem logout e para o cronômetro. Logout despareia. Delete remove instância, tokens e dados. Agenda automática (módulo Horário) é extra.

Tokens

TokenAccount — criar, listar e apagar instâncias. Gere e rotacione em Minha conta → Tokens de API (admin/owner).

TokenInstance — tudo que acontece dentro de um número. Mostrado na criação e de novo em Minha conta → Tokens de API.

JWT do painel — login humano (OTP ou senha+2FA). Não substitui os tokens das integrações.