Documentação da API

API REST para integrar o WhatsApp ao seu sistema: provisione números, envie e receba mensagens e mídias, e receba eventos por webhook.

Visão geral

Todas as requisições usam a base URL abaixo e retornam JSON. Há dois conjuntos de rotas: as da conta (provisionar/gerenciar números, autenticadas pela chave da conta) e as da instância (enviar/receber, no padrão de mercado, autenticadas pelo Client-Token).

Base URL

https://api.rexzap.rexsuite.com

Autenticação

Não há login por OAuth: cada conjunto de rotas usa um cabeçalho próprio.

Início rápido

Em quatro passos: provisione um número, mostre o QR, espere conectar e envie.

# 1) provisione um número (retorna id, token, clientToken e a URL do QR)
curl -X POST https://api.rexzap.rexsuite.com/provisionar \
  -H "X-RexZap-Account: SUA_CHAVE_DA_CONTA"

# 2) pegue o QR (data:image/png;base64,...) e exiba no seu sistema
curl https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/qr-code/image \
  -H "Client-Token: {clientToken}"

# 3) verifique a conexão até status = conectado
curl https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/status \
  -H "Client-Token: {clientToken}"

# 4) envie a primeira mensagem
curl -X POST https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/send-text \
  -H "Client-Token: {clientToken}" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5544999999999","message":"olá 👋"}'

Provisionar números

Rotas da conta — header X-RexZap-Account. Seu sistema cria e gerencia números sem entrar no painel.

{
  "id": "34DEA54FF15492214CB8FAD5470C62F8",
  "token": "9E8937994C27C132E835A0680B194C21",
  "clientToken": "92912E057CE1...",
  "status": "desconectado",
  "qrCodeUrl": "/instances/{id}/token/{token}/qr-code/image",
  "statusUrl": "/instances/{id}/token/{token}/status"
}

[
  { "id": "...", "token": "...", "clientToken": "...",
    "numero": "5544999999999", "perfilNome": "Maria", "status": "conectado" }
]

{ "ok": true }

Cota

{ "used": 1, "limit": 10, "active": true, "status": "active" }

Enviar texto

Rotas de instância — path /instances/{id}/token/{token} + header Client-Token. A resposta de envio traz os ids da mensagem.

{ "zaapId": "...", "messageId": "...", "id": "..." }

Enviar imagem

{ "zaapId": "...", "messageId": "...", "id": "..." }

Enviar documento

{ "zaapId": "...", "messageId": "...", "id": "..." }

Enviar áudio

{ "zaapId": "...", "messageId": "...", "id": "..." }

Enviar vídeo

{ "zaapId": "...", "messageId": "...", "id": "..." }

Guia de links, botões e listas

O RexZap já possui quatro endpoints para criar experiências mais objetivas: prévia de link, botões de ação, respostas rápidas e menu de opções. Todos passam pela fila confiável de envio.

Qual endpoint usar

Compatibilidade por motor

Fluxo recomendado

Use textos curtos, ofereça somente as escolhas necessárias para a etapa atual e atribua um id estável a cada resposta. Botões reply retornam buttonsResponseMessage.buttonId; itens de lista retornam listResponseMessage.selectedRowId no webhook de mensagens recebidas.

Enviar link

Envia um texto com prévia de link (título, descrição e imagem do site quando disponível).

{ "zaapId": "...", "messageId": "...", "id": "..." }

curl -X POST https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/send-link \
  -H "Client-Token: {clientToken}" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5544999999999","linkUrl":"https://loja.exemplo.com/produtos/123","message":"Confira os detalhes e finalize seu pedido:","title":"Plano Profissional","linkDescription":"Ativação imediata após a confirmação","image":"https://loja.exemplo.com/img/plano-profissional.jpg"}'

Enviar localização

{ "zaapId": "...", "messageId": "...", "id": "..." }

Enviar contato

{ "zaapId": "...", "messageId": "...", "id": "..." }

Enviar figurinha

{ "zaapId": "...", "messageId": "...", "id": "..." }

Enviar GIF

{ "zaapId": "...", "messageId": "...", "id": "..." }

Reagir a mensagem

Envia uma reação (emoji) a uma mensagem existente. Passa pela fila como os demais envios.

