---
title: "Connecteurs de webhook"
description: "Chaque plateforme par laquelle un endpoint de webhook peut livrer : ses champs, les événements qu'elle accepte et la configuration à effectuer d'abord sur la plateforme."
canonical: "https://bird.com/fr-fr/documentation/ai/webhook-connectors"
---

<!-- Code generated by beak gen:webhook-connectors from the connector definitions; DO NOT EDIT. -->

# Connecteurs de webhook

Un connecteur livre chaque événement sous la forme de la requête attendue par sa plateforme, au lieu d'envoyer l'événement brut à une URL que vous hébergez. Configurez-en un depuis le [tableau de bord](https://bird.com/dashboard/w/webhooks/new), avec `bird webhooks create --connector <id>` ou avec `destination.connector` sur [Create a webhook](/docs/api/reference/create-webhook). Bird construit l'URL de l'endpoint à partir du connecteur et de ses champs ; l'endpoint ne prend donc pas de `url` propre.

Les champs non secrets vont dans `config` et les champs secrets dans `credentials`. Les valeurs secrètes sont en écriture seule : aucune réponse ne les inclut. Une création à laquelle il manque un champ requis par le connecteur, ou qui fournit un champ qu'il n'accepte pas, est refusée, et la réponse indique les champs du connecteur. Pour un guide pas à pas, consultez [Router les messages vers votre agent IA](/docs/ai/route-messages-to-an-agent).

## Claude Managed Agents

Envoyez chaque message reçu à votre agent géré Claude. Son ID est `claude_managed_agents`.

Il accepte `whatsapp.received`, `sms.received`, `email_mailbox.message_received`, `amb.received`.

| Champ            | Emplacement   | Obligatoire | Description                                                                                                                                 |
| ---------------- | ------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `agent_id`       | `config`      | Oui         | Renvoyé lorsque vous créez l'agent. Les sessions utilisent sa dernière version.                                                             |
| `environment_id` | `config`      | Oui         | Renvoyé lorsque vous créez l'environnement.                                                                                                 |
| `vault_id`       | `config`      | Non         | Un coffre d'identifiants utilisé par l'agent, par exemple celui qui contient son identifiant Bird MCP, pour qu'il puisse répondre via Bird. |
| `api_key`        | `credentials` | Oui         | Provient de l’espace de travail Claude dans lequel votre agent s’exécute.                                                                   |

Avant de le connecter, effectuez ces étapes sur la plateforme :

1. **Commencez par configurer votre agent dans Claude.** Dans la Claude Console, créez l’agent, son environnement et une clé API dans le même espace de travail, puis saisissez leurs ID et la clé dans Bird. Consultez [platform.claude.com](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session).
2. **Créez une clé API.** Faites-le dans l’espace de travail Claude dans lequel votre agent s’exécute. Consultez [platform.claude.com](https://platform.claude.com/settings/keys).
3. **Copiez les ID de l’agent et de l’environnement.** Chaque création renvoie l’ID correspondant. Consultez [platform.claude.com](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session).
4. **Si vous le souhaitez, ajoutez un coffre d’identifiants.** Pour que l’agent puisse répondre via Bird, stockez son identifiant Bird MCP dans un coffre d’identifiants Claude et indiquez ici l’ID du coffre. Chaque session reçoit ce coffre. Consultez [platform.claude.com](https://platform.claude.com/docs/en/managed-agents/vaults).

## Grok Bot

Envoyez chaque message reçu à une routine Grok Bot. Son ID est `grok_bot`.

Il accepte `whatsapp.received`, `sms.received`, `email_mailbox.message_received` et `amb.received`.

| Champ         | Emplacement   | Obligatoire | Description                                                                     |
| ------------- | ------------- | ----------- | ------------------------------------------------------------------------------- |
| `webhook_url` | `config`      | Oui         | L’URL de webhook de la routine.                                                 |
| `sender_key`  | `credentials` | Oui         | La clé d’expéditeur de la routine. Bird l’envoie uniquement comme jeton Bearer. |

Avant de le connecter, sur la plateforme :

1. **Commencez par demander à Grok Bot de créer une routine.** Demandez à Grok Bot de créer une routine avec un déclencheur webhook, puis saisissez dans Bird l’URL du webhook et la clé d’expéditeur qu’il vous fournit. Consultez [cursor.com](https://cursor.com/help/grok-bot/routines#where-do-the-webhook-url-and-key-live-and-what-does-a-200-mean).

## 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)