---
title: "Conectores de webhook"
description: "Todas las plataformas a través de las que puede entregar un endpoint de webhook: sus campos, los eventos que acepta y la configuración que debes hacer antes en la plataforma."
canonical: "https://bird.com/es-es/documentacion/ai/webhook-connectors"
---

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

# Conectores de webhook

Un conector entrega cada evento como la solicitud que espera su plataforma, en lugar de enviar el evento sin procesar a una URL que alojas tú. Configúralo desde el [panel](https://bird.com/dashboard/w/webhooks/new), con `bird webhooks create --connector <id>` o con `destination.connector` en [Crear un webhook](/docs/api/reference/create-webhook). Bird construye la URL del endpoint a partir del conector y sus campos, por lo que el endpoint no lleva un `url` propio.

Los campos no secretos van en `config` y los secretos en `credentials`. Los valores secretos son de solo escritura: ninguna respuesta los incluye. Si una creación omite un campo que el conector necesita o incluye uno que no admite, se rechaza y se indican los campos del conector. Para ver un recorrido paso a paso, consulta [Enruta los mensajes a tu agente de IA](/docs/ai/route-messages-to-an-agent).

## Claude Managed Agents

Envía cada mensaje que recibes a tu agente gestionado de Claude. Su ID es `claude_managed_agents`.

Acepta `whatsapp.received`, `sms.received`, `email_mailbox.message_received` y `amb.received`.

| Campo            | Va en         | Obligatorio | Descripción                                                                                                                         |
| ---------------- | ------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `agent_id`       | `config`      | Sí          | Se devuelve al crear el agente. Las sesiones usan su versión más reciente.                                                          |
| `environment_id` | `config`      | Sí          | Se devuelve al crear el entorno.                                                                                                    |
| `vault_id`       | `config`      | No          | Un almacén de credenciales que usa el agente, como el que guarda su credencial Bird MCP, para que pueda responder a través de Bird. |
| `api_key`        | `credentials` | Sí          | Del espacio de trabajo de Claude en el que se ejecuta tu agente.                                                                    |

Antes de conectarlo, haz lo siguiente en la plataforma:

1. **Primero, configura tu agente en Claude.** En la Claude Console, crea el agente, su entorno y una clave de API en el mismo espacio de trabajo, y luego introduce sus ID y la clave en Bird. Consulta [platform.claude.com](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session).
2. **Crea una clave de API.** Hazlo en el espacio de trabajo de Claude en el que se ejecuta tu agente. Consulta [platform.claude.com](https://platform.claude.com/settings/keys).
3. **Copia los ID del agente y del entorno.** Cada creación devuelve su ID. Consulta [platform.claude.com](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session).
4. **Opcionalmente, añade un almacén de credenciales.** Para que el agente pueda responder a través de Bird, guarda su credencial Bird MCP en un almacén de credenciales de Claude e indica aquí el ID del almacén. Cada sesión recibe ese almacén. Consulta [platform.claude.com](https://platform.claude.com/docs/en/managed-agents/vaults).

## Grok Bot

Envía cada mensaje que recibas a una rutina de Grok Bot. Su ID es `grok_bot`.

Acepta `whatsapp.received`, `sms.received`, `email_mailbox.message_received` y `amb.received`.

| Campo         | Va en         | Obligatorio | Descripción                                                               |
| ------------- | ------------- | ----------- | ------------------------------------------------------------------------- |
| `webhook_url` | `config`      | Sí          | La URL del webhook de la rutina.                                          |
| `sender_key`  | `credentials` | Sí          | La clave de remitente de la rutina. Bird la envía solo como token Bearer. |

Antes de conectarlo, en la plataforma:

1. **Primero, pide a Grok Bot que cree una rutina.** Pide a Grok Bot que cree una rutina con un disparador de webhook y, después, introduce en Bird la URL del webhook y la clave de remitente que te proporcione. Consulta [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)