{ "zaapId": "...", "messageId": "...", "id": "..." }

curl -X POST https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/send-reaction \
  -H "Client-Token: {clientToken}" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5544999999999","messageId":"3EB0...","reaction":"👍"}'

Remover reação

Remove a reação previamente enviada a uma mensagem (envia uma reação vazia).

{ "zaapId": "...", "messageId": "...", "id": "..." }

Marcar como lida

Marca uma mensagem recebida como lida (os ticks azuis no aparelho do contato).

{ "value": true }

Editar mensagem

Edita o texto de uma mensagem enviada por você. O WhatsApp só permite editar nos primeiros 15 minutos e somente mensagens de texto próprias.

{ "value": true }

{ "value": false, "code": "MESSAGE_PENDING", "error": "mensagem ainda esta na fila; aguarde a confirmacao do WhatsApp e tente novamente" }

curl -X POST "https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/edit-message" \
  -H "Client-Token: {clientToken}" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5511999999999","messageId":"3EB0C5A277F7F9B6C599","message":"Texto corrigido"}'

Apagar mensagem

Apaga uma mensagem própria para todos. Os parâmetros vão na query string. O messageId pode ser o zaapId devolvido pelo envio; a RexZap resolve o ID definitivo antes de chamar o motor.

{ "value": true }

{ "value": false, "code": "MESSAGE_NOT_OWN", "error": "somente mensagens enviadas pela propria instancia podem ser apagadas para todos" }

curl -X DELETE "https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/messages?messageId=3EB0...&phone=5544999999999&owner=true" \
  -H "Client-Token: {clientToken}"

Encaminhar mensagem

Encaminha uma mensagem existente para outro número. Passa pela fila como os demais envios.

{ "zaapId": "...", "messageId": "...", "id": "..." }

Botões de ação (beta)

Envia uma mensagem com botões de ação (abrir link, ligar ou resposta rápida). Passa pela fila como os demais envios.

{ "zaapId": "...", "messageId": "...", "id": "..." }

curl -X POST https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/send-button-actions \
  -H "Client-Token: {clientToken}" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5544999999999","title":"Seu pedido está pronto","message":"Escolha uma ação. Se os botões não aparecerem, acesse o link enviado no texto.","footer":"Pedido #12345","buttonActions":[{"id":"acompanhar_pedido","type":"url","label":"Acompanhar","url":"https://loja.exemplo.com/pedidos/12345"},{"id":"ligar_loja","type":"call","label":"Ligar","phone":"551140001234"}]}'

Lista de botões (beta)

Envia uma mensagem com botões de resposta rápida (o contato toca um botão e a resposta volta como mensagem). Passa pela fila como os demais envios.

{ "zaapId": "...", "messageId": "...", "id": "..." }

curl -X POST https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/send-button-list \
  -H "Client-Token: {clientToken}" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5544999999999","title":"Atendimento","message":"Escolha um setor. Se os botões não aparecerem, responda VENDAS ou SUPORTE.","footer":"Você pode voltar ao menu a qualquer momento","buttonList":{"buttons":[{"id":"vendas","label":"Vendas"},{"id":"suporte","label":"Suporte"},{"id":"financeiro","label":"Financeiro"}]}}'

Lista de opções (beta)

Envia uma mensagem com um menu de lista (o contato abre a lista e escolhe uma opção). Passa pela fila como os demais envios.

{ "zaapId": "...", "messageId": "...", "id": "..." }

curl -X POST https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/send-option-list \
  -H "Client-Token: {clientToken}" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5544999999999","title":"Central de atendimento","message":"Selecione o assunto. Se a lista não aparecer, digite o nome da opção.","footer":"Atendimento de segunda a sexta","optionList":{"title":"Assuntos","buttonLabel":"Ver opções","options":[{"id":"novo_pedido","title":"Fazer um pedido","description":"Produtos, preços e disponibilidade"},{"id":"acompanhar_pedido","title":"Acompanhar pedido","description":"Prazo e andamento da entrega"},{"id":"troca_devolucao","title":"Troca ou devolução","description":"Ajuda após a compra"},{"id":"falar_atendente","title":"Falar com atendente","description":"Continuar com uma pessoa"}]}}'

