Pular para o conteúdo
WbizTool

Envie mensagens de WhatsApp com cURL

Teste a API do WhatsApp do WbizTool no seu terminal antes de escrever qualquer código. Cada comando abaixo é um POST para https://wbiztool.com/api/v1/, e a mensagem sai do seu próprio número, conectado como no WhatsApp Web.

Comece grátis

Teste grátis: 50 mensagens em quaisquer 30 dias, sem cartão.

Como funciona

  1. Pegue sua chave de API e conecte seu número

    Cadastre-se e conecte seu número de WhatsApp na página Números do WhatsApp com um código QR ou um código de login, como no WhatsApp Web. Em Configurações → Chaves de API, crie uma chave e copie seu Client ID (o guia de chaves de API abaixo mostra onde). O ID no cartão do número (como ID 678) é o seu whatsapp_client.

  2. Teste suas credenciais

    Faça um POST com seu client_id e sua api_key para /api/v1/me/. "status": 1 com "message": "Okay" significa que funcionam. Nada é enviado e nenhuma mensagem é usada.

  3. Envie uma mensagem

    Faça um POST para /api/v1/send_msg/ com o número de telefone e o texto. Uma resposta com "status": 1 e um msg_id significa que a mensagem está na fila do seu número.

  4. Confira se ela saiu

    Faça um POST para /api/v1/message/status/<msg_id>/. Status 1 significa Enviada; status 2 significa Falhou, com o motivo em error.

Exemplos de código: cURL

Verificar suas credenciais
curl -X POST https://wbiztool.com/api/v1/me/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678
  }'
Enviar um texto
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Hi Aman, your order #4821 has shipped and will arrive on Thursday."
  }'
Resposta
{"status": 1, "message": "Created", "msg_id": 9817263}
Enviar uma imagem a partir de uma URL
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 1,
    "country_code": "91",
    "phone": "9876543210",
    "img_url": "https://example.com/offers/diwali-sale.jpg",
    "msg": "Our Diwali sale starts today 🎉"
  }'
Enviar um PDF a partir de uma URL
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 2,
    "country_code": "91",
    "phone": "9876543210",
    "file_url": "https://example.com/invoices/invoice-4821.pdf",
    "file_name": "invoice-4821.pdf",
    "msg": "Your invoice for order #4821 is attached."
  }'
Enviar um arquivo do seu computador
curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -F client_id=12345 \
  -F api_key=YOUR_API_KEY \
  -F whatsapp_client=678 \
  -F msg_type=2 \
  -F country_code=91 \
  -F phone=9876543210 \
  -F "msg=Your invoice for order #4821 is attached." \
  -F file_name=invoice-4821.pdf \
  -F file=@./invoice-4821.pdf
Agendar uma mensagem
curl -X POST https://wbiztool.com/api/v1/schedule_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "msg_type": 0,
    "country_code": "91",
    "phone": "9876543210",
    "msg": "Hi Aman, a reminder that your appointment is today at 11:30 AM.",
    "date": "24/12/2026",
    "time": "09:00",
    "timezone": "Asia/Kolkata"
  }'
Consultar o status da mensagem
curl -X POST https://wbiztool.com/api/v1/message/status/9817263/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY"
  }'

O que você pode fazer

  • JSON ou campos de formulário

    Envie o corpo como JSON, como campos de formulário ou como multipart form data (-F) quando enviar um arquivo. Os exemplos funcionam como estão depois que você coloca seus próprios IDs e sua chave.

  • Imagens e arquivos

    msg_type 1 envia uma imagem de img_url, msg_type 2 um arquivo de file_url. Arquivos por link podem ter até 100 MB, e o link precisa ser público.

  • Agende com fuso horário

    schedule_msg aceita date (dd/mm/aaaa), time (HH:MM) e o nome de um timezone, como America/New_York, ou uma sigla, como IST ou EST.

  • Webhooks para cada status

    Adicione "webhook": "https://…" e o WbizTool faz um POST com msg_id e SENT, FAILED, CANCELLED ou EXPIRED para ela quando a mensagem muda.

  • As mesmas chamadas em qualquer ferramenta

    Make, Pabbly Connect e outras ferramentas de automação enviam essas mesmas requisições com o módulo HTTP delas. Também há uma coleção do Postman na documentação.

Bom saber

  • "status": 1 significa que a mensagem está na fila, não que foi entregue. Enviada é o estado final de sucesso; a API não informa se a mensagem foi entregue ou lida.
  • Dentro do JSON, escreva uma quebra de linha em msg como \n. Uma quebra de linha real ou uma vírgula sobrando no final deixa o JSON inválido.
  • Um horário agendado no passado é aceito e enviado na hora. A data vem com o dia primeiro (24/12/2026), então confira antes de enviar.
  • Os erros de envio de mensagem voltam com HTTP 400 (429 no limite diário); os erros de agendamento costumam voltar com HTTP 200 e "status": 0, então sempre decodifique o corpo e confira status.
  • Enviar para um grupo do WhatsApp pela API (group_name em vez de phone) funciona em todos os planos, inclusive no teste grátis.
  • O teste grátis tem 50 mensagens em quaisquer 30 dias e 1 número, sem cartão. Os planos pagos começam em US$ 25 por mês nos EUA (o seu preço aparece em Preços) e enviam mensagens ilimitadas dentro do uso justo: até 1.000 por dia por número.
  • As mensagens saem do seu próprio número de WhatsApp, então as regras do próprio WhatsApp valem: mande mensagens para quem espera ter notícias suas.

Perguntas frequentes

Qual é o endpoint da API do WhatsApp para enviar uma mensagem?
POST https://wbiztool.com/api/v1/send_msg/ com client_id, api_key, whatsapp_client, phone (mais country_code se o número não tiver) e msg. A resposta traz status e, em caso de sucesso, um msg_id.
Como agendo uma mensagem de WhatsApp com cURL?
Faça um POST para https://wbiztool.com/api/v1/schedule_msg/ com os mesmos campos mais date (dd/mm/aaaa), time (HH:MM) e timezone. O msg_id da resposta permite consultar ou cancelar a mensagem depois.
Como sei que a mensagem foi enviada?
Uma resposta com "status": 1 e um msg_id significa que ela está na fila. Passe uma URL em webhook para receber um POST com SENT, FAILED, CANCELLED ou EXPIRED, ou chame o endpoint de status da mensagem com o msg_id. Enviada é o estado final: a API não informa se a mensagem foi entregue ou lida.
Em que formato envio o número de telefone?
Envie o número com o código do país (919876543210), ou sem ele (9876543210) junto com country_code (91). Espaços, +, hífens e parênteses são removidos para você, então +91 98765-43210 também funciona.
Preciso da API oficial do WhatsApp Business ou de aprovação da Meta?
Não. O WbizTool envia do seu próprio número de WhatsApp ou WhatsApp Business, conectado como no WhatsApp Web. Não há aprovação da Meta nem modelos de mensagem para aprovar.
A cobrança é por mensagem?
Não. O teste grátis inclui 50 mensagens em quaisquer 30 dias. Os planos pagos enviam mensagens ilimitadas dentro do uso justo, até 1.000 por dia por número: Lite US$ 25, Standard US$ 59 e Advanced US$ 149 por mês nos EUA; Preços mostra o preço do seu país.

Leia os guias

Veja também

Envie hoje sua primeira mensagem automática de WhatsApp

Crie uma conta, escaneie o QR code e envie uma mensagem em menos de cinco minutos.

Comece grátis

Planos pagos a partir de US$ 25 por mês nos EUA. Preços