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 estándar, y responde con las herramientas que le hayas dado, como el servidor Bird MCP.

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: crea el agente y su entorno, y una clave API 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:

Crea un webhook y elige Claude Managed Agents.
En Triggers, selecciona los mensajes que Claude debe responder.
En Connect, nombra el webhook e introduce el agent ID, el environment ID y la clave API.
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.

Luego conéctalo en Bird:

Crea un webhook y elige Grok Bot.
En Triggers, selecciona los mensajes que Grok Bot debe responder.
En Connect, nombra el webhook y pega la URL de webhook y la clave de remitente.
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 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:

Ejemplo de código

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. 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. 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} 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

Continúa con la documentación, guías y ejemplos de este tema.

Obtener un resumen de implementación

Recursos relacionados