Listar fila

Mensagens ainda na fila de envio (aguardando o delay/aquecimento). Cada item traz o zaapId usado para remover.

[
  { "zaapId": "...", "phone": "5544999999999",
    "type": "text", "message": "olá 👋",
    "scheduled": "2024-06-10T12:00:00+00:00" }
]

curl https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/queue \
  -H "Client-Token: {clientToken}"

Limpar fila

{ "value": true }

Remover da fila

{ "value": true }

Status de texto

Publica um status (story) de texto no status@broadcast. Visível a todos os contatos que têm o número salvo. É síncrono (não passa pela fila): publica direto e os três campos da resposta trazem o MessageId real da publicação.

{ "zaapId": "...", "messageId": "...", "id": "..." }

Status de imagem

Publica um status (story) de imagem no status@broadcast. Visível a todos os contatos que têm o número salvo. É síncrono (não passa pela fila): publica direto e os três campos da resposta trazem o MessageId real da publicação.

{ "zaapId": "...", "messageId": "...", "id": "..." }

Número existe no WhatsApp

Verifica se um número tem conta no WhatsApp antes de enviar.

{ "exists": true, "phone": "5544999999999", "outputPhone": "5544999999999" }

curl https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/phone-exists/5544999999999 \
  -H "Client-Token: {clientToken}"

Foto de perfil

{ "link": "https://...whatsapp.net/...jpg" }
{ "link": null }

Listar contatos

Lista os contatos com quem o número já conversou. Não é a agenda inteira do aparelho — só quem trocou mensagens com esta instância. Paginado.

[
  { "phone": "5544999999999", "name": "Maria" }
]

curl "https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/contacts?page=1&pageSize=50" \
  -H "Client-Token: {clientToken}"

Dados do contato

{
  "phone": "5544999999999",
  "name": "Maria",
  "exists": true
}

Listar chats

Lista as conversas (chats) da instância — uma por número que já trocou mensagens. Mesma semântica de contatos: não inclui conversas sem histórico nesta instância. Paginado.

[
  { "phone": "5544999999999", "name": "Maria",
    "lastMessageText": "até amanhã", "lastMessageTime": 1718000000000,
    "unread": 0, "archived": false }
]

curl "https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/chats?page=1&pageSize=50" \
  -H "Client-Token: {clientToken}"

Mensagens do chat

Histórico de mensagens de uma conversa, da mais recente para a mais antiga. Use lastMessageId para paginar (cursor).

[
  { "phone": "5544999999999", "fromMe": false,
    "tipo": "text", "texto": "oi", "messageId": "3EB0...",
    "status": "RECEIVED", "momment": 1718000000000,
    "midiaUrl": null, "midiaMime": null, "midiaNome": null }
]

curl "https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/chat-messages/5544999999999?amount=20" \
  -H "Client-Token: {clientToken}"

Dados do chat

{
  "phone": "5544999999999",
  "name": "Maria",
  "lastMessageTime": 1718000000000,
  "messagesCount": 42
}

Modificar chat

Arquiva, desarquiva, marca como lida/não lida ou apaga uma conversa. A ação delete é destrutiva (apaga a conversa) — use com cuidado.

{ "value": true }

curl -X POST https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/modify-chat \
  -H "Client-Token: {clientToken}" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5544999999999","action":"archive"}'

Criar grupo

Cria um grupo e adiciona os participantes informados. O número conectado entra como administrador. Os grupos usam id@g.us; nas rotas de grupo seguintes, envie esse id no campo groupId (com o sufixo @g.us, como retornado aqui).

{ "groupId": "120363000000000000@g.us", "invitationLink": null }

curl -X POST https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/create-group \
  -H "Client-Token: {clientToken}" \
  -H "Content-Type: application/json" \
  -d '{"groupName":"Equipe RexZap","phones":["5544999999999","5544988888888"]}'

Alterar nome do grupo

{ "value": true }

Alterar foto do grupo

{ "value": true }

Alterar descrição do grupo

{ "value": true }

Configurações do grupo

Controla quem pode enviar mensagens e quem pode editar os dados do grupo (nome, foto, descrição). Requer administrador.

{ "value": true }

