# Criar e Gerenciar Assinaturas de Webhook do Advocate
Webhooks são códigos que são executados quando um evento acontece. O Advocate permite que você use webhooks para registrar uma URL para a qual faremos POST sempre que um evento acontecer no seu programa, por exemplo, quando um código de cupom personalizado é criado para um novo participante, um objeto de evento é criado. Há dois métodos para criar e gerenciar webhooks: [por meio da API do Advocate](https://integrations.impact.com/impact-brand/docs/api-webhooks) ou na plataforma do Advocate. Este artigo de ajuda explicará como gerenciar webhooks pela plataforma do Advocate.
#### Criar uma assinatura de webhook
1. Na barra de navegação superior, selecione  **\[Perfil do usuário] → Configurações**.
2. Na coluna à esquerda abaixo *Configurações do Advocate*, selecione **Webhooks**.
3. Na *Assinaturas de webhook* da página, selecione **Criar assinatura**.
4. Abaixo *Postar na URL*, insira o endereço exclusivo que o aplicativo usa para enviar atualizações em tempo real sobre eventos específicos.
5. Opcionalmente, abaixo *Nome do webhook*, insira o nome da nova assinatura de webhook.
6. Selecione **Salvar**.
#### Solucionar problemas nos logs de webhook
Quando você registra uma URL para a qual o Advocate faz post sempre que um evento acontece no seu programa, você pode revisar os logs e solucionar quaisquer eventos de webhook que falhem.
**Acesse seus logs de webhook**
1. Na barra de navegação superior, selecione  **\[Perfil do usuário] → Configurações**.
2. Na coluna à esquerda abaixo *Configurações do Advocate*, selecione **Webhooks**.
3. Na *Assinaturas de webhook* da página, selecione **Ver logs**.
4. Use os filtros abaixo *Log de eventos de webhook* para filtrar os webhooks.
* Consulte a *Referência de filtros* abaixo para mais informações.
Referência de filtros
| Filtro | Descrição |
| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo | Filtrar pelo webhook [tipo de evento](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-webhook-events). Este filtro tem como padrão *Todos os tipos*. |
| Período | Filtrar pelo período em que o webhook foi atualizado pela última vez. Este filtro tem como padrão *Todo o período*. |
**Ver detalhes do webhook**
1. Selecione um webhook específico para abrir a visualização *Detalhes do webhook* .
2. Esta visualização fornece informações que podem ser usadas para solucionar problemas em uma assinatura de webhook.
* Consulte a *Referência do evento* abaixo para mais informações.
Referência do evento
| Filtro | Descrição |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo | O webhook [tipo de evento](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-webhook-events). |
| ID do webhook | O identificador exclusivo do webhook. |
| Data de criação | A data em que o webhook foi criado. |
| Dados do evento | O webhook [payload](https://integrations.impact.com/impact-brand/docs/api-webhooks#section-payloads). |
| Assinatura(s) | Assinaturas de webhook para as quais o webhook foi enviado e o respectivo status. |
| Detalhes da assinatura | Detalhes sobre a resposta recebida do endpoint da assinatura de webhook. Os detalhes podem incluir a tentativa de entrega do webhook, mostrando o carimbo de data/hora da tentativa, o código de status HTTP recebido do destino e se a tentativa expirou devido ao tempo excessivo de solicitação para receber uma resposta do servidor de destino. |
**Sistema de repetição de webhook para entregas de eventos com falha**
* Os rest hooks são entregues imediatamente após um evento ser acionado. Se o endpoint não responder com sucesso a uma tentativa de entrega (ou seja, responder com um código de status diferente de 200), a entrega será considerada como falha.
* As entregas com falha serão tentadas novamente a cada hora após a tentativa com falha anterior, até que uma entrega bem-sucedida seja realizada ou até que 72 tentativas tenham sido feitas (aproximadamente 3 dias, na taxa de 1 nova tentativa por hora).
* Endpoints de webhook que retornam erros consistentemente serão desativados automaticamente após o seguinte número de erros:
| Código de status | Erros recebidos |
| ---------------- | --------------- |
| Erros 4xx | 1000 |
| Erros 5xx | 2000 |
| Erros 3xx | 2000 |
---
# Agent Instructions: 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:
```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/advocate-program-settings/create-and-manage-advocate-webhook-subscriptions.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.