curl --request POST \
--url https://api.wabox.me/instances/{instance_id}/token/{token}/pin-message \
--header 'Content-Type: application/json' \
--data '
{
"phone": "120363012345678901-group",
"message_id": "3EB0A9C6D2F1E4B5A7C8"
}
'{
"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)"
}
}pin: false desafixa. duration_seconds aceita 86400 (24 h), 604800 (7 dias, padrão) ou 2592000 (30 dias). Não aceita delay_message/delay_typing.
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.
POST
/
instances
/
{instance_id}
/
token
/
{token}
/
pin-message
curl --request POST \
--url https://api.wabox.me/instances/{instance_id}/token/{token}/pin-message \
--header 'Content-Type: application/json' \
--data '
{
"phone": "120363012345678901-group",
"message_id": "3EB0A9C6D2F1E4B5A7C8"
}
'{
"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
application/json
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.
Minimum string length:
1Pattern:
^(\d{5,20}|\d+@lid|\d+(-\d+)?-group|\d+@g\.us|\d+@newsletter|\d+@broadcast|status@broadcast)$Minimum string length:
1duration_seconds
Option 1 · enum<number>Option 2 · enum<number>Option 3 · enum<number>
default:604800
Available options:
86400 Se a mensagem referenciada foi enviada por esta instância. Padrão: o que o engine registrou, senão false.
Grupos: número do participante que enviou a mensagem referenciada.
Minimum string length:
1Pattern:
^(\d{5,20}|\d+@lid|\d+(-\d+)?-group|\d+@g\.us|\d+@newsletter|\d+@broadcast|status@broadcast)$