Acheminer les messages vers votre agent IA

Bird envoie chaque message que vous recevez sur WhatsApp, SMS, Apple Messages ou une boîte mail d'agent à votre agent IA. Connectez l'agent une seule fois avec ses informations et ses identifiants, et chaque nouveau message lui parvient.

Deux agents sont pris en charge :

• Claude Managed Agents : chaque message démarre une session d'un agent que vous avez créé dans la Claude Console.
• Grok Bot : chaque message déclenche l'une de vos routines Grok Bot.

Bird envoie chaque message correspondant à votre agent et réessaye une livraison qui échoue, de sorte qu'un message réessayé peut lancer une nouvelle exécution. L'agent reçoit le JSON d'événement du message, le même payload qu'un simple point de terminaison webhook reçoit, et répond via les outils que vous lui avez fournis, comme le serveur Bird MCP.

Choisir les messages auxquels votre agent répond

Votre agent peut répondre uniquement aux messages entrants : whatsapp.received, sms.received, amb.received (Apple Messages) et email_mailbox.message_received. Sélectionnez ceux que l'agent doit traiter. Les accusés de réception, les changements de statut et les autres événements ne sont pas envoyés à un agent.

Claude Managed Agents

1. Dans la Claude Console, créez un agent, un environnement et une clé API.
2. Dans Bird, créez un webhook, choisissez Claude Managed Agents et sélectionnez les messages sous Triggers.
3. Sous Connect, saisissez l'identifiant de l'agent, l'identifiant de l'environnement et la clé API, puis créez le webhook.
4. Sélectionnez Send test.
5. (Facultatif) Pour permettre à l'agent de répondre via Bird, ouvrez l'agent dans la Claude Console, sélectionnez + MCP Server et choisissez Bird. Pour limiter sa consommation de tokens, activez uniquement les outils Bird qu'il utilise, comme l'indique la documentation Claude Managed Agents.
6. (Facultatif) Ouvrez Managed Agents > Credential vaults, créez un coffre, sélectionnez + Add credential, définissez Type sur MCP OAuth, choisissez Bird et sélectionnez Connect.
7. (Facultatif) Saisissez l'identifiant du coffre (il commence par vlt_) sous Connect, ou modifiez un webhook existant pour l'y ajouter.

Grok Bot

1. Installez Bird dans Grok Bot et connectez votre espace de travail Bird.
2. Demandez à Grok Bot de créer une routine avec un déclencheur webhook. Ouvrez la section Webhook de la routine et copiez son URL et sa clé d'expéditeur.
3. Créez le webhook dans Bird, de l'une des deux façons suivantes :
   • Demandez à Grok Bot de le créer avec une destination Grok Bot pour un événement tel que amb.received ou email_mailbox.message_received, en utilisant l'URL et la clé d'expéditeur de l'étape 2. Pour l'e-mail, indiquez la boîte mail.
   • Créez-le dans le tableau de bord : choisissez Grok Bot, sélectionnez l'événement sous Triggers et collez l'URL et la clé d'expéditeur sous Connect.
4. Sélectionnez Send test, puis envoyez un vrai message à votre entreprise ou à votre boîte mail.

Partir d'un modèle (facultatif). Avant l'étape 2, choisissez AMB Booking Desk ou Email Support Desk, puis donnez à Grok Bot son fichier bot.md et shared/message-safety.md comme instructions permanentes. Remplissez Your settings et Knowledge, activez sa compétence de canal et utilisez son Routine prompt pour l'étape 2.

Par défaut, les réponses des modèles sont des brouillons.

Si aucune exécution ne démarre, comparez l'URL Webhook et la clé d'expéditeur de la routine avec les valeurs saisies dans Bird.

Créez-le depuis la CLI ou la API

bird webhooks create --help liste chaque connecteur avec ses champs, lesquels sont secrets, les événements qu'il accepte et la configuration préalable. Passez les champs non secrets avec --field name=value et chaque secret depuis une variable d'environnement avec --secret-env name=ENV_VAR, ou transmettez-le avec --secret-stdin name, pour qu'il ne figure pas dans l'historique de votre shell. --events inclut par défaut tous les événements de message que le connecteur accepte.

Pour Claude, créez une clé API dans l'espace de travail où votre agent s'exécute, puis lisez-la dans l'environnement sans l'afficher, pour qu'elle n'apparaisse jamais dans une ligne de commande ni dans l'historique de votre 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 accepte les mêmes destination sur POST /v1/webhooks. Ne renseignez pas url : Bird le construit à partir du connecteur. Aucune réponse n'inclut les identifiants.

Tester la connexion

Juste après avoir créé le webhook, sélectionnez Send test. Par la suite, utilisez Send test event sur la page du webhook ou dans les actions de sa ligne, ou appelez POST /v1/webhooks/{webhook_id}/test. Vérifiez dans Claude ou Cursor qu'une session ou une exécution a démarré. Envoyez ensuite un vrai message à l'un de vos numéros ou canaux et confirmez que l'agent le traite ; pour Claude, confirmez que la réponse arrive sur le canal de l'expéditeur et que la session n'affiche aucun session.error.

Exploitation

• Renouveler un identifiant. Modifiez le webhook et saisissez uniquement la nouvelle valeur ; un champ laissé vide conserve sa valeur enregistrée. Via la API, envoyez la clé modifiée dans PATCH /v1/webhooks/{webhook_id} destination.connector.credentials. La livraison suivante l'utilise, nouvelles tentatives comprises.
• Modifier ses paramètres. Modifiez le webhook pour changer un paramètre tel que l'identifiant de l'agent, l'identifiant du coffre ou l'URL du webhook d'une routine Grok Bot ; la livraison suivante l'utilise. Pour changer de plateforme, créez un nouveau webhook.
• Suspendre ou supprimer. Suspendre un webhook arrête ses livraisons. Le supprimer efface ses identifiants.
• Consulter les échecs. La liste des tentatives d'un webhook indique pour chaque livraison le code de statut et le corps de la réponse de la plateforme, ou rien si la plateforme n'a pas pu être jointe. Une tentative qui a échoué avant que Bird n'envoie quoi que ce soit, par exemple une connexion modifiée après l'événement, porte à la place un failure_reason.

Étapes suivantes

• MCP Events, pour un client MCP qui s'abonne lui-même à ces événements
• Webhooks et événements
• Serveur MCP
• Configurer votre agent de développement
• Superagent : évaluez les e-mails entrants, les messages SMS et WhatsApp avant que votre agent n'agisse dessus.