Webhooks — Evento SIGNATORY_SIGNED - SuperSign

Um signatário assinou. Chega um evento por assinatura: um envelope com três
signatários gera três SIGNATORY_SIGNED. Visão geral de todos os eventos em
Webhooks.

Quando dispara

Quando um participante com papel de signatário assina, com assinatura
eletrônica ou com certificado ICP-Brasil.

Também na assinatura em lote: cada envelope assinado no lote gera o seu
próprio evento.

Quando o participante é um grupo (ex.: "Diretoria"), quando a pessoa do grupo
assina por ele.

Quando o signatário assina de novo depois de um ajuste do envelope: chega
outro evento com o mesmo signatory.id e um signedAt novo.

Quando NÃO dispara

Aprovações não geram este evento: aprovador não é signatário.

Observadores e demais papéis sem assinatura.

Recusa de assinatura.

Exemplo de payload

Participante individual:

{
  "id": "e5f6a7b8-0000-4000-8000-000000000020",
  "event": "SIGNATORY_SIGNED",
  "createdAt": "2026-09-14T09:00:02.000Z",
  "data": {
    "envelope": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "SENT"
    },
    "signatory": {
      "id": "7a9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Pessoa Exemplo",
      "email": "pessoa@example.com",
      "method": "ELECTRONIC",
      "signedAt": "2026-09-14T09:00:00.000Z"
    }
  }
}

Participante de grupo (traz signedBy):

{
  "id": "d4c3b2a1-0000-4000-8000-000000000002",
  "event": "SIGNATORY_SIGNED",
  "createdAt": "2026-09-14T10:00:02.000Z",
  "data": {
    "envelope": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "SENT"
    },
    "signatory": {
      "id": "0b1c2d3e-4f50-4a61-8b72-93a4b5c6d7e8",
      "name": "Diretoria",
      "email": null,
      "method": "ELECTRONIC",
      "signedAt": "2026-09-14T10:00:00.000Z",
      "signedBy": {
        "name": "Pessoa Exemplo",
        "email": "pessoa@example.com"
      }
    }
  }
}

Campos de `data`

Campo	Tipo	Descrição
`envelope.id`	string (UUID)	Id do envelope.
`envelope.status`	string	Status no momento em que a entrega foi montada. Na última assinatura pode já vir `COMPLETED`.
`signatory.id`	string (UUID)	Id do participante no envelope, o mesmo do `GET` da API.
`signatory.name`	string ou `null`	Nome registrado na assinatura (em grupo, o nome do grupo).
`signatory.email`	string ou `null`	E-mail registrado na assinatura (em grupo, o do grupo — pode ser `null`).
`signatory.method`	string	`ELECTRONIC` (assinatura eletrônica) ou `PKI` (certificado ICP-Brasil).
`signatory.signedAt`	string (ISO 8601, UTC)	Quando a assinatura foi registrada.
`signatory.signedBy`	objeto	Só quando o participante é um grupo: a pessoa do grupo que de fato assinou. Para participante individual o campo não aparece.
`signatory.signedBy.name`	string ou `null`	Nome de quem assinou pelo grupo.
`signatory.signedBy.email`	string ou `null`	E-mail de quem assinou pelo grupo.

O formato externo (id, event, createdAt, environment) e os cabeçalhos
estão em Webhooks → Payload.

O que fazer com ele

Atualizar o andamento no seu sistema ("2 de 3 assinaram").

Guardar o signedAt mais recente por signatory.id: depois de um ajuste o
mesmo signatário pode assinar de novo.

Não use este evento para saber que o envelope terminou. Na última assinatura,
o ENVELOPE_COMPLETED pode chegar antes ou depois deste evento — não
dependa da ordem; espere o ENVELOPE_COMPLETED.

Webhooks — Evento SIGNATORY_SIGNED

Quando dispara#

Quando NÃO dispara#

Exemplo de payload#

Campos de data#

O que fazer com ele#

Quando dispara

Quando NÃO dispara

Exemplo de payload

Campos de `data`

O que fazer com ele