Webhooks

Assinar eventos

POSThttps://api.seudominio.com.br/integrations/v1/webhooks

Cadastra uma URL para receber eventos. Devolve o segredo da assinatura.

É o que o gatilho do n8n faz ao ativar um fluxo. O secret só aparece nesta resposta: guarde-o para validar o header X-Solaria-Signature de cada entrega (veja o guia Webhooks).

Cada workspace tem até 50 webhooks, somando os criados pela API e pela tela. Os criados pela API também aparecem em Ajustes > Integrações > Webhooks.

Corpo da requisição

application/json

urlstring (uri)obrigatório

Endereço que recebe os POSTs (http:// ou https://, público).

eventsarray de stringobrigatório

Eventos assinados (ao menos um).

Valores:conversation.createdconversation.updatedconversation.resolvedmessage.createdcontact.createdcontact.updatedcontact.opted_outcontact.opted_in

namestring

Nome para identificar o webhook (até 120 caracteres).

Padrão: n8n

Corpo para testar

Respostas

AnteriorGatilho por webhook Próximo Buscar webhook

Token (Bearer)

Fica só nesta aba do navegador e é usado nos exemplos abaixo.

curl --request POST \
  --url 'https://api.seudominio.com.br/integrations/v1/webhooks' \
  --header 'Authorization: Bearer sk_SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "ERP",
  "url": "https://seu-sistema.com.br/hooks/solaria",
  "events": [
    "message.created"
  ]
}'

A chamada é real: age sobre os dados do seu workspace.

Resposta

{
  "id": "3f6c2a1e-8b4d-4c1a-9e2f-7a5b0c9d1e22",
  "name": "ERP",
  "url": "https://seu-sistema.com.br/hooks/solaria",
  "events": [
    "message.created"
  ],
  "active": true,
  "secret": "whsec_9f8e7d6c5b4a39281706f5e4d3c2b1a0"
}