Instrada i messaggi al tuo agente AI

Bird invia ogni messaggio che ricevi su WhatsApp, SMS, Apple Messages o una casella di posta dell'agente al tuo agente AI. Connetti l'agente una sola volta con i suoi dati e le sue credenziali, e ogni nuovo messaggio lo raggiunge.

Sono supportati due agenti:

• Claude Managed Agents: ogni messaggio avvia una sessione di un agente creato nella Claude Console.
• Grok Bot: ogni messaggio attiva una delle tue routine Grok Bot.

Bird invia ogni messaggio corrispondente al tuo agente e riprova una consegna non riuscita, quindi un messaggio riprovato può avviare un'altra esecuzione. L'agente riceve l'evento del messaggio JSON, lo stesso payload che riceve un normale endpoint webhook, e risponde tramite gli strumenti che gli hai fornito, come il server Bird MCP.

Scegli i messaggi a cui risponde il tuo agente

Il tuo agente può rispondere solo ai messaggi in arrivo: whatsapp.received, sms.received, amb.received (Apple Messages) e email_mailbox.message_received. Seleziona quelli che l'agente deve gestire. Le conferme di consegna, i cambiamenti di stato e gli altri eventi non vengono inviati a un agente.

Claude Managed Agents

1. Nella Claude Console, crea un agente, un ambiente e una chiave API.
2. In Bird, crea un webhook, scegli Claude Managed Agents e seleziona i messaggi in Triggers.
3. In Connect, inserisci l'agent ID, l'environment ID e la chiave API, poi crea il webhook.
4. Seleziona Send test.
5. (Facoltativo) Per consentire all'agente di rispondere tramite Bird, apri l'agente nella Claude Console, seleziona + MCP Server e scegli Bird.
6. (Facoltativo) Apri Managed Agents > Credential vaults, crea un vault, seleziona + Add credential, imposta Type su MCP OAuth, scegli Bird e seleziona Connect.
7. (Facoltativo) Inserisci il vault ID (inizia con vlt_) in Connect, oppure modifica un webhook esistente per aggiungerlo.

Grok Bot

Per prima cosa, chiedi a Grok Bot di creare una routine con un trigger webhook. Ti fornirà il webhook URL e la sender key della routine. Per configurare il trigger manualmente, consulta Cursor's webhook triggers.

Poi collegalo in Bird:

1. Crea un webhook e scegli Grok Bot.
2. In Triggers, seleziona i messaggi a cui Grok Bot deve rispondere.
3. In Connect, assegna un nome al webhook e incolla il webhook URL e la sender key.
4. Rivedi il webhook e crealo.

Ogni messaggio invia l'evento JSON all'URL webhook della routine, con la sender key come Bearer token, e la routine esegue il prompt salvato.

Crealo dalla CLI o dalla API

bird webhooks create --help elenca ogni connettore con i suoi campi, quali sono segreti, gli eventi accettati e la configurazione preliminare. Passa i campi non segreti con --field name=value e ogni segreto da una variabile d'ambiente con --secret-env name=ENV_VAR, oppure passalo in pipe con --secret-stdin name, così non resta nella cronologia della shell. --events include per default tutti gli eventi messaggio accettati dal connettore.

Per Claude, crea una chiave API nello spazio di lavoro in cui gira il tuo agente, poi leggila nell'ambiente senza stamparla a video, così non compare mai in una riga di comando o nella cronologia della shell:

read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY  # paste the key, then press Enter
bird webhooks create --connector claude_managed_agents \
  --field agent_id=agent_123 --field environment_id=env_123 \
  --field vault_id=vlt_123 --secret-env api_key=ANTHROPIC_API_KEY

La API accetta gli stessi destination su POST /v1/webhooks. Ometti url: Bird lo costruisce dal connettore. Nessuna risposta include le credenziali.

Testa la connessione

Subito dopo aver creato il webhook, seleziona Send test. In seguito, usa Send test event nella pagina del webhook o nelle azioni della riga, oppure chiama POST /v1/webhooks/{webhook_id}/test. Verifica in Claude o Cursor che una sessione o un'esecuzione sia partita. Poi invia un messaggio reale a uno dei tuoi numeri o canali e verifica che l'agente lo gestisca; per Claude, verifica che la risposta arrivi sul canale del mittente e che la sessione non mostri alcun session.error.

Gestiscilo

• Ruota una credenziale. Modifica il webhook e inserisci solo il nuovo valore; un campo lasciato vuoto mantiene il valore memorizzato. Tramite la API, invia la chiave aggiornata in PATCH /v1/webhooks/{webhook_id} destination.connector.credentials. La consegna successiva la usa, nuovi tentativi inclusi.
• Modificane le impostazioni. Modifica il webhook per cambiare un'impostazione come l'agent ID, il vault ID o il webhook URL di una routine Grok Bot; la consegna successiva la usa. Per cambiare piattaforma, crea un nuovo webhook.
• Mettilo in pausa o rimuovilo. Mettere in pausa un webhook ne interrompe le consegne. Eliminarlo cancella le sue credenziali.
• Leggere gli errori. L'elenco dei tentativi di un webhook mostra ogni consegna con lo stato e il corpo della risposta della piattaforma, oppure nulla quando la piattaforma non è stata raggiungibile. Un tentativo fallito prima che Bird inviasse qualcosa, ad esempio una connessione cambiata dopo l'evento, riporta invece un failure_reason.

Passaggi successivi

• MCP Events, per un client MCP che si iscrive direttamente a questi eventi
• Webhook ed eventi
• Server MCP
• Configura il tuo coding agent
• Superagent: valuta le email in arrivo, i messaggi SMS e WhatsApp prima che il tuo agente li gestisca.