Adicionar participante

{ "value": true }

Remover participante

{ "value": true }

Promover a admin

{ "value": true }

Rebaixar admin

{ "value": true }

Sair do grupo

{ "value": true }

Dados do grupo

Retorna os metadados do grupo: nome, descrição, dono, participantes e quem é administrador.

{
  "phone": "120363000000000000",
  "subject": "Equipe RexZap",
  "description": "Grupo da equipe",
  "owner": "5544999999999",
  "participants": [
    { "phone": "5544999999999", "isAdmin": true, "isSuperAdmin": true },
    { "phone": "5544988888888", "isAdmin": false, "isSuperAdmin": false }
  ]
}

Dados por convite

Lê os metadados de um grupo a partir do link de convite, sem precisar fazer parte dele.

{
  "phone": "120363000000000000",
  "subject": "Equipe RexZap",
  "description": "Grupo da equipe",
  "owner": "5544999999999",
  "participants": [
    { "phone": "5544999999999", "isAdmin": true, "isSuperAdmin": true }
  ]
}

curl "https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/group-invitation-metadata?url=https://chat.whatsapp.com/ABC123" \
  -H "Client-Token: {clientToken}"

Status

{ "connected": true, "session": true, "error": "", "smartphoneConnected": true }
{ "connected": false, "session": false, "error": "You are not connected.", "smartphoneConnected": false }

Dados do aparelho

{
  "phone": "5544999999999", "imgUrl": null,
  "device": { "wa_version": "", "mcc": "", "mnc": "",
    "os_version": "", "device_manufacturer": "", "device_model": "",
    "osbuildnumber": "", "platform": "" }
}

Alterar nome do perfil

Altera o nome de exibição (perfil) do número conectado.

{ "value": true }

curl -X PUT https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/update-name \
  -H "Client-Token: {clientToken}" \
  -H "Content-Type: application/json" \
  -d '{"value":"Atendimento RexZap"}'

Alterar foto do perfil

Altera a foto de perfil do número conectado. Aplicação é best-effort: o WhatsApp pode recusar a imagem (formato/tamanho) e a foto pode não trocar mesmo com resposta de sucesso.

{ "value": true }

Leitura automática

Liga/desliga a marcação automática como lida das mensagens recebidas (ticks azuis).

{ "value": true }

Rejeitar chamadas

Liga/desliga a rejeição automática de chamadas recebidas (voz e vídeo). A rejeição é best-effort: depende do comportamento do WhatsApp e pode variar.

{ "value": true }

Mensagem de chamada rejeitada

Define o texto enviado automaticamente ao contato quando uma chamada é rejeitada (requer a rejeição automática ligada).

{ "value": true }

QR Code

{ "value": "data:image/png;base64,iVBORw0KG..." }
{ "value": null }

QR Code (texto)

{ "value": "data:image/png;base64,iVBORw0KG..." }
{ "value": null }

curl https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/qr-code \
  -H "Client-Token: {clientToken}"

Restaurar sessão

{ "value": true }

Reiniciar / Desconectar

{ "value": true }

{ "value": true }

Configurar webhooks

Defina as URLs que receberão os eventos. Rotas PUT de instância, body { "value": "https://sua-app/webhook" }.

Webhook ao enviar

{ "value": true }

Webhook de presença

{ "value": true }

Eventos recebidos

O RexZap faz POST na sua URL com estes formatos.

Mensagem de texto

Todo ReceivedCallback traz os campos de topo abaixo e mais um objeto conforme o tipo da mensagem. senderLid é o @lid do remetente (quando houver). senderPhoto e photo vêm null no momento.

{
  "waitingMessage": false, "isGroup": false,
  "instanceId": "...", "messageId": "...",
  "phone": "5544999999999", "senderLid": null, "fromMe": false,
  "momment": 1718000000000, "status": "RECEIVED",
  "chatName": "Maria", "senderPhoto": null, "senderName": "Maria",
  "participantPhone": null, "photo": null, "broadcast": false,
  "type": "ReceivedCallback",
  "text": { "message": "olá" }
}

Mídia (imagem, áudio, vídeo, documento, sticker)

