Sequências

Sequências são mensagens agendadas que a plataforma dispara automaticamente. Estes dois endpoints permitem consultar e cancelar uma sequência pendente.

Consultar sequência

string

required

Telefone do contato, com código do país e apenas dígitos.

string

Identificador do número de WhatsApp. Opcional — veja a observação abaixo.

curl 'https://api.wizebot.com.br/api/v1/whatsapp/sequences/status?phone_number=5511999999999' \
  -H 'Authorization: Bearer API-KEY'

{
  "success": true,
  "data": {
    "scheduled_at": "2026-09-09T10:00:00.000Z",
    "source": "flow",
    "is_template": true
  },
  "timestamp": "2026-09-09T02:30:00.000Z"
}

{
  "success": true,
  "data": null,
  "timestamp": "2026-09-09T02:30:00.000Z"
}

Cancelar sequência

string

required

Telefone do contato, com código do país e apenas dígitos.

string

Identificador do número de WhatsApp. Opcional — veja a observação abaixo.

string

default:"Cancelado via API externa"

Motivo do cancelamento, registrado no histórico.

curl -X POST 'https://api.wizebot.com.br/api/v1/whatsapp/sequences/cancel' \
  -H 'Authorization: Bearer API-KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone_number": "5511999999999",
    "reason": "Cliente concluiu a compra"
  }'

{
  "success": true,
  "data": { "canceled": true, "message": "Sequence canceled successfully." },
  "timestamp": "2026-09-08T19:30:00.000Z"
}

{
  "success": true,
  "data": { "canceled": false, "message": "No active sequence found for this contact." },
  "timestamp": "2026-09-08T19:30:00.000Z"
}

canceled: false não é erro: significa que não havia sequência pendente para aquele contato.

Sobre o `phone_number_id` opcional

Nestes dois endpoints o phone_number_id é opcional. Se a sua empresa tem mais de um número de WhatsApp e você omitir esse parâmetro, o contato é escolhido pelo de interação mais recente entre os números que compartilham aquele telefone.Com múltiplos números, informe sempre o phone_number_id — do contrário, duas chamadas idênticas podem atingir contatos diferentes.

Erros

HTTP	Código	Causa
400	`MISSING_PARAM`	Falta `phone_number`
404	`CONTACT_NOT_FOUND`	Contato inexistente
500	`STATUS_FAILED`	Falha ao consultar
500	`CANCEL_FAILED`	Falha ao cancelar

Primeiros Passos

Modelos de Mensagem

Automação e Bots

Contatos

Atendimento

Campanhas

Automação

Agentes IA

API WhatsApp

Novidades

Suporte

Consultar sequência

Cancelar sequência

Sobre o `phone_number_id` opcional

Erros

​Consultar sequência

​Cancelar sequência

​Sobre o phone_number_id opcional

​Erros

Consultar sequência

Cancelar sequência

Sobre o `phone_number_id` opcional

Erros