# 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](/docs/guides/webhooks) reçoit, et répond via les outils que vous lui avez fournis, comme le [serveur Bird MCP](/docs/ai/mcp-server).

## 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](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session) : créez l'agent et son environnement, ainsi qu'une [clé API](https://platform.claude.com/settings/keys) 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 :

1. [Créez un webhook](https://bird.com/dashboard/w/webhooks/new) et choisissez **Claude Managed Agents**.
2. Sous **Triggers**, sélectionnez les messages auxquels Claude doit répondre.
3. Sous **Connect**, nommez le webhook et saisissez l'agent ID, l'environment ID et la clé API.
4. 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](https://cursor.com/docs/cloud-agent/automations#webhook-triggers).

Connectez-le ensuite dans Bird :

1. [Créez un webhook](https://bird.com/dashboard/w/webhooks/new) et choisissez **Grok Bot**.
2. Sous **Triggers**, sélectionnez les messages auxquels Grok Bot doit répondre.
3. Sous **Connect**, nommez le webhook et collez l'URL du webhook et la clé d'envoi.
4. 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](https://platform.claude.com/settings/keys) 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 :

```bash
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`](/docs/api/reference/create-webhook). 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`](/docs/api/reference/test-webhook). 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}`](/docs/api/reference/update-webhook) `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

- [Webhooks et événements](/docs/guides/webhooks)
- [Serveur MCP](/docs/ai/mcp-server)
- [Configurer votre agent de développement](/docs/ai/set-up-your-agent)

## Related resources

- [Setting up your coding agent](/learn/basics/setting-up-your-coding-agent) (video)
- [What is an MCP server, and how does an agent use one to send messages?](/explained/platform/what-is-an-mcp-server-and-how-does-an-agent-send-messages) (answer)
- [Coding agents](/ai) (product)
- [Build with AI agents](/learn/paths/agents) (course)

[Get an implementation brief](/learn/workspace?topic=agents)