Mesma estrutura, com um objeto por tipo. A URL é temporária: o RexZap não arquiva a mídia. Baixe e persista o arquivo na sua aplicação se precisar conservá-lo.

{
  "type": "ReceivedCallback", "status": "RECEIVED", "instanceId": "...",
  "phone": "...", "fromMe": false, "momment": 1718000000000, "broadcast": false,
  "image":    { "imageUrl": "https://api.rexzap.rexsuite.com/media/...", "caption": "...", "mimeType": "image/jpeg" },
  "audio":    { "audioUrl": "...", "mimeType": "audio/ogg" },
  "video":    { "videoUrl": "...", "caption": "...", "mimeType": "video/mp4" },
  "document": { "documentUrl": "...", "mimeType": "application/pdf", "fileName": "nota.pdf" },
  "sticker":  { "stickerUrl": "...", "mimeType": "image/webp" }
}

Reação

Quando reagem a uma mensagem. referencedMessage aponta a mensagem reagida.

{
  "type": "ReceivedCallback", "status": "RECEIVED", "instanceId": "...", "messageId": "...",
  "phone": "...", "fromMe": false, "momment": 1718000000000,
  "reaction": {
    "value": "❤️", "time": 1718000000000,
    "referencedMessage": { "messageId": "3EB0...", "fromMe": true, "phone": "5544999999999", "participant": null }
  }
}

Localização

{ "type": "ReceivedCallback", "instanceId": "...", "phone": "...", "fromMe": false,
  "location": { "longitude": -38.5014, "latitude": -3.7319, "address": "Rua X, 123", "url": "" } }

Contato

{ "type": "ReceivedCallback", "instanceId": "...", "phone": "...", "fromMe": false,
  "contact": { "displayName": "Cesar", "vCard": "BEGIN:VCARD...END:VCARD", "phones": ["5544999999999"] } }

Resposta de botão / lista

Quando o contato escolhe um botão de resposta ou um item de lista. Botões de URL e ligação não geram este callback.

{ ..., "buttonsResponseMessage": { "buttonId": "vendas", "message": "Vendas" } }
{ ..., "listResponseMessage": { "message": "Produtos, preços e disponibilidade", "title": "Fazer um pedido", "selectedRowId": "novo_pedido" } }

Status / conexão

{ "type": "MessageStatusCallback", "instanceId": "...", "status": "SENT", "ids": ["<id real>"], "zaapId": "<id da fila>", "phone": "...", "momment": 1718000000000 }
{ "type": "ConnectedCallback", "instanceId": "...", "momment": 1718000000000 }
{ "type": "DisconnectedCallback", "instanceId": "...", "momment": 1718000000000 }

Ao enviar (DeliveryCallback)

Disparado quando o próprio número envia uma mensagem (saída da fila), na URL de /update-webhook-delivery.

{
  "type": "DeliveryCallback",
  "instanceId": "...", "messageId": "<id real>", "zaapId": "<id da fila>",
  "phone": "5544999999999",
  "momment": 1718000000000
}

Presença no chat (ChatPresenceCallback)

Disparado quando muda a presença de um contato no chat, na URL de /update-webhook-chat-presence. O campo status assume composing (digitando), recording (gravando áudio), available (online), unavailable (offline) ou paused (parou de digitar).

{
  "type": "ChatPresenceCallback", "instanceId": "...",
  "phone": "5544999999999",
  "status": "composing",
  "momment": 1718000000000
}

Criar produto

Cria um produto no catálogo do número conectado (conta Business).

{ "id": "7100...", "name": "Camiseta RexZap", "currency": "BRL", "isHidden": false }

curl -X POST https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/products \
  -H "Client-Token: {clientToken}" \
  -H "Content-Type: application/json" \
  -d '{"name":"Camiseta RexZap","price":59.9,"currency":"BRL"}'

Catálogo próprio

Lista os produtos do catálogo do número conectado (conta Business).

{
  "products": [
    { "id": "7100...", "name": "Camiseta RexZap", "currency": "BRL" }
  ]
}

curl https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/catalogs \
  -H "Client-Token: {clientToken}"

Catálogo de um número

Lista os produtos do catálogo de outro número (conta Business).

{
  "products": [
    { "id": "7100...", "name": "Camiseta", "currency": "BRL" }
  ]
}

