> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leavo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral

> Integração bidirecional com webhooks

## O que são Webhooks?

Webhooks permitem integração em tempo real entre o Leavo e sistemas externos. Existem dois tipos:

<CardGroup cols={2}>
  <Card title="Webhooks de Entrada (Inbound)" icon="arrow-down-to-line" href="/pt-BR/api-reference/webhooks/inbound">
    Receba dados de fontes externas para criar ou atualizar leads automaticamente.

    **Exemplo:** Formulário do site envia dados para criar um lead.
  </Card>

  <Card title="Webhooks de Saída (Outbound)" icon="arrow-up-from-line" href="/pt-BR/api-reference/webhooks/outbound">
    Notifique sistemas externos quando eventos ocorrem.

    **Exemplo:** Notificar CRM quando status de um lead muda.
  </Card>
</CardGroup>

## Fluxo de Webhooks

```mermaid theme={null}
graph LR
    subgraph Inbound
        A[Sistema Externo] -->|POST /webhooks/token| B[Leavo]
        B --> C[Cria/Atualiza Lead]
    end

    subgraph Outbound
        D[Evento no Leavo] --> E[Dispara Webhook]
        E -->|POST| F[Sistema Externo]
    end
```

## Endpoints de Gerenciamento

| Método   | Endpoint                      | Descrição                    |
| -------- | ----------------------------- | ---------------------------- |
| `GET`    | `/backend/webhooks`           | Lista todos os webhooks      |
| `POST`   | `/backend/webhooks`           | Cria um novo webhook         |
| `GET`    | `/backend/webhooks/{id}`      | Obtém detalhes de um webhook |
| `PUT`    | `/backend/webhooks/{id}`      | Atualiza um webhook          |
| `DELETE` | `/backend/webhooks/{id}`      | Remove um webhook            |
| `POST`   | `/backend/webhooks/{id}/test` | Testa um webhook             |

## Começando

<Steps>
  <Step title="Crie um Webhook">
    Use o endpoint POST `/backend/webhooks` para criar um webhook inbound ou outbound.
  </Step>

  <Step title="Configure o Mapeamento">
    Para webhooks inbound, configure como os campos do payload mapeiam para campos de lead.
  </Step>

  <Step title="Integre">
    Para inbound, envie dados para a URL do webhook. Para outbound, configure a URL de destino.
  </Step>

  <Step title="Monitore">
    Acompanhe as chamadas e erros no dashboard.
  </Step>
</Steps>