curl --request POST \
--url https://api.wabox.me/instances/{instance_id}/token/{token}/send-document \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511988887777",
"document": "https://exemplo.com/fatura-1234.pdf"
}
'{
"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)"
}
}Enviar documento
A mídia pode ser uma URL http(s) (baixada pelo engine), uma data: URL ou base64 puro. Use mime_type/file_name quando o tipo não puder ser inferido. Limites: 16 MB para imagens/áudios/vídeos/stickers, 100 MB para documentos (arquivos maiores falham no webhook delivery com media_invalid). Envios de mídia são processados um por vez por instância. A extensão pode ir no path (send-document/pdf, no estilo z-api) ou no body (extension); ela define o nome do arquivo/MIME type quando faltarem (document.pdf se file_name não for enviado). Extensão inválida (fora de [a-z0-9]{1,10}) responde 400 invalid_request.
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.
curl --request POST \
--url https://api.wabox.me/instances/{instance_id}/token/{token}/send-document \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511988887777",
"document": "https://exemplo.com/fatura-1234.pdf"
}
'{
"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.
Extensão do arquivo (pdf, xlsx…). Alternativa ao campo extension do body.
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)$URL http(s) pública, data: URL ou base64 puro.
1 - 94371840^[A-Za-z0-9]{1,10}$Legenda.
655361Sobrescreve o MIME type detectado.
1 - 255Nome do arquivo (documentos) — também usado para inferir o MIME type.
1 - 255Id 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.
Segundos (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