curl --request POST \
--url https://api.wabox.me/instances/{instance_id}/token/{token}/send-sticker \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511988887777",
"sticker": "https://exemplo.com/sticker.webp"
}
'const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({phone: '5511988887777', sticker: 'https://exemplo.com/sticker.webp'})
};
fetch('https://api.wabox.me/instances/{instance_id}/token/{token}/send-sticker', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.wabox.me/instances/{instance_id}/token/{token}/send-sticker"
payload = {
"phone": "5511988887777",
"sticker": "https://exemplo.com/sticker.webp"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wabox.me/instances/{instance_id}/token/{token}/send-sticker",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone' => '5511988887777',
'sticker' => 'https://exemplo.com/sticker.webp'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.wabox.me/instances/{instance_id}/token/{token}/send-sticker"
payload := strings.NewReader("{\n \"phone\": \"5511988887777\",\n \"sticker\": \"https://exemplo.com/sticker.webp\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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 sticker
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. WebP é enviado como está; PNG/JPEG/GIF são convertidos para WebP 512×512 quando o engine tem ffmpeg.
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-sticker \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511988887777",
"sticker": "https://exemplo.com/sticker.webp"
}
'const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({phone: '5511988887777', sticker: 'https://exemplo.com/sticker.webp'})
};
fetch('https://api.wabox.me/instances/{instance_id}/token/{token}/send-sticker', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.wabox.me/instances/{instance_id}/token/{token}/send-sticker"
payload = {
"phone": "5511988887777",
"sticker": "https://exemplo.com/sticker.webp"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wabox.me/instances/{instance_id}/token/{token}/send-sticker",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone' => '5511988887777',
'sticker' => 'https://exemplo.com/sticker.webp'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.wabox.me/instances/{instance_id}/token/{token}/send-sticker"
payload := strings.NewReader("{\n \"phone\": \"5511988887777\",\n \"sticker\": \"https://exemplo.com/sticker.webp\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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)$URL http(s) pública, data: URL ou base64 puro.
1 - 94371840Sobrescreve 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