# Enruta mensajes a tu agente de IA

Bird envía cada mensaje que recibes en WhatsApp, SMS, Apple Messages o un buzón de agente a tu agente de IA. Conecta el agente una vez con sus datos y credenciales, y cada mensaje nuevo le llega.

Se admiten dos agentes:

- **Claude Managed Agents**: cada mensaje inicia una sesión de un agente que creaste en la Claude Console.
- **Grok Bot**: cada mensaje activa una de tus rutinas de Grok Bot.

Bird envía cada mensaje coincidente a tu agente y reintenta una entrega que falla, por lo que un mensaje reintentado puede iniciar otra ejecución. El agente recibe el evento del mensaje JSON, el mismo payload que recibe un [endpoint de webhook](/docs/guides/webhooks) estándar, y responde con las herramientas que le hayas dado, como el [servidor Bird MCP](/docs/ai/mcp-server).

## Elige los mensajes que responde tu agente

Tu agente solo puede responder mensajes entrantes: `whatsapp.received`, `sms.received`, `amb.received` (Apple Messages) y `email_mailbox.message_received`. Selecciona los que el agente debe gestionar. Los acuses de recibo, los cambios de estado y otros eventos no se envían a un agente.

## Claude Managed Agents

Primero, configura tu agente en la [Claude Console](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session): crea el agente y su entorno, y una [clave API](https://platform.claude.com/settings/keys) en el mismo espacio de trabajo. Anota el agent ID y el environment ID. Las sesiones nuevas usan la versión más reciente del agente.

Luego conéctalo en Bird:

1. [Crea un webhook](https://bird.com/dashboard/w/webhooks/new) y elige **Claude Managed Agents**.
2. En **Triggers**, selecciona los mensajes que Claude debe responder.
3. En **Connect**, nombra el webhook e introduce el agent ID, el environment ID y la clave API.
4. Revisa el webhook y créalo.

Cada mensaje inicia una sesión cuyo primer mensaje de usuario es `New Bird event:` seguido del evento JSON.

## Grok Bot

Primero, pide a Grok Bot que cree una rutina con un trigger de webhook. Te dará la URL de webhook de la rutina y la clave de remitente. Para configurar el trigger manualmente, consulta [los triggers de webhook de Cursor](https://cursor.com/docs/cloud-agent/automations#webhook-triggers).

Luego conéctalo en Bird:

1. [Crea un webhook](https://bird.com/dashboard/w/webhooks/new) y elige **Grok Bot**.
2. En **Triggers**, selecciona los mensajes que Grok Bot debe responder.
3. En **Connect**, nombra el webhook y pega la URL de webhook y la clave de remitente.
4. Revisa el webhook y créalo.

Cada mensaje envía el evento JSON a la URL de webhook de la rutina, con la clave de remitente como token Bearer, y la rutina ejecuta su prompt guardado.

## Créalo desde la CLI o la API

`bird webhooks create --help` lista cada conector con sus campos, cuáles son secretos, los eventos que acepta y la configuración previa necesaria. Pasa los campos no secretos con `--field name=value` y cada secreto desde una variable de entorno con `--secret-env name=ENV_VAR`, o pásalo por pipe con `--secret-stdin name`, para que no quede en tu historial de shell. `--events` toma por defecto todos los eventos de mensaje que el conector acepta.

Para Claude, crea una [clave API](https://platform.claude.com/settings/keys) en el espacio de trabajo donde se ejecuta tu agente, y después léela en el entorno sin mostrarla en pantalla, para que nunca aparezca en una línea de comandos ni en tu historial de 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 acepta los mismos `destination` en [`POST /v1/webhooks`](/docs/api/reference/create-webhook). Omite `url`: Bird lo genera a partir del conector. Ninguna respuesta incluye las credenciales.

## Prueba la conexión

Justo después de crear el webhook, selecciona **Send test**. Más adelante, usa **Send test event** en la página del webhook o en las acciones de su fila, o llama a [`POST /v1/webhooks/{webhook_id}/test`](/docs/api/reference/test-webhook). Comprueba en Claude o Cursor que se inició una sesión o ejecución. Después envía un mensaje real a uno de tus números o canales y confirma que el agente lo gestiona.

## Opéralo

- **Rota una credencial.** Edita el webhook e introduce solo el valor nuevo; un campo que dejes en blanco conserva su valor almacenado. A través de la API, envía la clave modificada en [`PATCH /v1/webhooks/{webhook_id}`](/docs/api/reference/update-webhook) `credentials`. La siguiente entrega la usa, reintentos incluidos.
- **Apúntalo a otro agente.** Crea un webhook nuevo. Una edición no puede cambiar de plataforma ni modificar ajustes como el ID de agente o la URL de webhook.
- **Paúsalo o elimínalo.** Pausar un webhook detiene sus entregas. Eliminarlo borra sus credenciales.
- **Consulta los fallos.** La lista de intentos de un webhook muestra cada entrega con el estado de respuesta y el cuerpo que devolvió la plataforma, o ninguno si no se pudo contactar con ella. Un intento que falló antes de que Bird enviara nada, por ejemplo por una conexión que cambió después del evento, lleva un `failure_reason` en su lugar.

## Próximos pasos

- [Webhooks y eventos](/docs/guides/webhooks)
- [Servidor MCP](/docs/ai/mcp-server)
- [Configura tu agente de código](/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)