curl --request POST \
--url https://api.wabox.me/instances/{instance_id}/token/{token}/send-text \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511988887777",
"message": "Olá! Seu pedido *#1234* foi confirmado."
}
'{
"id": "3EB0A9C6D2F1E4B5A7C8",
"message_id": "3EB0A9C6D2F1E4B5A7C8",
"wabox_id": "wbx_01J5Q8ZK3M4N5P6Q7R8S9T0M01",
"status": "queued"
}{
"error": {
"code": "instance_not_found",
"message": "Instance not found or invalid token"
}
}{
"error": {
"code": "subscription_required",
"message": "Trial expired or subscription inactive. Subscribe in the dashboard to keep sending."
}
}{
"error": {
"code": "queue_disabled_while_disconnected",
"message": "Instance is disconnected and enqueueing while disconnected is disabled"
}
}{
"error": {
"code": "queue_full",
"message": "Queue is full (1000 messages waiting)"
}
}Suporta resposta (reply_to_message_id), menções e edição (edit_message_id). Formatação do texto: *negrito*, _itálico_, ~riscado~ e ```mono```.
A mensagem entra na fila e é enviada de forma assíncrona; message_id já é o id definitivo no WhatsApp (id é um alias dele) e o resultado chega no webhook delivery.
Ritmo de envio (anti-ban): cada mensagem espera um atraso aleatório antes de sair (configurações da instância delay_message_min_ms/delay_message_max_ms, padrão 1–3 s; defina os dois como 0 para desativar), contado a partir do fim da mensagem anterior da mesma instância quando ainda houver uma em andamento. delay_message (segundos, 0–15) substitui esse atraso só para esta mensagem e delay_typing (segundos, 0–15) mostra “digitando…” por esse tempo antes de enviar.
curl --request POST \
--url https://api.wabox.me/instances/{instance_id}/token/{token}/send-text \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511988887777",
"message": "Olá! Seu pedido *#1234* foi confirmado."
}
'{
"id": "3EB0A9C6D2F1E4B5A7C8",
"message_id": "3EB0A9C6D2F1E4B5A7C8",
"wabox_id": "wbx_01J5Q8ZK3M4N5P6Q7R8S9T0M01",
"status": "queued"
}{
"error": {
"code": "instance_not_found",
"message": "Instance not found or invalid token"
}
}{
"error": {
"code": "subscription_required",
"message": "Trial expired or subscription inactive. Subscribe in the dashboard to keep sending."
}
}{
"error": {
"code": "queue_disabled_while_disconnected",
"message": "Instance is disconnected and enqueueing while disconnected is disabled"
}
}{
"error": {
"code": "queue_full",
"message": "Queue is full (1000 messages waiting)"
}
}Path Parameters
Id da instância (dashboard › instância › Credenciais).
Token da instância. Trate como senha.
Body
Chat de destino: número só dígitos com DDI e DDD (5511988887777), grupo (<id>-group), canal (<id>@newsletter), LID (<id>@lid) ou status@broadcast.
1^(\d{5,20}|\d+@lid|\d+(-\d+)?-group|\d+@g\.us|\d+@newsletter|\d+@broadcast|status@broadcast)$Texto da mensagem. Aceita a formatação do WhatsApp (*negrito*, _itálico_, ~riscado~, ```mono```).
1 - 65536Id da mensagem a citar (responder), no mesmo chat.
1Números a mencionar; cada um precisa aparecer no texto como @<número>.
5001^(\d{5,20}|\d+@lid|\d+(-\d+)?-group|\d+@g\.us|\d+@newsletter|\d+@broadcast|status@broadcast)$Grupos: menciona todos os participantes.
Edita a mensagem indicada (só mensagens suas recentes que o engine tem em cache).
1Segundos (0–15) de espera antes de enviar, substituindo o intervalo aleatório da instância (delay_message_min_ms/max_ms).
0 <= x <= 15Segundos (0–15) mostrando "digitando…" (ou "gravando…" em voice notes) antes de enviar. Padrão 0.
0 <= x <= 15