> 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/conectar/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 repetidamente.

## Tópicos

* [Criando Webhooks](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/webhook/creating-webhooks.md)
* [Gerenciando Webhooks](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/webhook/managing-webhooks.md)
* [Eventos](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/webhook/events.md)
* [Requisição](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/webhook/request.md)
* [Assinatura](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/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 repetidamente. Quando um evento ocorre, a Certta envia uma requisiçã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 requisiçõ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 no formato 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 (Nenhuma, Basic Auth ou Chave de API)
* Ative/desative webhooks conforme necessário
* Veja o status do webhook e gerencie configurações existentes

### Segurança

{% hint style="warning" %}
Todas as requisições de webhook são assinadas usando uma assinatura nos cabeçalhos, permitindo que você verifique se a requisição se originou da Certta. Veja [Assinatura](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/webhook/signature.md) para 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.caf.io/caf-api/caf-api-pt-br/conectar/webhook.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
