Evento EMAIL_BOUNCED

Um e-mail enviado pela SuperSign a um participante não foi entregue: o
servidor de destino recusou, desistiu de entregar ou o endereço está suprimido.
Visão geral de todos os eventos em Webhooks.

Este evento é opcional: só chega ao endpoint que incluir EMAIL_BOUNCED no
campo events. Endpoints já cadastrados não passam a recebê-lo sozinhos.

Ele não muda o status do envelope: o envelope continua circulando. É um
aviso para você corrigir o contato (por exemplo, editar o e-mail do participante
e reenviar) antes que o prazo vença.

Quando dispara

Quando qualquer e-mail enviado ao participante volta como não entregue:
convite, lembrete, código de verificação (OTP) e demais avisos ao
participante - não só o convite.

Inclui falha definitiva (HARD) e temporária (SOFT, quando o
provedor de e-mail desiste de entregar).

Dentro de um mesmo ciclo de envio, o evento só se repete se a falha
piorar: SOFT/OTHER contam como temporárias, HARD/SUPPRESSED como
definitivas. Assim, SOFT no convite seguido de HARD no lembrete gera
dois eventos (o segundo avisa que virou definitivo); HARD seguido de
SOFT, ou SOFT seguido de SOFT, gera um só. Depois de um
reenvio ao participante, abre-se um ciclo novo e um novo bounce gera um
novo evento.

Quando NÃO dispara

E-mail enviado pelo SMTP próprio da sua conta (domínio próprio
configurado em Configurações): a entrega é do seu servidor e a SuperSign não
recebe o retorno de não entrega.

Resposta automática (ex.: fora do escritório) e outros avisos informativos:
a mensagem chegou.

Reclamação de spam: a mensagem chegou e a pessoa a marcou como spam.

Bounce atrasado de um envio anterior ao último reenvio.

E-mails que não são dirigidos a um participante (ex.: avisos a usuários da
conta).

Mensagens por WhatsApp ou SMS.

Exemplo de payload

{
  "id": "f1e2d3c4-0000-4000-8000-000000000040",
  "event": "EMAIL_BOUNCED",
  "createdAt": "2026-10-02T15:00:05.000Z",
  "data": {
    "envelope": {
      "id": "550e8400-e29b-41d4-a716-446655440000"
    },
    "participant": {
      "id": "7a9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Pessoa Exemplo",
      "email": "pessoa@example.com",
      "role": "SIGNATORY"
    },
    "channel": "EMAIL",
    "failureType": "HARD",
    "occurredAt": "2026-10-02T15:00:00.000Z"
  }
}

Campos de `data`

Campo	Tipo	Descrição
`envelope.id`	string (UUID)	Id do envelope.
`participant.id`	string (UUID)	Id do participante no envelope, o mesmo do `GET` da API.
`participant.name`	string ou `null`	Nome do participante no momento do bounce.
`participant.email`	string ou `null`	E-mail do participante no momento do bounce.
`participant.role`	string	`SIGNATORY` (signatário), `APPROVER` (aprovador) ou `OBSERVER` (observador).
`channel`	string	Sempre `EMAIL`.
`failureType`	string	Tipo da falha, normalizado (tabela abaixo).
`occurredAt`	string (ISO 8601, UTC)	Quando o provedor de e-mail registrou a não entrega.

`failureType`

Valor	Significado	O que fazer
`HARD`	O endereço não existe ou é inválido.	Corrigir o e-mail do participante e reenviar.
`SOFT`	Falha temporária (caixa cheia, servidor indisponível, erro de DNS) e o provedor desistiu.	Conferir o endereço; reenviar mais tarde.
`SUPPRESSED`	O endereço está bloqueado para envio por falhas ou reclamações anteriores; a mensagem nem saiu.	Usar outro e-mail ou outro canal.
`OTHER`	Outra recusa (bloqueio por conteúdo, política do domínio, motivo não classificado).	Conferir o endereço com o participante.

Novos valores de failureType podem ser adicionados no futuro; trate valor
desconhecido como OTHER.

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

O que fazer com ele

Avisar quem criou o envelope de que o participante não recebeu o e-mail.

Para deduplicar, use data.participant.id + data.occurredAt: a mesma
falha entregue de novo (retentativa ou reenvio da entrega) tem o mesmo par.

O e-mail do participante é dado pessoal: não o registre em log sem
necessidade.

Quando dispara#

Quando NÃO dispara#

Exemplo de payload#

Campos de data#