Guia rápido

Automatize seu WhatsApp em 2 passos

Conecte um número e comece a enviar mensagens — pelo painel ou pela nossa API, direto do seu sistema ou de uma inteligência artificial.

Conecte seu WhatsApp (QR Code)

Igual ao WhatsApp Web: você lê um QR Code com o celular e o número fica conectado à plataforma.

Pelo painel

Menu Ler QR Code → no celular abra WhatsApp → Aparelhos conectados → Conectar um aparelho e escaneie. Pronto.

Pela API

POST

# gera um QR Code para conectar um número
curl -X POST https://chatbot.menuia.com/api/v2/qrcode \
  -H "Content-Type: application/json" \
  -d '{
    "authkey":   "SUA_AUTHKEY",
    "setAppkey": "nome-do-seu-app",
    "webhook":   "https://seusite.com/receber"
  }'

A resposta traz o QR Code e o código de pareamento. O webhook é onde você recebe as mensagens que chegam (opcional).

Aguarde a conexão (polling)

Depois de exibir o QR, chame o MESMO endpoint a cada poucos segundos. Enquanto não escanearam ele devolve o QR; assim que o número conecta, devolve conected: true com o telefone.

Sugestão de intervalo: a cada 5 segundos, até conectar — ou ~60s, aí gere um QR novo.

JavaScript

async function aguardarConexao() {
  while (true) {
    const r = await fetch("https://chatbot.menuia.com/api/v2/qrcode", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ authkey: "SUA_AUTHKEY", setAppkey: "nome-do-seu-app" })
    });
    const { data } = await r.json();

    if (data.conected) {                        // conectou!
      console.log("Conectado! Número:", data.phone);
      break;
    }
    mostrarQr(data.qr);                           // atualiza o QR na tela
    await new Promise(s => setTimeout(s, 5000));   // espera 5s
  }
}

Resposta quando conecta (sucesso)

JSON

{ "data": { "id": 12345, "conected": true, "phone": "5511999999999" } }

Resposta enquanto aguarda o scan

JSON

{ "data": { "qr": "2@ABC...", "code": "ABCD-1234", "conected": false } }

Obs.: o campo é conected (com um n só) — é assim que a API responde. Prefere não ficar consultando? Informe um webhook ao gerar o QR e a gente avisa seu sistema no momento em que conectar.

Envie uma mensagem

Com o número conectado, envie por uma única chamada de API.

POST

# envia uma mensagem de texto
curl -X POST https://chatbot.menuia.com/api/create-message \
  -H "Content-Type: application/json" \
  -d '{
    "authkey": "SUA_AUTHKEY",
    "appkey":  "nome-do-seu-app",
    "to":      "5511999999999",
    "message": "Olá! Enviado pela API da MenuIA."
  }'

Campo	Descrição
`authkey`	Sua chave pessoal (fica no painel, em Auth Key)
`appkey`	O identificador do número que vai enviar
`to`	Destinatário com DDI + DDD, ex. `5511999999999`
`message`	O texto da mensagem

Integre no seu sistema ou com uma IA

É só uma requisição HTTP — qualquer linguagem, ou um agente de IA, consegue enviar mensagens.

Python

import requests

requests.post("https://chatbot.menuia.com/api/create-message", json={
    "authkey": "SUA_AUTHKEY",
    "appkey":  "nome-do-seu-app",
    "to":      "5511999999999",
    "message": "Enviado pelo meu sistema 🚀",
})

Com IA (function calling): dê essa "ferramenta" ao seu agente e ele envia mensagens de WhatsApp sozinho.

Tool (IA)

{
  "name": "enviar_whatsapp",
  "description": "Envia uma mensagem de WhatsApp pela MenuIA",
  "endpoint": "POST https://chatbot.menuia.com/api/create-message",
  "parameters": { "to": "numero", "message": "texto" },
  "fixos": { "authkey": "SUA_AUTHKEY", "appkey": "nome-do-seu-app" }
}

Dicas importantes

Número sempre com DDI + DDD (Brasil = 55). Ex.: 5511999999999.
Mantenha o celular do número conectado à internet.
Para receber as mensagens que chegam, configure um webhook — avisamos seu sistema em tempo real.
Documentação técnica completa em docs.menuia.com.

Pronto para começar?

Crie sua conta, conecte um número e envie sua primeira mensagem em minutos.

Comece Grátis