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.
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

Vraag Grok Bot eerst om een routine aan te maken met een webhook-trigger. Je krijgt de webhook-URL en de sender key van de routine. Zie Cursor's webhook-triggers als je de trigger liever handmatig instelt.

Verbind de routine vervolgens in Bird:

1. Maak een webhook aan en kies Grok Bot.
2. Selecteer onder Triggers de berichten die Grok Bot moet beantwoorden.
3. Geef onder Connect de webhook een naam en plak de webhook-URL en de sender key.
4. Controleer de webhook en maak hem aan.

Elk bericht post het event JSON naar de webhook-URL van de routine, met de sender key als Bearer-token, en de routine voert zijn opgeslagen prompt uit.

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.