Skip to main content
POST
Criar webhook

Autorizações

x-api-key
string
header
obrigatório

Sua chave de API ps_

Cabeçalhos

x-whatsapp-number-id
string

Restringe ao contexto de um número (obrigatório em concessões OAuth por número).

Corpo

application/json
url
string
obrigatório

Endpoint HTTPS que receberá os eventos.

Exemplo:

"https://hooks.acme.com/whatsapp"

name
string

Nome de exibição (padrão: hostname da URL).

Exemplo:

"n8n"

events
string[]

Eventos a assinar (ex.: ["message.received"]); "*" = todos. Vazio/omitido = não dispara nada.

Exemplo:
whatsappNumberId
string

Número alvo — necessário só com key de tenant sem cabeçalho de número; com key de número deve coincidir com o escopo (400 NUMBER_MISMATCH).

Exemplo:

"num_01HZX..."

Resposta

Criar webhook