> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/caf-api-pt-br/connect/webhook.md).

# Webhooks

Webhooks são callbacks HTTP que permitem que a Certta envie notificações em tempo real para sua aplicação quando eventos específicos ocorrem. Esse método de comunicação assíncrona garante que seu sistema permaneça atualizado sem a necessidade de consultar nossas APIs constantemente.

## Tópicos

* [Criando Webhooks](/caf-api/caf-api-pt-br/connect/webhook/creating-webhooks.md)
* [Gerenciando Webhooks](/caf-api/caf-api-pt-br/connect/webhook/managing-webhooks.md)
* [Eventos](/caf-api/caf-api-pt-br/connect/webhook/events.md)
* [Solicitação](/caf-api/caf-api-pt-br/connect/webhook/request.md)
* [Assinatura](/caf-api/caf-api-pt-br/connect/webhook/signature.md)

## Visão geral

Webhooks fornecem um mecanismo para a Certta notificar seus sistemas quando eventos acontecem, em vez de exigir que sua aplicação consulte alterações. Quando um evento ocorre, a Certta envia uma solicitação HTTP POST para a URL do endpoint configurado com informações sobre o evento.

## Primeiros passos

Para começar a usar webhooks com o Connect:

1. **Configure seu endpoint de webhook** - Crie um endpoint HTTPS que possa receber solicitações POST
2. **Crie e configure seu webhook** - Use o portal Trust para configurar seu webhook com os eventos e a autenticação apropriados
3. **Implemente a verificação de assinatura** - Verifique a autenticidade do webhook usando as assinaturas fornecidas
4. **Trate os eventos do webhook** - Processe os payloads formatados em CloudEvents na sua aplicação

A interface de gerenciamento de webhooks permite que você:

* Crie novos webhooks com filtragem personalizada de eventos
* Configure métodos de autenticação (Nenhum, Autenticação Básica ou Chave de API)
* Ative/desative webhooks conforme necessário
* Visualize o status dos webhooks e gerencie as configurações existentes

### Segurança

{% hint style="warning" %}
Todas as solicitações de webhook são assinadas usando uma assinatura nos cabeçalhos, permitindo que você verifique se a solicitação se originou da Certta. Consulte [Assinatura](/caf-api/caf-api-pt-br/connect/webhook/signature.md) para mais detalhes sobre como verificar a autenticidade do webhook.
{% endhint %}


---

# 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://docs.caf.io/caf-api/caf-api-pt-br/connect/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.