Guia de início

O WhatsBot transforma um número de WhatsApp num bot seu. Você não instala nada no celular: cria uma conta, escolhe um número e diz pra onde as mensagens devem ir. Este guia leva do zero ao primeiro "olá" respondido.

Passo 1 · Crie sua conta

Vá em Criar conta, informe nome, email e senha. Não pede cartão nem confirmação por email. Cada conta começa com direito a 1 bot.

Passo 2 · Crie o bot e escolha o número

Em Meus bots → Novo bot, dê um nome (só você vê) e escolha um número da lista. Esse número passa a ser o seu bot: é ele que você divulga pras pessoas, inclusive como link wa.me/55….

Ao salvar, aparece o token da API. Copie e guarde num lugar seguro: ele só aparece uma vez. Se perder, gere outro na tela do bot (o antigo deixa de valer).

Passo 3 · Aponte o webhook

Na tela do bot, cole a URL do webhook: um endereço https seu que aceita POST. Pode ser:

• um script no seu servidor (PHP, Node, Python, o que você usar);
• um nó "Webhook" no n8n, Make, Zapier ou similar;
• pra testar antes de ter algo pronto, um endereço temporário do webhook.site, que mostra na tela tudo que chega.

Salve e clique em Testar webhook. O painel mostra o código HTTP e o tempo de resposta do seu lado. Se deu 200, está ligado.

Passo 4 · Mande uma mensagem

De outro celular, escreva pro número do bot. Em um ou dois segundos chega no seu webhook um JSON parecido com este:

{
  "event": "message",
  "bot_id": 12,
  "message": {
    "id": "3EB0538DA65A59F6D8A251",
    "chat": { "id": "5511999999999@s.whatsapp.net", "type": "private" },
    "from": { "phone": "5511999999999", "name": "Maria" },
    "type": "text",
    "text": "oi"
  }
}

Os campos que você mais vai usar: message.text (o que a pessoa escreveu), message.from.phone (quem escreveu) e message.chat.id (pra onde responder). Foto, áudio e arquivo chegam com type diferente e um campo media.url; a lista completa está na referência.

Passo 5 · Responda

Você tem dois jeitos, e pode usar os dois:

A) Na hora, no corpo da resposta do webhook

Seu webhook responde 200 com um JSON e pronto, a mensagem vai pra pessoa. É o jeito mais simples pra bots de pergunta e resposta.

{ "text": "Oi, Maria! Em que posso ajudar?" }

Dá pra mandar várias mensagens e mídia de uma vez:

{ "messages": [
  { "type": "text",  "text": "Segue o cardápio de hoje:" },
  { "type": "image", "url": "https://seusite.com/cardapio.jpg" }
] }

Regra prática: responda em menos de 25 segundos. Se o seu processamento demora mais que isso (chamar uma IA, consultar sistemas), responda 200 vazio na hora e use o jeito B.

B) Quando quiser, pela API do bot

Com o token, você manda mensagem a qualquer momento, inclusive sem a pessoa ter escrito antes (lembrete, confirmação de pedido, aviso).

curl -X POST https://whatsbot.maike.my/bot<SEU_TOKEN>/sendMessage \
  -H 'Content-Type: application/json' \
  -d '{"to": "5511999999999", "text": "Seu pedido saiu para entrega."}'

Trocando sendMessage por sendMedia você envia imagem, áudio, vídeo ou documento por URL. Os métodos estão todos na referência.

Exemplo completo em 6 linhas (PHP)

Um webhook que repete o que a pessoa disse. Suba num servidor com https e cole a URL no painel.

<?php
$in = json_decode(file_get_contents('php://input'), true);
if (($in['event'] ?? '') !== 'message') exit;          // ignora o evento de teste
$texto = $in['message']['text'] ?? '(sem texto)';
header('Content-Type: application/json');
echo json_encode(['text' => "Você disse: $texto"]);

Exemplo em Node (Express)

app.post('/whatsbot', express.json(), (req, res) => {
  if (req.body.event !== 'message') return res.sendStatus(200);
  const texto = req.body.message.text || '(sem texto)';
  res.json({ text: `Você disse: ${texto}` });
});

Sem programar: n8n, Make, Zapier

1. Crie um fluxo que começa com um nó Webhook (método POST). Copie a URL de produção e cole no painel do bot.
2. Monte a lógica que quiser (IA, planilha, CRM).
3. Pra responder na hora, termine com um nó "Respond to Webhook" devolvendo JSON {"text": "..."}. Pra responder depois, use um nó HTTP Request chamando sendMessage com o token.

Confirmando que o POST veio do WhatsBot

Todo POST leva o header X-Whatsbot-Secret com o segredo que aparece na tela do bot. Compare antes de processar; se não bater, ignore. Quem prefere assinatura tem o X-Whatsbot-Signature (HMAC-SHA256 do corpo), explicado na referência.

Grupos

Por padrão o bot só recebe conversa privada. Se o número for adicionado a um grupo e você quiser tratar essas mensagens, ligue Receber mensagens de grupos na tela do bot. Aí chat.type vem group e from é quem falou no grupo.

Perguntas frequentes

O WhatsBot guarda as conversas?

Não. Nem o texto, nem o telefone de quem escreveu. O painel mostra só hora, código HTTP e tempo de resposta do seu webhook, por 7 dias. Se você precisa de histórico, grave do seu lado.

E se meu webhook estiver fora do ar?

A mensagem é contada como falha e não é reenviada. O painel mostra o erro. Deixe seu webhook respondendo 200 rápido e faça o trabalho pesado depois.

Posso pausar o bot?

Sim: desmarque "Bot ativo" na tela dele. As mensagens param de ser entregues até você religar.

Posso mandar mensagem pra quem nunca falou com o bot?

Tecnicamente sim, via sendMessage. Use com critério: o WhatsApp limita e pode bloquear números que disparam pra desconhecidos.

Apaguei o bot, e o número?

Ele fica em quarentena por 7 dias e depois volta pra lista. Quem ainda mandar mensagem nesse período não recebe resposta.

Perdi o token.

Na tela do bot, "Gerar novo token". O anterior para de funcionar na hora; atualize onde você usava.