# Criando um webhook para interceptar um Pix e chamar uma API

> Pela Woovi é possível criar webhooks para interceptar quando um pix for realizado. Hoje, há duas maneiras de realizar a criação do mesmo: via plataforma ou API.

Neste tutorial iremos descrever como criar um webhook para informar o recebimento de um novo Pix e devolvê-lo em uma API registrada.

Para criar um webhook via plataforma basta seguir os passos abaixo:

### Step 1 - Ajustes

Vá até o Menu Administrador e procure por `API/Plugins`.

![AdminPanel](/img/apis/admin-panel.png)

Clique em `Novo Webhook`.

![NewWebhook](/img/webhook/new-webhook.png)

Após o clique será aberta a tela de crição para um novo webhook:

![CreateWebhook](/img/webhook/create-new-webhook.png)

Campos:

- **Nome** - nome do webhook.
- **Ativo** - se o webhook esta ativo ou inativo.
- **Evento** - evento a ser ouvido (exemplo: transação pix recebida).
- **URL** - o endpoint na qual o webhook irá chamar.
  - Observação: É importante salientar, que nosso webhook sempre fará uma requisição `POST` no seu endpoint.
- **Ação** existem dois tipos de ação: chamar api e enviar email. Dependendo de qual decidir será disponibilizado os campos paramêtros obrigatórios.

#### Ação

Ao escolher um tipo de ação, de acordo com a escolhida será obrigatório informar os paramêtros necessários para tal.

**action-api**

![CreateWebhook](/img/webhook/create-new-webhook-api.png)

Campos:

- url: obrigatório, necessário ser uma url válida e disponível para um teste de chamada no momento de salvar.
- authorization: opcional

**action-email**

![CreateWebhookEmail](/img/webhook/create-new-webhook-email.png)

Campos:

- email: obrigatório

[Exemplos de payload do Webhook](/docs/category/exemplos)
