Mande a sua primeira mensagem
Uma chave, um número pareado, um POST. Se qualquer parte disso levar mais de cinco minutos, é bug do produto. Fale com a gente.
1 · Crie uma chave de API
No painel, abra Chaves de API e crie uma. Ela começa com wa_ e aparece uma única vez, então copie para um lugar seguro. A mesma chave vale para a API REST e para o MCP.
2 · Pareie um número
Abra Números, adicione um número e escaneie o QR code pelo WhatsApp, em Configurações → Aparelhos conectados. É o mesmo caminho de conectar o WhatsApp Web. Seu celular continua funcionando o tempo todo, porque isto é um aparelho conectado e não uma cópia. Também perguntamos há quanto tempo a linha está em uso, porque isso define quantas conversas novas ela pode começar por dia. Se o seu plano é abordagem fria em volume, pareie um celular reserva.
3 · Envie
import { Whatsapi } from "@whatsapi.sh/sdk";
const wa = new Whatsapi({ apiKey: "wa_your_key" });
const data = await wa.sendMessage({ to: "+5511988887777", text: "Hello from whatsapi!" });{
"data": {
"id": "9c1f0b7e-8b1a-4a2e-9b0a-1f2e3d4c5b6a",
"to": "+5511988887777",
"from": "your-number-id",
"status": "queued",
"scheduledAt": "2026-08-24T19:18:00.000Z",
"timestamp": "2026-08-24T19:00:00.000Z",
"quotaRemaining": 199
}
}Mensagens que você inicia voltam como queued, não como sent, mesmo para quem já conversou com o número. Elas saem com 15 a 25 minutos de intervalo por padrão. A fila de envio explica o tempo de espera. Respostas saem na hora quando a pessoa escreveu para o seu número nas últimas 24 horas. Os recibos chegam no seu webhook.
O passeio é esse
Mídia, OTP, consulta de números e recibos estão todos na referência REST. De TypeScript ou JavaScript, o cliente npm é a mesma superfície com tipos. Se o seu cliente é um agente, o servidor MCP entrega as mesmas operações como ferramentas. Antes de crescer além dos envios de teste, leia como não ser banido.