WhatsMax

Começando

O WhatsMax liga o WhatsApp da sua empresa ao seu sistema: o sistema fala com uma API simples, e a equipe atende pelo painel. Em três passos você manda a primeira mensagem.

Dois jeitos de conectar, a mesma integração. O WhatsMax é Tech Provider da Meta. O caminho principal é o número oficial, pela API oficial do WhatsApp: sem risco de banimento por cliente não oficial, com o nome da empresa na conversa e modelos de mensagem para falar com quem não escreveu nas últimas 24 horas. A alternativa é a conexão rápida, por QR code, que é não oficial: o WhatsApp pode banir o número, e número banido não volta. Nela o gateway só responde a quem escreveu, no ritmo de uma pessoa; comece com um número que você aceite arriscar.

1. Crie uma chave de API

No painel, abra Integração → Chaves de API e clique em Criar chave. Dê um nome (por exemplo, o do sistema que vai usá-la) e escolha o que ela pode fazer. O valor aparece uma única vez: guarde-o num cofre, nunca no código nem no repositório.

2. Conecte um número

Número oficial (API da Meta). Peça um link de conexão (POST /v1/instances/connect-link, ou no painel, em Números → Conectar número oficial) e mande para quem administra o WhatsApp da empresa: a pessoa entra com o Facebook, escolhe o número e confirma. Dá para conectar um número novo ou o que a empresa já usa no WhatsApp Business do celular, que continua funcionando lá. A Meta cobra os templates direto da conta da empresa: o passo a passo, com a forma de pagamento, está em Número oficial (Meta).

Conexão rápida (QR code). Em Integração → Números, leia o QR code com o celular ou peça o código de 8 dígitos.

3. Mande uma mensagem

O jeito mais simples de testar é responder: peça a alguém que mande uma mensagem para o número e responda. Texto livre só vai a quem escreveu nas últimas 24 horas; para começar a conversa, use um template pelo número oficial. Projeto novo nasce só respondendo (reply_only): template fora das 24 horas precisa que o operador ligue a chave de campanha (campanhas_oficial) no projeto, senão a resposta é 422.

curl -X POST https://SEU-DOMINIO/v1/messages \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Idempotency-Key: pedido-1234" \
  -H "Content-Type: application/json" \
  -d '{
    "instance": "nome-do-numero",
    "to": "5542999999999",
    "type": "text",
    "content": { "text": "Sua sala está confirmada para amanhã às 14h." },
    "category": "transactional"
  }'

A resposta é 202: a mensagem entrou na fila. O envio nunca é síncrono. Para saber o que aconteceu com ela, configure um webhook ou consulte GET /v1/messages/{id}.

E agora