Pular para o conteúdo principal
POST
/
wa
/
instances
/
{instance_id}
/
webhooks
Registra um novo webhook para a instância
curl --request POST \
  --url https://api.zapsterapi.com/v1/wa/instances/{instance_id}/webhooks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    "message.received"
  ],
  "enabled": true,
  "name": "Meu Webhook",
  "test_mode": false,
  "test_url": null,
  "url": "https://webhook.example.com/receive",
  "webhook_id": "2nenz69l0xbf0m3uu9tfo"
}
'
{
  "created_at": "2025-03-12T23:12:19.448Z",
  "enabled": true,
  "events": [
    "message.received"
  ],
  "id": "3nsnz68l0xbf0m3uu9tfo",
  "name": "Meu Webhook",
  "test_mode": false,
  "test_url": null,
  "url": "https://webhook.mydomain.com"
}

Documentation Index

Fetch the complete documentation index at: https://developer.zapsterapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Este endpoint permite registrar um novo webhook para uma instância específica. Os webhooks são usados para receber notificações em tempo real sobre eventos importantes na instância, como mensagens recebidas ou mudanças de status. ⚠️ Importante: É obrigatório fornecer ou uma url ou um webhook_id. Se nenhum dos dois for informado, a requisição falhará.

​
🔍 Considerações

  • Pelo menos um evento deve ser especificado na criação do webhook.
  • Se uma url e um webhook_id forem fornecidos ao mesmo tempo, o webhook_id será priorizado.
  • O webhook pode ser desativado posteriormente usando a propriedade enabled.

Autorizações

​
Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

​
instance_id
string
obrigatório

Identificador único da instância.

Corpo

application/json
​
events
enum<string>[]
obrigatório

Lista de eventos que acionam o webhook. Deve conter pelo menos um evento.

Opções disponíveis:
group.created,
group.participants_added,
group.participants_demoted,
group.participants_promoted,
group.participants_removed,
group.updated,
instance.connected,
instance.disconnected,
instance.forbidden,
instance.mentioned,
instance.qrcode,
message.deleted,
message.delivered,
message.pinned,
message.reaction,
message.read,
message.received,
message.sent,
message.unpinned,
poll.created,
poll.deleted,
poll.updated
Exemplo:
["message.received"]
​
enabled
boolean

Define se o webhook está ativado. Padrão: true.

Exemplo:

true

​
name
string

Nome do webhook configurado.

Exemplo:

"Meu Webhook"

​
test_mode
boolean

Indica se o webhook está em modo de teste. Padrão: false.

Exemplo:

false

​
test_url
string<uri> | null

URL de teste para validar o webhook, se aplicável.

Exemplo:

null

​
url
string<uri>

URL para onde os eventos do webhook serão enviados. Obrigatório caso webhook_id não seja fornecido.

Exemplo:

"https://webhook.example.com/receive"

​
webhook_id
string

ID de um webhook existente para ser reutilizado. Obrigatório caso url não seja fornecida.

Exemplo:

"2nenz69l0xbf0m3uu9tfo"

Resposta

201 - application/json

Webhook registrado com sucesso.

Resposta ao registrar um webhook.

​
created_at
string<date-time>

Data e hora de criação do webhook.

Exemplo:

"2025-03-12T23:12:19.448Z"

​
enabled
boolean

Indica se o webhook está ativado.

Exemplo:

true

​
events
string[]

Eventos configurados no webhook.

Exemplo:
["message.received"]
​
id
string

Identificador único do webhook.

Exemplo:

"3nsnz68l0xbf0m3uu9tfo"

​
name
string

Nome do webhook configurado.

Exemplo:

"Meu Webhook"

​
test_mode
boolean

Indica se o webhook está em modo de teste.

Exemplo:

false

​
test_url
string | null

URL de teste configurada no webhook, se aplicável.

Exemplo:

null

​
url
string<uri>

URL para onde os eventos do webhook serão enviados.

Exemplo:

"https://webhook.mydomain.com"