---
title: "Connettori webhook"
description: "Ogni piattaforma attraverso cui un endpoint webhook può consegnare gli eventi: i suoi campi, gli eventi che accetta e la configurazione da completare prima sulla piattaforma."
canonical: "https://bird.com/it-it/documentazione/ai/webhook-connectors"
---

<!-- Code generated by beak gen:webhook-connectors from the connector definitions; DO NOT EDIT. -->

# Connettori webhook

Un connettore consegna ogni evento come la richiesta che la sua piattaforma si aspetta, invece di inviare l'evento grezzo a un URL che ospiti tu. Configuralo dalla [dashboard](https://bird.com/dashboard/w/webhooks/new), con `bird webhooks create --connector <id>` oppure con `destination.connector` in [Create a webhook](/docs/api/reference/create-webhook). Bird costruisce l'URL dell'endpoint a partire dal connettore e dai suoi campi, quindi l'endpoint non accetta un proprio `url`.

I campi non segreti vanno in `config` e quelli segreti in `credentials`. I valori segreti sono di sola scrittura: nessuna risposta li include. Una creazione a cui manca un campo richiesto dal connettore, o che ne fornisce uno che il connettore non accetta, viene rifiutata e la risposta indica i campi del connettore. Per una guida passo passo, consulta [Instrada i messaggi al tuo agente IA](/docs/ai/route-messages-to-an-agent).

## Claude Managed Agents

Invia ogni messaggio che ricevi al tuo agente gestito Claude. Il suo ID è `claude_managed_agents`.

Accetta `whatsapp.received`, `sms.received`, `email_mailbox.message_received`, `amb.received`.

| Campo            | Dove va       | Obbligatorio | Descrizione                                                                                                                                    |
| ---------------- | ------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `agent_id`       | `config`      | Sì           | Viene restituito quando crei l'agente. Le sessioni usano la sua versione più recente.                                                          |
| `environment_id` | `config`      | Sì           | Viene restituito quando crei l'ambiente.                                                                                                       |
| `vault_id`       | `config`      | No           | Un vault di credenziali usato dall'agente, ad esempio quello che contiene la sua credenziale Bird MCP, così che possa rispondere tramite Bird. |
| `api_key`        | `credentials` | Sì           | Dallo spazio di lavoro Claude in cui viene eseguito il tuo agente.                                                                             |

Prima di collegarlo, sulla piattaforma:

1. **Per prima cosa, configura il tuo agente in Claude.** Nella Claude Console, crea l'agente, il suo ambiente e una chiave API nello stesso spazio di lavoro, poi inserisci i loro ID e la chiave in Bird. Consulta [platform.claude.com](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session).
2. **Crea una chiave API.** Nello spazio di lavoro Claude in cui viene eseguito il tuo agente. Consulta [platform.claude.com](https://platform.claude.com/settings/keys).
3. **Copia gli ID dell'agente e dell'ambiente.** Ogni creazione restituisce il relativo ID. Consulta [platform.claude.com](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session).
4. **Facoltativamente, aggiungi un vault di credenziali.** Per consentire all'agente di rispondere tramite Bird, salva la sua credenziale Bird MCP in un vault di credenziali Claude e indica qui l'ID del vault. Ogni sessione riceve quel vault. Consulta [platform.claude.com](https://platform.claude.com/docs/en/managed-agents/vaults).

## Grok Bot

Invia ogni messaggio ricevuto a una routine di Grok Bot. Il suo ID è `grok_bot`.

Accetta `whatsapp.received`, `sms.received`, `email_mailbox.message_received`, `amb.received`.

| Campo         | Dove va       | Obbligatorio | Descrizione                                                                 |
| ------------- | ------------- | ------------ | --------------------------------------------------------------------------- |
| `webhook_url` | `config`      | Sì           | L'URL del webhook della routine.                                            |
| `sender_key`  | `credentials` | Sì           | La chiave del mittente della routine. Bird la invia solo come token Bearer. |

Prima di collegarlo, sulla piattaforma:

1. **Per prima cosa, chiedi a Grok Bot di creare una routine.** Chiedi a Grok Bot di creare una routine con un trigger webhook, poi inserisci in Bird l'URL del webhook e la chiave del mittente che ti fornisce. Consulta [cursor.com](https://cursor.com/help/grok-bot/routines#where-do-the-webhook-url-and-key-live-and-what-does-a-200-mean).

## Related resources

- [Setting up your coding agent](/learn/basics/setting-up-your-coding-agent) (video)
- [What is an MCP server, and how does an agent use one to send messages?](/explained/platform/what-is-an-mcp-server-and-how-does-an-agent-send-messages) (answer)
- [Coding agents](/ai) (product)
- [Build with AI agents](/learn/paths/agents) (course)

[Get an implementation brief](/learn/workspace?topic=agents)