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

Stel eerst je agent in via de Claude Console: maak de agent en zijn omgeving aan, en een API-sleutel in dezelfde werkruimte. Noteer de agent-ID en de omgevings-ID. Nieuwe sessies gebruiken de nieuwste versie van de agent.

Verbind de agent vervolgens in Bird:

Maak een webhook aan en kies Claude Managed Agents.
Selecteer onder Triggers de berichten die Claude moet beantwoorden.
Geef onder Connect de webhook een naam en voer het agent-ID, het environment-ID en de API-key in.
Controleer de webhook en maak hem aan.

Elk bericht start een sessie waarvan het eerste gebruikersbericht New Bird event: is, gevolgd door de event-JSON.

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:

Maak een webhook aan en kies Grok Bot.
Selecteer onder Triggers de berichten die Grok Bot moet beantwoorden.
Geef onder Connect de webhook een naam en plak de webhook-URL en de sender key.
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-key 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:

Codevoorbeeld

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 \
  --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 bevestig dat de agent het afhandelt.

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 key mee in PATCH /v1/webhooks/{webhook_id} credentials. De volgende aflevering gebruikt hem, inclusief retries.
Naar een andere agent verwijzen. Maak een nieuwe webhook aan. Een bewerking kan niet van platform wisselen of instellingen zoals het agent-ID of de webhook-URL wijzigen.
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

Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.

Ontvang een implementatieoverzicht

Gerelateerde bronnen