# Webhooks

URL: /integracoes/webhooks

Cadastre destinos HTTPS, escolha os eventos, teste e acompanhe as entregas.

Um webhook envia um evento do Mira, como um report criado ou um comentário novo, para um endereço HTTPS que você controla.

Para validar a assinatura e conhecer o formato de cada evento, veja [Payloads de webhook](/desenvolvedores/webhooks).

## Cadastrar um destino [#cadastrar-um-destino]

**Quem faz:** admin do projeto.

<Steps>
<Step>

### Abrir Webhooks [#abrir-webhooks]

Em **Configurações** do projeto, abra **Integrações** e clique em **Webhooks**. O painel lateral lista os destinos.

</Step>
<Step>

### Adicionar o destino [#adicionar-o-destino]

Clique em **Adicionar destino** e informe o nome, a URL HTTPS pública e os eventos que o destino recebe.

</Step>
<Step>

### Guardar o segredo [#guardar-o-segredo]

Salve e copie o segredo (`mira_whsec_...`) para a configuração privada de quem recebe. Ele aparece uma vez e não pode ser consultado depois.

</Step>
<Step>

### Testar [#testar]

Use **Enviar teste** e abra o **Histórico de entregas** para ver o resultado.

</Step>
</Steps>

<Figure src="/images/webhooks-panel.png" alt="Painel Webhooks com um destino e o histórico de entregas" caption="Um destino cadastrado e o histórico de entregas." />

A URL precisa usar HTTPS com certificado válido. O Mira recusa HTTP, endereços privados e URLs com usuário, senha ou fragmento, e não segue redirects. Não coloque segredos na URL.

## Eventos [#eventos]

| Evento | Quando |
| --- | --- |
| `report.created` | Novo report confirmado |
| `report.updated` | Campos ou tags de um report mudaram |
| `comment.created` | Comentário adicionado |
| `attachment.created` | Link ou arquivo adicionado |
| `error.created` | Primeira ocorrência de um erro novo |
| `error.regressed` | Erro resolvido voltou numa release com build posterior |
| `error.spike` | Pico de ocorrências de um erro |
| `digest.daily` | Todo dia às 09:00, se o projeto tem reports parados |
| `digest.weekly` | Segunda-feira, com o resumo semanal |

Os eventos de erro e de digest só chegam a destinos que os marcam na configuração. No formulário, os digests aparecem como **Digest diário** e **Resumo semanal**.

## Manter o destino [#manter-o-destino]

O painel permite **rotacionar o segredo**, **pausar** o destino e consultar as entregas, com o payload e as tentativas. O histórico é visível só para admins.

Quando uma entrega falha, o Mira tenta de novo até cinco vezes, com intervalos crescentes. Depois da última falha, **Reenviar** inicia outro ciclo. Pausar um destino cancela as entregas pendentes, e reativar não reproduz o que aconteceu durante a pausa.

## Próximos passos [#próximos-passos]

- [Payloads de webhook](/desenvolvedores/webhooks)
- [Resumo e digest](/triar/resumo)