Skip to main content
WEBHOOK

Headers

X-Wabox-Event
enum<string>
required

Tipo do evento.

Available options:
delivery
X-Wabox-Event-Id
string
required

Id único do evento (ULID). Use para deduplicar.

X-Wabox-Instance-Id
string
required

Instância que gerou o evento.

X-Wabox-Signature
string

t=<unix seconds>,v1=<hex>v1 = HMAC-SHA256(secret, "<t>.<corpo cru>"). Ausente quando a instância não tem segredo.

Body

application/json
type
enum<string>
required
Available options:
delivery
event_id
string
required
Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
instance_id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
momment
integer
required
Required range: 0 <= x <= 9007199254740991
wabox_id
string
required
phone
string
required
Minimum string length: 1
Pattern: ^(\d{5,20}|\d+@lid|\d+(-\d+)?-group|\d+@g\.us|\d+@newsletter|\d+@broadcast|status@broadcast)$
message_id
string
Minimum string length: 1
error
string
error_code
enum<string>
Available options:
instance_not_found,
instance_not_connected,
instance_already_connected,
instance_starting,
invalid_phone,
phone_not_on_whatsapp,
invalid_request,
send_failed,
send_timeout,
not_allowed,
shadow_ban,
group_suspended,
media_download_failed,
media_invalid,
message_not_found,
group_not_found,
chat_not_found,
invite_link_invalid,
newsletter_not_found,
product_not_found,
label_not_found,
order_not_found,
action_failed,
engine_unavailable,
internal

Response

2XX

Qualquer 2xx confirma o recebimento. Outros códigos (ou timeout de 10 s) agendam nova tentativa.