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, avec bird webhooks create --connector <id> ou avec destination.connector sur Create a 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.
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 :
- 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.
- Créez une clé API. Faites-le dans l’espace de travail Claude dans lequel votre agent s’exécute. Consultez platform.claude.com.
- Copiez les ID de l’agent et de l’environnement. Chaque création renvoie l’ID correspondant. Consultez platform.claude.com.
- 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.
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 :
- 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.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet.