Pular para o conteúdo
WbizTool

Envie lembretes recorrentes de WhatsApp com a API

Envie a mesma mensagem de WhatsApp seguindo uma agenda – o aluguel do mês, o horário semanal, um check-in diário – do seu próprio número. Crie o lembrete uma vez com uma expressão cron e um fuso horário, e o WbizTool coloca a mensagem na fila cada vez que a agenda bate. Os lembretes fazem parte de todos os planos pagos, a partir de US$ 25 por mês nos EUA (o seu preço aparece em Preços).

Comece grátis

Os lembretes precisam de um plano pago: a partir de US$ 25 por mês nos EUA.

Como funciona

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

    Conecte seu número de WhatsApp na página Números do WhatsApp com um código QR ou um código de login, e crie uma chave em Configurações → Chaves de API. Os lembretes precisam de um plano pago (Lite, Standard, Advanced ou Enterprise).

  2. Escolha a agenda

    Escreva-a como uma expressão cron de cinco campos: 0 10 1 * * é às 10:00 do dia 1º de cada mês, 0 9 * * 1-5 é às 9:00 em dias úteis. Adicione um fuso horário IANA, como Asia/Kolkata.

  3. Crie o lembrete

    Faça um POST para /api/v1/reminder/create/ com reminder_name, phone, message, cron_expression e timezone. Guarde o reminder_id da resposta.

  4. Liste ou cancele depois

    /api/v1/reminder/list/ devolve seus lembretes, 50 por página. /api/v1/reminder/cancel/ com o reminder_id para um lembrete de vez – por exemplo, quando o cliente paga.

Exemplos de código: API de lembretes

Criar um lembrete mensal
curl -X POST https://wbiztool.com/api/v1/reminder/create/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 678,
    "reminder_name": "Monthly rent reminder",
    "phone": "919876543210",
    "message": "Hi Aman, a reminder that your rent is due on {current_date_formatted}.",
    "cron_expression": "0 10 1 * *",
    "timezone": "Asia/Kolkata"
  }'
Criar um lembrete em Python
import requests

response = requests.post(
    "https://wbiztool.com/api/v1/reminder/create/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "reminder_name": "Monthly rent reminder",
        "phone": "919876543210",
        "message": "Hi Aman, a reminder that your rent is due on {current_date_formatted}.",
        "cron_expression": "0 10 1 * *",
        "timezone": "Asia/Kolkata",
    },
    timeout=60,
)

try:
    result = response.json()  # read the body even when the HTTP code is 400
except ValueError:
    raise SystemExit(f"HTTP {response.status_code}: not JSON. Send every text value as a string.")

if result["status"] == 1:
    print("Reminder created with reminder_id", result["reminder_id"])
else:
    print("Failed:", result["message"])
Um lembrete semanal com imagem
import requests

response = requests.post(
    "https://wbiztool.com/api/v1/reminder/create/",
    json={
        "client_id": 12345,
        "api_key": "YOUR_API_KEY",
        "whatsapp_client": 678,
        "reminder_name": "Weekly class timetable",
        "phone": "919876543210",
        "msg_type": 1,
        "img_url": "https://example.com/timetable.png",
        "message": "Here is this week's timetable.",
        "cron_expression": "0 8 * * 1",
        "timezone": "Asia/Kolkata",
    },
    timeout=60,
)
print(response.status_code, response.text)
Listar seus lembretes
curl -X POST https://wbiztool.com/api/v1/reminder/list/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "page": 1
  }'
Cancelar um lembrete
curl -X POST https://wbiztool.com/api/v1/reminder/cancel/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "reminder_id": "3187"
  }'

O que você pode fazer

  • Qualquer agenda que o cron consiga expressar

    Todo dia às 9:00 (0 9 * * *), toda segunda (0 9 * * 1), duas vezes por dia (0 9,18 * * *), no dia 15 de cada mês (0 10 15 * *) ou a cada 6 horas (0 */6 * * *).

  • Datas preenchidas para você

    Variáveis como {current_date_formatted}, {current_time_12h} e {reminder_name} são substituídas cada vez que o lembrete é executado, no fuso horário dele.

  • Imagens e arquivos

    msg_type 1 envia uma imagem de img_url. Para um arquivo, use msg_type 2 com a URL pública do arquivo em img_url e o nome dele em file_name.

  • Visíveis no seu painel

    Os lembretes criados pela API também aparecem na página Lembretes, onde você pode pausá-los ou editá-los. Essa página também importa muitos lembretes de uma planilha CSV ou Excel.

  • Envia do número que você escolher

    Defina whatsapp_client para escolher o número. Se deixar de fora, cada execução usa um número que esteja conectado naquele momento.

Bom saber

  • Os lembretes precisam de um plano pago. No teste grátis, a API responde Upgrade your plan to use reminders feature.
  • Use nomes de fuso horário IANA, como Asia/Kolkata ou America/Chicago. Siglas como IST ou CST são recusadas com Invalid timezone; sem fuso horário, a agenda roda em UTC.
  • phone recebe o número com o código do país, como 919876543210 – não há campo country_code neste endpoint.
  • Não há chamada de atualização nem de pausa na API. Para mudar uma agenda, cancele o lembrete e crie um novo; para pausar, use a página Lembretes.
  • Os lembretes são verificados periodicamente, não ao segundo, então uma execução pode sair até 10 minutos depois do horário; se uma verificação atrasar mais que isso, a execução é ignorada. Cada execução conta nas 1.000 mensagens por dia do número.
  • Em Listar lembretes, next_run é calculado como se o fuso horário do lembrete fosse UTC. Confira o próximo horário certo na página Lembretes.
  • Se um campo de texto como phone, message ou reminder_name for enviado como número, true ou null, a resposta é uma página de erro em HTML (HTTP 500), então envie valores de texto como strings e trate um corpo que não seja JSON, como faz o exemplo em Python.
  • Se o número em whatsapp_client estiver desconectado quando você criar o lembrete, a API o recusa com WhatsApp Logged Out. Please Reconnect!!
  • 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 a diferença entre um lembrete e uma mensagem agendada?
Uma mensagem agendada (/api/v1/schedule_msg/) sai uma vez, na data e hora que você informar. Um lembrete se repete seguindo a agenda cron até você cancelá-lo.
Como paro um lembrete quando o cliente paga?
Chame /api/v1/reminder/cancel/ com o reminder_id dele. Ele para na hora e não roda de novo. Uma mensagem que ele já tinha colocado na fila antes do cancelamento ainda pode ser enviada.
Posso pausar ou editar um lembrete pela API?
Ainda não. Pause ou edite na página Lembretes do seu painel, ou cancele e crie um novo com a nova agenda.
Um lembrete pode enviar um PDF?
Sim. Use msg_type 2, coloque a URL pública do arquivo em img_url e o nome com a extensão (como invoice.pdf) em file_name. O arquivo é baixado cada vez que o lembrete roda, então mantenha o link funcionando.
Quais planos incluem lembretes?
Todos os planos pagos: Lite (1 número), Standard (3 números) e Advanced (10 números) – US$ 25, US$ 59 e US$ 149 por mês nos EUA; Preços mostra o preço do seu país. Todos enviam mensagens ilimitadas dentro do uso justo. O teste grátis não inclui lembretes.

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