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, con bird webhooks create --connector <id> o con destination.connector en Crear un 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.
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:
- 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.
- Crea una clave de API. Hazlo en el espacio de trabajo de Claude en el que se ejecuta tu agente. Consulta platform.claude.com.
- Copia los ID del agente y del entorno. Cada creación devuelve su ID. Consulta platform.claude.com.
- 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.
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:
- 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.
Recursos relacionados
Continúa con la documentación, guías y ejemplos de este tema.