> For the complete documentation index, see [llms.txt](https://multiagents.gitbook.io/multiagents-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://multiagents.gitbook.io/multiagents-docs/documentacao-de-tools/readme/webhook.md).

# Webhook

Defina na ferramenta a URL de destino que será acionada por uma requisição **POST** sempre que o lead atingir um estágio específico do funil ou quando uma interação for executada pelo agente **Multiagents**.

<figure><img src="https://1702474393-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2eEiTuosSJB6UCJZv9RX%2Fuploads%2Fg5El6w5rS17LEjERHCyM%2Fimage.png?alt=media&#x26;token=50686c65-66ba-4482-899e-2df4202d0762" alt="" width="563"><figcaption></figcaption></figure>

A URL informada deve permanecer acessível e responder com o status HTTP **200** a todas as requisições. Em caso de repetidas falhas ou respostas com erro, a ferramenta será desativada automaticamente, exigindo ação manual para sua reativação.

#### Exemplo de envio ao webhook

```json
{
    "instance_id": "1b32ab34-e9e6-4fc9-994d-1241f386e94f",
    "action": "update_lead",
    "data": {
        "lead": {
            "lead_id": "c579ec83-e629-484f-94c5-7a097d0150c4",
            "name": "Roberto Carlos",
            "email": null,
            "industry": null,
            "niche": null,
            "description": null
        },
        "contact": {
            "contact_id": "c579ec83-e629-484f-94c5-7a097d0150c4",
            "name": "Roberto Carlos",
            "email": "robertinho@exemple.com",
            "whatsapp": "+5531988770000",
            "phone": "+5531999770000"
        },
        "work": {
            "work_id": "9b1bd3ad-30ac-43de-8416-330f4a759589",
            "work_name": "",
            "work_type": "outbound",
            "work_lead_id": "539a1a64-917f-439c-a19d-d1387958e3e0",
            "agent_id": "2199ea4f-e68a-4330-a4ee-df9ce5e6fbeb",
            "agent_name": "Aurelio",
            "work_stage": "consideration"
        },
        "convert_reason": "Apresentar argumentos, cases ou diferenciais com base na dor do lead."
    }
}
```

#### Para usar ela no funil

Acesse seu ambiente de trabalho e clique em **Funil de Prospecção**. No funil desejado, configure o tipo de ação como **Ferramenta** e selecione **Webhook**. Dessa forma, sempre que um lead alcançar essa etapa, os dados serão enviados automaticamente para o webhook definido.

<figure><img src="https://1702474393-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2eEiTuosSJB6UCJZv9RX%2Fuploads%2FGQmXJFdGacjBJOW7gjUp%2Fimage.png?alt=media&#x26;token=526ce831-7250-474a-84ee-e3a230a86dc7" alt="" width="485"><figcaption></figcaption></figure>