Dados do produto

{
  "id": "7100...",
  "name": "Camiseta RexZap",
  "currency": "BRL",
  "description": "...",
  "isHidden": false
}

Excluir produto

{ "value": true }

Listar etiquetas

Lista as etiquetas (tags) da conta. Só WhatsApp Business Multi-Devices.

[
  { "id": "1", "name": "Novo cliente", "color": 0 }
]

curl https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/tags \
  -H "Client-Token: {clientToken}"

Adicionar etiqueta ao chat

Aplica uma etiqueta a uma conversa. Só WhatsApp Business Multi-Devices.

{ "value": true }

curl -X PUT https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/chats/5544999999999/tags/1/add \
  -H "Client-Token: {clientToken}"

Remover etiqueta do chat

Remove uma etiqueta de uma conversa. Só WhatsApp Business Multi-Devices. Por compatibilidade com a PlugzAPI, esta rota usa o método GET.

{ "value": true }

curl https://api.rexzap.rexsuite.com/instances/{id}/token/{token}/chats/5544999999999/tags/1/remove \
  -H "Client-Token: {clientToken}"

Erros

Todo erro vem como JSON com o status HTTP correspondente. As operações de editar e apagar retornam também value:false e um code estável. Antes de qualquer send-*, o número precisa estar com status conectado; nessas rotas, desconexão continua retornando 400. Em editar/apagar, desconexão retorna 503 INSTANCE_DISCONNECTED.

Dicas — Manter o número conectado

A conexão não-oficial funciona como um aparelho vinculado ao WhatsApp do número (igual ao WhatsApp Web): o celular onde o número está logado continua sendo o dono da conta, e a estabilidade dos envios depende dele. As dicas abaixo reduzem desconexões e mensagens que não saem.

Bloqueio de tela e bateria

A economia de bateria do Android fecha o WhatsApp em segundo plano e corta a conexão. No celular do número:

• Coloque o WhatsApp como "sem restrições" na otimização/economia de bateria.
• Evite que a tela durma/bloqueie muito rápido, ou mantenha o aparelho carregando.
• Não use modo de economia agressivo que encerra apps inativos.

Manter o WhatsApp ativo no Android

Em vários fabricantes (Xiaomi, Samsung, Motorola e outros) é preciso liberar o app explicitamente:

• Permita execução em segundo plano e início automático (autostart) do WhatsApp.
• Fixe o WhatsApp na tela de apps recentes para o sistema não encerrá-lo.
• Desligue "remover permissões de apps não usados" para o WhatsApp.
• Mantenha o WhatsApp atualizado pela loja.

Estabilidade da conexão

• Mantenha o celular com internet estável (Wi-Fi bom ou 4G/5G com sinal).
• Use um número por aparelho; não fique logando o mesmo número em vários WhatsApp Web ao mesmo tempo.
• Respeite um intervalo entre os envios — o RexZap já aplica um delay anti-bloqueio por conta.
• Depois de reiniciar o celular, abra o WhatsApp para a sessão voltar.

Emuladores

Não recomendamos rodar o número em emuladores de Android no PC: são instáveis para a sessão do WhatsApp, fecham em segundo plano e aumentam o risco de bloqueio. Prefira um aparelho físico dedicado ao número — de preferência usado só para isso — ligado, carregando e com internet.

Número bloqueado pelo WhatsApp

O WhatsApp pode bloquear ou banir um número que dispara muito para desconhecidos, recebe denúncias de spam, ou é um chip muito novo usado em volume logo de cara. É uma decisão do WhatsApp sobre o número — não é falha da API.

Se for bloqueado, peça revisão dentro do próprio app do WhatsApp (a tela de bloqueio oferece a opção "Solicitar revisão").

Fila de mensagens

Toda mensagem enviada entra em uma fila antes de sair, respeitando o intervalo anti-bloqueio. Você acompanha e gerencia a fila pela API (listar, limpar, remover) e, no atendimento, pela tela Fila de envio — ver pendentes e falhadas, reenviar uma ou todas, e limpar. Falhas de origem automática (sistema/integração) re-tentam sozinhas por algumas horas; as do atendimento falham rápido para o operador reenviar.