> For the complete documentation index, see [llms.txt](https://docs.zapsign.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zapsign.com.br/webhooks/testando-webhooks.md).

# Testando Webhooks

Para facilitar o teste de webhooks sem precisar configurar um servidor local, ferramentas como **Webhook Site** são uma ótima opção. Elas permitem que você capture e visualize eventos recebidos pela API de forma rápida, ajudando na depuração e validação dos webhooks em tempo real. Confira como testar seus webhooks utilizando o webhook.site!

***

\ <mark style="background-color:blue;">1.</mark> <mark style="background-color:blue;"></mark><mark style="background-color:blue;">**Criando um Webhook no Webhook.site**</mark>

**Passo 1**: Acesse [Webhook.site](https://webhook.site/).

**Passo 2**: Na página inicial, você verá um URL exclusivo gerado automaticamente. Este será o seu **endpoint** para receber os webhooks.

**Passo 3**: Deixe essa aba aberta, pois é aqui que você visualizará os dados que serão enviados pelo webhook da ZapSign.

![Tela inicial do webhook.site](https://3085168645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4noMoX5ZGb2-RhWjjf-887967055%2Fuploads%2FtN40wbkloCoE2DcLg5D2%2FCaptura%20de%20tela%202024-09-20%20122810.png?alt=media\&token=3103f414-f880-475a-a14a-386c8416fb8f)

#### <mark style="background-color:blue;">2.</mark> <mark style="background-color:blue;"></mark><mark style="background-color:blue;">**Configurando o Webhook na ZapSign**</mark>

**Passo 1**: Acesse a ZapSign via ambiente de [produção](https://app.zapsign.com.br/acesso/criar-conta?hsCtaTracking=086cae81-8879-4c9a-9f6b-5cf5fc731497%7C9c90b543-ffd8-47b8-8638-df33d77e9653) ou [Sandbox](https://sandbox.app.zapsign.com.br/acesso/entrar)

**Passo 2**: Navegue até a área de **Configurações>Integrações>Api ZapSign>** [**Webhooks** ](https://app.zapsign.com.br/conta/configuracoes/integration?tab=api-zapsign)

**Passo 3**: Adicione o URL gerado pelo Webhook.site  no campo onde a ZapSign solicita o **endpoint** para os webhooks.&#x20;

**Passo 4**: Defina os eventos para os quais deseja receber webhooks, como "Documento Criado", "Documento Assinado", "Email Bounce", etc. e clique no "+" para adicionar o endereço.

<figure><img src="https://3085168645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4noMoX5ZGb2-RhWjjf-887967055%2Fuploads%2FVblmZKMQSQ0LytlYLgpO%2Fb9d5bab8-c3ee-465c-b2b6-8bbacac83c87.png?alt=media&amp;token=10b98b30-ec4d-4c70-bb5d-76e1ea45e867" alt="print da interface onde se adicionam os webhooks."><figcaption><p>Você pode cadastrar quantos webhooks quiser.</p></figcaption></figure>

#### <mark style="background-color:blue;">3.</mark> <mark style="background-color:blue;"></mark><mark style="background-color:blue;">**Gerando um Evento na ZapSign**</mark>

Agora que o webhook está configurado, você precisa gerar um evento que dispare o webhook.

Crie um documento ou acione um evento na ZapSign e verifique o Webhook.site para a requisição POST recebida, que conterá todos os detalhes do evento, como ID do documento, status e payload.<br>

<figure><img src="https://3085168645-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4noMoX5ZGb2-RhWjjf-887967055%2Fuploads%2F5MGQ927quHL50CCwUilz%2Fimage.png?alt=media&amp;token=0f679b08-15b2-4038-a319-772a3acb9af5" alt="print da tela do webhook.site, com todas as informações enviadas pela ZapSign"><figcaption><p>Confira todos o detalhes enviados pela ZapSign.</p></figcaption></figure>

No próximo capítulo, veremos mais detalhes de como[ Criar webhooks](/webhooks/criar-webhook.md), via interface web e api.


---

# 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.zapsign.com.br/webhooks/testando-webhooks.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.