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

Commencez par configurer votre agent dans la Claude Console : créez l'agent et son environnement, ainsi qu'une clé API dans le même espace de travail. Notez l'identifiant de l'agent et l'identifiant de l'environnement. Les nouvelles sessions utilisent la dernière version de l'agent.

Connectez-le ensuite dans Bird :

Créez un webhook et choisissez Claude Managed Agents.
Sous Triggers, sélectionnez les messages auxquels Claude doit répondre.
Sous Connect, nommez le webhook et saisissez l'agent ID, l'environment ID et la clé API.
Vérifiez le webhook et créez-le.

Chaque message démarre une session dont le premier message utilisateur est New Bird event: suivi de l'événement JSON.

Grok Bot

Demandez d'abord à Grok Bot de créer une routine avec un déclencheur webhook. Il vous fournit l'URL du webhook de la routine et la clé d'envoi. Pour configurer le déclencheur manuellement, consultez les déclencheurs webhook de Cursor.

Connectez-le ensuite dans Bird :

Créez un webhook et choisissez Grok Bot.
Sous Triggers, sélectionnez les messages auxquels Grok Bot doit répondre.
Sous Connect, nommez le webhook et collez l'URL du webhook et la clé d'envoi.
Vérifiez le webhook et créez-le.

Chaque message envoie l'événement JSON à l'URL webhook de la routine, avec la clé d'expéditeur comme jeton Bearer, et la routine exécute son prompt enregistré.

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 :

Exemple de code

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

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.

Exploitation

Rotation d'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} credentials. La livraison suivante l'utilise, nouvelles tentatives comprises.
Rediriger vers un autre agent. Créez un nouveau webhook. Une modification ne peut pas changer de plateforme ni modifier des paramètres tels que l'identifiant de l'agent ou l'URL du 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

Poursuivez avec la documentation, les guides et les exemples sur ce sujet.

Obtenir un guide d'implémentation

Ressources associées