Cómo crear un agente de WhatsApp con OpenAI Agents SDK

OpenAI Agents SDK es el framework de código abierto de OpenAI para crear agentes: un modelo con instrucciones, herramientas a las que puede llamar, traspasos a otros agentes y barreras de seguridad en torno a sus entradas y salidas, todo ejecutado en un bucle hasta completar la tarea. Es una forma excelente de crear un agente. Por sí solo, no le da un número de WhatsApp, una bandeja de entrada de equipo, mensajes de plantilla ni una forma de que una persona tome el relevo. Con el Agent Harness de MonoChat, elige OpenAI Agents SDK como AI Harness, coloca un nodo AI Agent en un flujo, conecta WhatsApp y prueba, y MonoChat se ocupa del resto.

Esta guía explica lo que le ofrece el SDK, las tres formas de usar agentes de OpenAI en MonoChat, una configuración paso a paso y los detalles propios de WhatsApp que deciden si los clientes confían en el agente.

Lo que le ofrece OpenAI Agents SDK

El SDK se basa en un pequeño conjunto de ideas:

• Agentes: un modelo más unas instrucciones que describen su trabajo.
• Herramientas: funciones a las que el agente puede llamar, como “consultar un pedido” o “comprobar un hueco horario”, además de servidores MCP.
• Traspasos entre agentes (handoffs): un agente que pasa la tarea a otro especializado en ella, por ejemplo de un agente de soporte general a un agente de devoluciones.
• Barreras de seguridad (guardrails): comprobaciones que se ejecutan junto al agente para detener entradas o salidas no deseadas.
• Sesiones y trazabilidad: memoria entre turnos y un registro de lo que hizo el agente, paso a paso.

En conjunto, eso es un agent harness: el bucle que permite a un modelo actuar, comprobar su trabajo y continuar, en lugar de responder una sola vez. En la mensajería con clientes, esa es la diferencia entre explicar su política de devoluciones y crear realmente la devolución.

Lo que WhatsApp añade al problema

Crear el agente es la mitad del trabajo. Ponerlo frente a los clientes en WhatsApp implica gestionar:

• La plataforma WhatsApp Business. Una conexión oficial por API, una empresa verificada y un número aprobado.
• La ventana de 24 horas. Las respuestas de formato libre se permiten dentro de las 24 horas posteriores al último mensaje del cliente; después necesita una plantilla aprobada.
• La política. Desde el 15 de enero de 2026, WhatsApp excluye de la plataforma a los asistentes de IA de propósito general. Un agente que atiende a sus propios clientes está permitido, y se espera una vía clara hacia una persona cuando las respuestas son automáticas.
• Las personas. Algunas conversaciones deben pasar a una persona, con el historial intacto, dentro de la herramienta que su equipo ya usa.
• Otros canales. Los clientes que escriben en Instagram, Messenger o su sitio web esperan las mismas respuestas.

MonoChat gestiona todo esto alrededor del agente, de modo que su trabajo se centra en el propio agente.

Tres formas de usar agentes de OpenAI en MonoChat

Opción	Dónde se ejecuta	Qué necesita
OpenAI Agents SDK	Dentro de MonoChat	Nada adicional; usa sus modelos de IA
OpenAI Agents API (alojado por OpenAI)	La nube de OpenAI	Su clave de API de OpenAI
Personalizado (su propio servicio de Agents SDK)	Su propio servidor	Una URL de endpoint y un secreto compartido

Empiece con el harness de OpenAI Agents SDK si quiere un agente al estilo OpenAI sin desplegar nada. Elija OpenAI Agents API si sus agentes ya viven en la plataforma alojada de OpenAI. Elija Personalizado si sus desarrolladores han escrito su propio agente con el SDK, con sus propias herramientas, traspasos y pruebas, y quieren seguir ejecutando ese código; consulte cómo conectar su propio agente de IA a WhatsApp.

Paso a paso: un agente de OpenAI Agents SDK en WhatsApp

1. Añada un AI Harness

Añada un AI Harness en MonoChat y elija OpenAI Agents SDK como proveedor. Se ejecuta dentro de MonoChat y usa los modelos de IA que ya tiene configurados, así que en este paso no hay claves ni servidores adicionales.

