> 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/creating-webhooks.md). # Criando webhooks ## Visão geral Webhooks no Connect permitem que você receba notificações em tempo real quando eventos específicos ocorrerem em sua conta. Você pode criar e configurar webhooks pelo portal Trust. ## Acessando o gerenciamento de webhooks 1. **Faça login no portal Trust**: * Acesse o portal Trust e autentique-se com suas credenciais. 2. **Acesse as Configurações de API**: * No painel, localize o menu de navegação. * Clique em **Configurações** (ícone de engrenagem) no menu. * Selecione **Configurações de API** no menu. ![Configurações de API](/files/07ae3dd7565954ba67091c38febe9f9d60e95355) 3. **Acessar a seção de Webhooks**: * Na **página de configurações de API** , clique na aba **Webhooks** . * Esta página exibe todos os seus webhooks existentes com seus status, URLs de payload e ações disponíveis. ![Lista de Webhooks](/files/1b92a7e5aba664815f4f2d4f0756fe54a8737c4c) ## Criando um novo webhook Para criar um novo webhook, siga estas etapas: 1. **Iniciar a criação do webhook**: * Clique no botão "+ Novo webhook" no cabeçalho da página. 2. **Configurar as configurações do webhook**: * Um **Novo webhook** modal será exibido, onde você pode configurar as definições do seu webhook. ![Modal de Novo Webhook](/files/0c12da8184a1d2948dc3e69488d7c7a0fae03e7a) ### Configuração básica **URL do payload**: Informe a URL para a qual a Certta deve enviar eventos de webhook. Isso deve ser um endpoint `HTTPS` válido que possa receber solicitações POST. **Segredo**: Forneça uma chave secreta que será usada para gerar a assinatura do webhook. Isso permite verificar se as solicitações realmente vieram da Certta. ### Configuração de autenticação Escolha o método de autenticação para o endpoint do seu webhook: #### Nenhuma Nenhuma autenticação será usada ao enviar solicitações de webhook. #### Autenticação básica ![Configuração de Autenticação Básica](/files/d1c5f9a588b6779cf2386e8f9f554c38dda03af9) Forneça credenciais de nome de usuário e senha que serão incluídas nas solicitações de webhook usando Autenticação Básica HTTP. #### Autenticação por chave de API ![Configuração da Chave de API](/files/0421a8fe9b69754757fb4dfe113bef080762c8d9) Configure a autenticação por chave de API especificando: * **Cabeçalho**: O nome do cabeçalho (por exemplo, `X-API-Key`) * **Valor**: O valor da chave de API ### Seleção de eventos Escolha quais eventos devem acionar seu webhook: #### Enviar tudo Esta opção enviará todos os eventos disponíveis para o endpoint do seu webhook. #### Deixe-me selecionar eventos individuais ![Seleção de eventos](/files/b73336555550d11f2e2fa31ca64a1556d4b0f75a) Quando você selecionar esta opção, poderá escolher eventos específicos na lista disponível. A interface exibirá todos os eventos atualmente compatíveis, incluindo Eventos de Comunicação, Eventos de Transação e Eventos de Autenticação. {% hint style="warning" %} Os eventos mostrados na interface são apenas para fins ilustrativos. A lista real de eventos pode ser diferente, pois novos eventos podem ser adicionados ou eventos existentes podem ser modificados ao longo do tempo. Consulte sempre a interface atual para obter a lista mais atualizada dos eventos disponíveis. {% endhint %} Para obter informações detalhadas sobre cada tipo de evento, sua estrutura e exemplos de payload, consulte a [documentação de Eventos](/caf-api/caf-api-pt-br/connect/webhook/events.md). ### Ativação Marque a caixa de seleção "Ativo" para habilitar o webhook imediatamente após a criação. Você sempre pode ativar ou desativar webhooks depois na interface de gerenciamento. ## Concluindo a criação do webhook Após configurar todas as definições: 1. Revise a configuração do seu webhook 2. Clique em "Criar webhook" para concluir a configuração 3. Seu novo webhook aparecerá na lista de webhooks e começará a receber eventos com base na sua configuração ## Próximos passos Após criar seu webhook: * [Saiba mais sobre os eventos do webhook](/caf-api/caf-api-pt-br/connect/webhook/events.md) para entender os dados que você receberá * [Implemente a verificação de assinatura](/caf-api/caf-api-pt-br/connect/webhook/signature.md) para garantir a autenticidade do webhook * [Siga as melhores práticas](/caf-api/caf-api-pt-br/connect/webhook/best-practices.md) para um tratamento confiável de webhooks --- # 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/creating-webhooks.md?ask=&goal= ``` `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.