Webhooks

Objeto de evento

Referência do corpo e dos headers enviados nos webhooks.

Cada webhook é um POST HTTPS com um evento JSON no corpo. Os detalhes de configuração estão em Webhooks.

Headers

webhook-idstringheader

ID do evento, igual ao campo id. Não muda entre tentativas.

webhook-timestampstringheader

Segundos Unix da tentativa (10 dígitos).

webhook-signaturestringheader

Assinaturas v1,BASE64, separadas por espaço. Veja Verificar assinaturas.

Authorizationstringheader

Bearer <token>, somente se o destino tiver um token Bearer configurado.

Corpo

idstring

Identificador do evento, no formato evt_ seguido de 32 caracteres hexadecimais.

typestring

script.created, script.updated, script.status_changed, script.trashed, script.restored ou webhook.test.

timestampstring (date-time)

Momento da alteração que originou o evento.

api_versionstring

Versão do contrato. Atualmente 2026-10-30.

environmentstring

production, staging ou development.

dataobject

Conteúdo do evento. Em eventos de roteiro:

Mostrar propriedades
script.idstring (uuid)

Identificador do roteiro.

script.revisioninteger

Revisão que gerou o evento.

script.statusstring

Status no momento do evento.

script.deletedAtstring | null

Preenchido quando o roteiro está na lixeira.

changes.fieldsstring[]

Campos alterados (title, content, status) em script.updated e script.status_changed. Vazio nos demais.

changes.previousStatusstring

Status anterior, apenas em script.status_changed.

Em webhook.test, data traz challenge e message.

Resposta esperada

EventoResponda
webhook.test200 com {"challenge": "<data.challenge>"}
Demais200 ou 202 após persistir o evento