Berichten doorsturen naar je AI-agent

Bird stuurt elk bericht dat je ontvangt via WhatsApp, SMS, Apple Messages of een agentmailbox door naar je AI-agent. Verbind de agent eenmalig met zijn gegevens en inloggegevens, en elk nieuw bericht bereikt hem.

Twee agents worden ondersteund:

• Claude Managed Agents: elk bericht start een sessie van een agent die je hebt aangemaakt in de Claude Console.
• Grok Bot: elk bericht activeert een van je Grok Bot-routines.

Bird stuurt elk overeenkomend bericht naar je agent en probeert een mislukte bezorging opnieuw, zodat een herhaald bericht een nieuwe run kan starten. De agent ontvangt de JSON van het bericht, dezelfde payload die een gewoon webhook-endpoint ontvangt, en antwoordt via de tools die je hem hebt gegeven, zoals de Bird MCP-server.

Kies welke berichten je agent beantwoordt

Je agent kan alleen inkomende berichten beantwoorden: whatsapp.received, sms.received, amb.received (Apple Messages) en email_mailbox.message_received. Kies welke de agent moet afhandelen. Bezorgingsbevestigingen, statuswijzigingen en andere events worden niet naar een agent gestuurd.

Claude Managed Agents

1. Maak in de Claude Console een agent, een omgeving en een API-sleutel aan.
2. Maak in Bird een webhook aan, kies Claude Managed Agents en selecteer de berichten onder Triggers.
3. Voer onder Connect de agent-ID, de omgevings-ID en de API-sleutel in en maak daarna de webhook aan.
4. Selecteer Send test.
5. (Optioneel) Wil je de agent laten antwoorden via Bird, open dan de agent in de Claude Console, selecteer + MCP Server en kies Bird. Schakel alleen de Bird-tools in die de agent gebruikt, zodat hij minder tokens verbruikt, zoals Claude Managed Agents beschrijft.
6. (Optioneel) Open Managed Agents > Credential vaults, maak een kluis aan, selecteer + Add credential, zet Type op MCP OAuth, kies Bird en selecteer Connect.
7. (Optioneel) Voer de kluis-ID (die begint met vlt_) in onder Connect, of bewerk een bestaande webhook om hem toe te voegen.

Grok Bot

1. Installeer Bird in Grok Bot en verbind je Bird-werkruimte.
2. Vraag Grok Bot een routine met een webhook-trigger aan te maken. Open de sectie Webhook van de routine en kopieer de URL en de sender key.
3. Maak de webhook in Bird aan op een van deze manieren:
   • Vraag Grok Bot hem aan te maken met een Grok Bot-bestemming voor een event zoals amb.received of email_mailbox.message_received, met de URL en sender key uit stap 2. Noem voor e-mail de mailbox.
   • Maak hem aan in het dashboard: kies Grok Bot, selecteer het event onder Triggers en plak de URL en sender key onder Connect.
4. Selecteer Send test en stuur daarna een echt bericht naar je bedrijf of mailbox.

Begin met een template (optioneel). Kies vóór stap 2 AMB Booking Desk of Email Support Desk en geef Grok Bot de bijbehorende bot.md en shared/message-safety.md als blijvende instructies. Vul Your settings en Knowledge in, schakel de kanaalskill in en gebruik de Routine prompt van de template voor stap 2.

Antwoorden van templates staan standaard op concepten.

Start er geen run, vergelijk dan de Webhook-URL en sender key van de routine met de waarden in Bird.

Aanmaken via de CLI of API

bird webhooks create --help toont elke connector met zijn velden, welke daarvan geheim zijn, de events die hij accepteert en de voorbereidende stappen. Geef niet-geheime velden mee met --field name=value en elk geheim vanuit een omgevingsvariabele met --secret-env name=ENV_VAR, of pipe het met --secret-stdin name, zodat het buiten je shellgeschiedenis blijft. --events staat standaard op elk berichtevent dat de connector accepteert.

Maak voor Claude een API-sleutel aan in de werkruimte waarin je agent draait, en lees die vervolgens in de omgeving in zonder hem weer te geven, zodat hij nooit in een opdrachtregel of je shellgeschiedenis verschijnt:

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

De API accepteert dezelfde destination op POST /v1/webhooks. Laat url weg: Bird stelt het samen op basis van de connector. Geen enkel antwoord bevat de credentials.

De verbinding testen

Kies direct na het aanmaken van de webhook Send test. Gebruik later Send test event op de pagina van de webhook of in de rijacties, of roep POST /v1/webhooks/{webhook_id}/test aan. Controleer in Claude of Cursor dat er een sessie of run is gestart. Stuur daarna een echt bericht naar een van je nummers of kanalen en controleer of de agent het afhandelt. Controleer bij Claude of het antwoord aankomt op het kanaal van de afzender en of de sessie geen session.error toont.

Beheer

• Een credential roteren. Bewerk de webhook en voer alleen de nieuwe waarde in; een veld dat je leeg laat, behoudt zijn opgeslagen waarde. Stuur via de API de gewijzigde sleutel mee in PATCH /v1/webhooks/{webhook_id} destination.connector.credentials. De volgende aflevering gebruikt hem, nieuwe pogingen inbegrepen.
• De instellingen wijzigen. Bewerk de webhook om een instelling te wijzigen, zoals de agent-ID, de kluis-ID of de webhook-URL van een Grok Bot-routine; de volgende aflevering gebruikt de nieuwe waarde. Maak een nieuwe webhook aan als je van platform wilt wisselen.
• Pauzeren of verwijderen. Een webhook pauzeren stopt de afleveringen. Verwijderen wist de credentials.
• Fouten bekijken. De pogingen van een webhook tonen elke aflevering met de antwoordstatus en body van het platform, of niets als het platform niet bereikbaar was. Een poging die mislukte voordat Bird iets verstuurde, zoals een verbinding die na het event is gewijzigd, bevat in plaats daarvan een failure_reason.

Volgende stappen

• MCP Events, voor een MCP-client die zelf op deze events abonneert
• Webhooks & events
• MCP-server
• Je coding-agent instellen
• Superagent: beoordeel inkomende e-mail-, SMS- en WhatsApp-berichten voordat je agent erop reageert.