2. Añada un nodo AI Agent a un flujo

En el flujo que recibe sus conversaciones de WhatsApp, añada un nodo AI Agent y seleccione el harness. Escriba las instrucciones del agente: a quién atiende, qué puede hacer, qué no debe hacer nunca y cuándo traspasa.

3. Elija los modelos principal, de respaldo y rápido

Cada nodo AI Agent tiene tres roles de modelo:

• El modelo principal razona y redacta las respuestas.
• El modelo de respaldo toma el relevo tras un límite flexible o un fallo.
• El modelo rápido se encarga del trabajo en segundo plano.

Añada un límite de presupuesto por ejecución para que una conversación inusual no genere una factura elevada. ¿No sabe cómo elegir el respaldo? Lea por qué su agente de IA de cara al cliente necesita un modelo de respaldo.

4. Conecte sus herramientas

Dé al agente las herramientas que se correspondan con sus solicitudes más frecuentes:

• Herramientas de función de IA para llamadas a sus propias API con entradas estructuradas.
• Integración MCP para herramientas de sistemas compatibles con MCP.
• La base de conocimiento de IA para respuestas basadas en sus documentos y políticas.
• Funciones personalizadas para la lógica que se ejecuta dentro de la conversación.

Tres buenas herramientas valen más que quince probadas a medias. Añada más cuando vea conversaciones reales.

5. Conecte WhatsApp (y todo lo demás)

Conecte su número de WhatsApp Business a través de MonoChat, un Meta Business Partner oficial. El mismo flujo puede ejecutarse en Instagram, Messenger, TikTok, Telegram, chat web, SMS y voz, así que un solo agente cubre todos los canales.

6. Pruebe con mensajes reales

Use las conversaciones del mes pasado como conjunto de pruebas. Incluya las difíciles: clientes enfadados, preguntas vagas, varias solicitudes en un mismo mensaje, un cliente que pide hablar con una persona desde el primer momento. Compruebe las llamadas a herramientas, el tono y el traspaso. Después, póngalo en marcha.

Pautas que funcionan bien en WhatsApp

Una pregunta por mensaje. Los agentes creados para el chat en la web tienden a responder con listas largas. En un teléfono, los mensajes cortos y una pregunta clara cada vez obtienen mejores respuestas de los clientes.

Confirme antes de las acciones irreversibles. Deje que el agente proponga y que el cliente confirme antes de una cancelación, un reembolso o un cambio de reserva.

Especialistas mediante traspasos entre agentes, personas mediante la bandeja de entrada. Los traspasos del SDK son ideales para enrutar entre agentes (ventas, soporte, devoluciones). El traspaso a una persona corresponde a la bandeja de entrada de equipo compartida de MonoChat, donde la conversación llega con todo su historial.

Instrucciones que nombren los límites. “Puede aprobar reembolsos de hasta 50 €; por encima de esa cantidad, traspase al equipo de facturación”. Los números explícitos son mejores que las reglas vagas.

Manténgalo centrado en su negocio. Un agente que ayuda a sus clientes está permitido en WhatsApp. Uno que responde a cualquier cosa corre el riesgo de incumplir las normas de WhatsApp de 2026; nuestra guía de la política de WhatsApp sobre chatbots de IA explica dónde está el límite.

Costes

Se suman tres cosas: su plan de MonoChat, el uso de los modelos de IA y las tarifas de mensajes de WhatsApp de Meta. Desde el 1 de octubre de 2026, Meta cobra las respuestas de servicio después de las primeras 1.000 por número de empresa cada mes; consulte nuestra guía de precios de la API de WhatsApp.

En cuanto a la IA, MonoChat no añade ningún recargo cuando usa sus propias claves de proveedor. Los presupuestos por ejecución, un modelo rápido más económico para el trabajo en segundo plano y un respaldo fiable mantienen la factura predecible.

Sin ataduras

Agent Harness le permite elegir el framework, no solo el modelo. Si más adelante quiere probar Claude Agent SDK, Pi, Claude Managed Agents o su propio framework, añada otro AI Harness y dirija el nodo AI Agent hacia él. Sus canales, herramientas y traspaso siguen como están. Compare todos los proveedores en la página de Agent Harness.