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

# Webhooks

Menu lateral → **Ferramentas** → **Webhook**, ou direto em [app.maisfy.com.br/webhooks](https://app.maisfy.com.br/webhooks).

O webhook é um **aviso automático**: quando algo acontece na sua conta — uma venda paga, um carrinho abandonado, uma nova afiliação — a Maisfy envia os dados desse evento para um endereço que você define. É a integração mais aberta da plataforma: serve para **qualquer** ferramenta, inclusive as que não têm integração pronta.

![Tela de webhooks](https://3344509428-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0KchSWN381W9S4GFEfY%2Fuploads%2FHtlWNUB2AMdUU2s5blPP%2Fint-webhooks.jpg?alt=media)

A tela tem três abas: **Webhooks** (ver e gerenciar), **Adicionar Webhook** (criar) e **Logs** (acompanhar cada envio).

## Criar

| Campo                    | O que é                                                       |
| ------------------------ | ------------------------------------------------------------- |
| **URL**                  | O endereço que recebe os dados. O envio é sempre por **POST** |
| **Produto**              | Para qual produto vale — ou todos                             |
| **Máximo de tentativas** | Quantas vezes reenviar se o destino não responder             |
| **Autenticação**         | Usuário e senha, para o destino aceitar só chamadas suas      |

## Os eventos

Você escolhe exatamente o que dispara o webhook. Marque só o que a sua automação precisa — evento a mais é chamada a mais no seu servidor.

| Grupo                   | Eventos                                                                                                |
| ----------------------- | ------------------------------------------------------------------------------------------------------ |
| **Pedido**              | Pendente, Pago, Cancelado, Chargeback, Estorno, Reembolso                                              |
| **Produtos Promovidos** | Os mesmos seis, do ponto de vista da **comissão do afiliado**                                          |
| **Afiliação**           | Nova afiliação a um produto seu                                                                        |
| **Assinatura**          | Assinatura cancelada; ciclo de renovação pago (inclui a recuperação de inadimplência); ciclo estornado |
| **Checkout**            | Carrinho abandonado                                                                                    |

{% hint style="info" %}
**Pedido e Produtos Promovidos parecem iguais e não são.** O primeiro fala da venda; o segundo, da comissão de quem promoveu. Quem monta relação de pagamento de afiliado quer o segundo.
{% endhint %}

## Logs

A aba **Logs** registra cada envio: qual evento foi, se foi enviado e quando. Nas ações de um log você abre os detalhes — identificador do evento, quantas tentativas houve e um botão para **reenviar** manualmente.

Dentro dos detalhes há duas abas:

* **Request** — o payload completo do evento e os cabeçalhos da requisição
* **Response** — o que o outro sistema respondeu: código de status, corpo e o tempo que levou

{% hint style="info" %}
Antes de confiar a operação à automação, use **Enviar teste** no menu de ações do webhook: ele manda um evento de exemplo para a sua URL. Se chegar e voltar com sucesso, a integração está pronta. No mesmo menu você **edita** ou **desativa** o webhook.
{% endhint %}

## Exemplo de payload

```json
{
  "id": "evt_123456789",
  "data": {
    "ca": "code-afilliate",
    "email": "john.doe@example.com",
    "order": "A1B2C3D4E5",
    "coupons": [],
    "product": {
      "name": "Fictional Product",
      "price": 4999,
      "format": "PHYSICAL",
      "description": "Sample product description",
      "email_support": "support@example.com",
      "shipping_price": 999
    },
    "user_id": "usr_9876543210zyxwv",
    "customer": {
      "name": "JANE SMITH",
      "email": "jane.smith@mailinator.com",
      "address": { "city": "São Paulo", "state": "SP" }
    }
  }
}
```

{% hint style="info" %}
O campo **`price`** vem em **centavos** — `4999` é R$ 49,99. O mesmo vale para `shipping_price`.
{% endhint %}

## Em vídeo

{% embed url="<https://www.youtube.com/watch?v=3YoMrGSGYdU>" %}