> For the complete documentation index, see [llms.txt](https://assertchat.gitbook.io/manual-assertchat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://assertchat.gitbook.io/manual-assertchat/pagina-inicial/api-e-webhook/webhook.md).

# Webhook

A área **Webhooks** permite gerenciar integrações de saída do AssertChat com sistemas externos.

Por meio dessa funcionalidade, a plataforma pode enviar automaticamente eventos para uma URL configurada pela empresa, permitindo que outros sistemas acompanhem ações e atualizações em tempo real.

### Indicadores da tela

Na parte superior da página, são apresentados alguns resumos importantes sobre os webhooks configurados:

* **Webhooks ativos:** quantidade de webhooks atualmente habilitados;
* **Assinaturas:** quantidade de assinaturas configuradas;
* **Última entrega bem-sucedida:** data e horário do envio mais recente concluído com sucesso.

Esses indicadores ajudam a acompanhar rapidamente a situação geral das integrações cadastradas.

### Boas práticas de entrega

A página também apresenta orientações importantes para o uso correto dos webhooks em ambiente de produção.

Entre elas:

* **HTTPS em produção:** a URL do endpoint deve utilizar HTTPS;
* **Assinatura HMAC:** recomenda-se validar os cabeçalhos de segurança enviados pelo AssertChat;
* **Resposta 2xx:** o endpoint deve responder com código HTTP da faixa 2xx para confirmar o recebimento do evento.

> Respostas diferentes de 2xx podem ser registradas como falha e poderão gerar novas tentativas de envio.

<figure><img src="https://3085621881-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVVHN1dURTl9HbzaB2XEv%2Fuploads%2Ffs3F7C0XHhQdiOEkDWig%2Fimage.png?alt=media&amp;token=32517502-058b-406f-83e0-dc4cf8927d01" alt=""><figcaption></figcaption></figure>

### Webhooks cadastrados

Na seção **Webhooks cadastrados**, é possível consultar os webhooks registrados pela empresa.

Para cada webhook, podem ser exibidas informações como:

* nome do webhook;
* status;
* URL configurada;
* eventos selecionados;
* secret utilizado;
* data da última rotação do secret;
* data do último envio com sucesso;
* data da última falha.

Essa área permite identificar quais eventos estão sendo enviados e acompanhar a situação atual de cada integração.

### Ações disponíveis

Cada webhook pode apresentar algumas ações de gerenciamento, como:

* **Editar:** permite alterar as configurações do webhook;
* **Enviar evento de teste:** envia um evento de teste para validar a integração;
* **Rotacionar secret:** gera um novo secret para segurança da assinatura;
* **Excluir:** remove o webhook cadastrado;
* **Ativar/Desativar:** permite habilitar ou desabilitar o webhook.

> A opção de teste é útil para validar se a URL configurada está recebendo corretamente os eventos enviados pela plataforma.

{% embed url="<https://app.supademo.com/demo/cmsdikz4g003gqm25hmi5b81e?utm_source=link>" %}

### Histórico de entregas

Na parte inferior da página, a seção **Histórico de entregas** apresenta os registros dos envios realizados pelos webhooks.

Para cada item, podem ser ser exibidas informações como:

* webhook relacionado;
* evento enviado;
* status da entrega;
* quantidade de tentativas;
* código HTTP retornado;
* erro identificado;
* data de criação do envio;
* data de entrega;
* ações disponíveis.

Esse histórico auxilia no acompanhamento das entregas e no diagnóstico de falhas de integração.

### Reenvio de eventos

Quando uma entrega não for concluída com sucesso, a plataforma poderá disponibilizar a opção **Reenviar**.

Essa ação permite tentar novamente o envio do evento para o endpoint configurado.

> O reenvio é indicado quando a falha ocorreu por indisponibilidade momentânea, erro temporário do endpoint ou ajuste recente na integração.

### Filtro do histórico

A opção **Filtrar webhook** permite exibir apenas os registros relacionados a um webhook específico, facilitando a análise quando houver várias integrações cadastradas.

<figure><img src="https://3085621881-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVVHN1dURTl9HbzaB2XEv%2Fuploads%2F9TPGRxP3r430676txKj0%2FAPI%20e%20Webhook%20-%20Webhook.png?alt=media&amp;token=fd983662-3256-4a80-a51d-0a87eeb62696" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://assertchat.gitbook.io/manual-assertchat/pagina-inicial/api-e-webhook/webhook.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.