--- title: "Chatbot de IA en WhatsApp con la API de OpenAI (código listo)" description: "Un webhook, una llamada a la API de OpenAI y una respuesta por la API de WhatsApp: el código completo de un chatbot que atiende en WhatsApp, Instagram y Messenger. Con memoria por contacto, control de costo y salida al humano." url: "https://api-wa.me/es/blog/chatbot-ia-openai-whatsapp" language: "es" og:type: "article" og:site_name: "WAME API" --- [Inicio](https://api-wa.me/es)/[Blog de la API de WhatsApp](https://api-wa.me/es/blog)/Cómo crear un chatbot de IA con la API de OpenAI para responder en WhatsApp Raphael Serafim· Publicado el 10 de septiembre de 2026· 10 min de lectura Compartir # Cómo crear un chatbot de IA con la API de OpenAI para responder en WhatsApp Un webhook, una llamada a la API de OpenAI y una respuesta por la API de WhatsApp: el código completo de un chatbot que atiende en WhatsApp, Instagram y Messenger. Con memoria por contacto, control de costo y salida al humano. Copiar para LLM[Ver como Markdown](https://api-wa.me/es/blog/chatbot-ia-openai-whatsapp.md) **Un chatbot de IA en WhatsApp son tres piezas: recibir el mensaje, preguntarle al modelo, devolver la respuesta.** Ninguna es difícil — lo que suele costar es el medio de campo: el formato del webhook, la memoria de la conversación y saber cuándo la IA **no** debe responder. Este artículo muestra el código completo, en Node.js, y resuelve las tres cosas. ## Lo que necesitas 1. Una instancia en la API — la no oficial conecta por código QR en segundos y sirve para probar. 2. Una clave de la [API de OpenAI](https://openai.com/es-419/index/openai-api). 3. Una URL pública para el webhook. En desarrollo, `ngrok` o similar. ## Pieza 1: recibir el mensaje Apunta el webhook de tu instancia (formato `meta`) a tu URL. Todo evento llega en el sobre estándar de la Cloud API, y el campo `provider` dice el canal: ```json { "object": "wame", "provider": "whatsapp", "entry": [{ "id": "", "changes": [{ "field": "messages", "value": { "messages": [{ "from": "525512345678", "id": "wamid.XXXX", "type": "text", "text": { "body": "¿hacen envíos a Guadalajara?" } }] } }] }] } ``` Esto importa más de lo que parece: como los tres canales llegan en el mismo sobre, el bot que escribas para WhatsApp ya atiende Instagram y Messenger. Es el [estándar único de webhook](https://api-wa.me/es/blog/api-instagram-messenger-misma-api-whatsapp) de la plataforma. El extractor, con las guardas que evitan el 90% de los bugs: ```js function extraer(body) { const msg = body?.entry?.[0]?.changes?.[0]?.value?.messages?.[0]; // Los estados de entrega ("delivered", "read") también llegan acá. // Sin esta guarda, el bot se responde a sí mismo en bucle. if (!msg || msg.type !== 'text') return null; return { de: msg.from, texto: msg.text.body, canal: body.provider, messageId: msg.id, }; } ``` ## Pieza 2: preguntarle al modelo La API de OpenAI **no guarda estado**. Cada llamada es independiente, así que la memoria es tuya: ```js import OpenAI from 'openai'; const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY }); // En producción usa Redis o base de datos. En memoria se pierde al reiniciar. const historial = new Map(); const SYSTEM = `Eres el agente de atención de Tienda Ejemplo, en WhatsApp. Reglas: - Responde en español neutro, en máximo 3 frases cortas. - Nunca inventes plazos, precios ni disponibilidad. - Si la pregunta exige un dato que no tienes, responde exactamente con el texto [HUMANO] y nada más.`; async function responder(de, texto) { const anterior = historial.get(de) ?? []; // Últimos 10 mensajes: suficiente para el contexto y // bastante para que el costo no crezca sin límite. const mensajes = [ { role: 'system', content: SYSTEM }, ...anterior.slice(-10), { role: 'user', content: texto }, ]; const r = await openai.chat.completions.create({ model: 'gpt-4o-mini', messages: mensajes, max_tokens: 300, temperature: 0.3, }); const respuesta = r.choices[0].message.content.trim(); historial.set(de, [ ...anterior.slice(-10), { role: 'user', content: texto }, { role: 'assistant', content: respuesta }, ]); return respuesta; } ``` Tres decisiones de ese código merecen explicación: **`temperature: 0.3`** — la atención al cliente no quiere creatividad. Temperatura baja hace la respuesta más previsible y reduce la invención. **`max_tokens: 300`** — WhatsApp no es lugar para párrafos largos. Además de mejorar la lectura, limita el costo por respuesta. **`slice(-10)`** — el costo de OpenAI es por token, y el historial entero viaja en **cada** llamada. Sin recorte, una conversación larga se vuelve progresivamente más cara. ## Pieza 3: devolver por WhatsApp ```js async function enviar(para, texto, canal) { await fetch(`https://us.api-wa.me/${process.env.WAME_KEY}/message/text`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ to: para, text: texto, channel: canal }), }); } ``` ## Todo junto ```js import express from 'express'; const app = express(); app.use(express.json()); app.post('/webhook/wame', async (req, res) => { // Responde 200 DE INMEDIATO. OpenAI tarda segundos, y un webhook // que demora se reenvía — el cliente recibiría la misma respuesta // dos o tres veces. res.sendStatus(200); const msg = extraer(req.body); if (!msg) return; try { const respuesta = await responder(msg.de, msg.texto); if (respuesta.includes('[HUMANO]')) { await enviar(msg.de, 'Un momento, te comunico con alguien del equipo.', msg.canal); await avisarAgente(msg); // tu cola, tu CRM return; } await enviar(msg.de, respuesta, msg.canal); } catch (e) { console.error('falló la respuesta a', msg.de, e); await enviar(msg.de, 'Tuve un problema. Ya te paso con una persona.', msg.canal); await avisarAgente(msg); } }); app.listen(3000); ``` Listo — unas 60 líneas para un bot de IA que atiende en los tres canales. ## El detalle que separa demo de producción **Responder 200 antes de procesar.** Es la línea más importante del archivo. La llamada a OpenAI tarda de 1 a 5 segundos; si tu handler la espera antes de contestar al webhook, la entrega se considera fallida y se reenvía. El resultado es el cliente recibiendo la misma respuesta tres veces — y tú pagándola tres veces. **Tener una salida al humano.** El `[HUMANO]` del system prompt existe para eso. Un bot que responde "no sé" es malo; uno que inventa el plazo de entrega es peor, porque se convierte en reclamo. Cómo funciona el otro lado —cola, asignación y el bot saliendo de escena— está en [varios agentes en el mismo número](https://api-wa.me/es/blog/varios-agentes-mismo-numero-whatsapp). **Tratar el error como camino normal.** OpenAI va a fallar en algún momento: timeout, límite, indisponibilidad. El `catch` no deja al cliente en el vacío. **No responderse a sí mismo.** La guarda en `extraer` se encarga: los estados de entrega y lectura también llegan al webhook. ## ¿Y si el webhook no llega? Pasa, y casi siempre es una de las mismas causas. Antes de tocar el código, apunta el webhook a una URL de [webhook.site](https://webhook.site/) y envía un mensaje: si el evento aparece ahí, el problema es tu servidor; si no aparece, es la configuración de la instancia. Esa prueba de 30 segundos separa los dos mundos. La guía completa está en [el webhook no llega: las 7 causas](https://api-wa.me/es/blog/webhook-whatsapp-no-llega-como-probar). ## Conclusión El chatbot en sí es la parte fácil. Lo que decide si se queda en producción es el entorno: responder el webhook al instante, recortar el historial, tener salida al humano y tratar el error como camino esperado. Empieza con una instancia no oficial y un número de prueba. Cuando el comportamiento esté bien, pasa a la [API oficial](https://api-wa.me/es/blog/whatsapp-business-api-oficial-que-es) — el webhook y el SDK son los mismos, así que el código del bot no cambia. ### ¿Listo para automatizar tu WhatsApp? Crea tu cuenta gratis y empieza a enviar mensajes por la API en minutos. [Empezar gratis](https://portal.api-wa.me/sign-up) ## Preguntas frecuentes ¿Cómo conecto la API de OpenAI con WhatsApp?+ Son tres piezas: un webhook que recibe el mensaje de WhatsApp, una llamada a la API de OpenAI con el historial de la conversación, y un POST a /{key}/message/text devolviendo la respuesta. El webhook recibe todos los canales en el mismo formato, así que el mismo código atiende WhatsApp, Instagram y Messenger. ¿Necesito n8n para hacer un bot de IA en WhatsApp?+ No. n8n es cómodo si quieres armar el flujo visualmente o ya usas la herramienta. En código son unas 60 líneas, y ganas control total sobre la memoria, el costo y las reglas de cuándo no responder. ¿Cuánto cuesta tener un chatbot de IA en WhatsApp?+ Dos costos separados: el de OpenAI, cobrado por token consumido, y el del mensaje. En la API no oficial el mensaje tiene precio fijo por instancia; en la oficial, Meta cobra por conversación. El costo de la IA es el que más varía y depende del tamaño del historial que envías en cada llamada. ¿Cómo hago que el bot recuerde la conversación?+ La API de OpenAI no guarda estado: cada llamada es independiente. Guardas los últimos mensajes por contacto en un almacenamiento tuyo (Redis, base de datos o memoria) y los envías como historial en cada petición. Con los últimos diez suele alcanzar, y mantiene el costo previsible. ¿Qué hago cuando la IA no sabe responder?+ Instruye al modelo en el system prompt para que devuelva un marcador acordado cuando no tenga certeza, y maneja ese marcador en tu código derivando a una persona. Un bot que inventa el plazo de entrega sale más caro que uno que pasa la pelota. ## Sigue leyendo [### API de Instagram y Messenger en la misma API de WhatsApp: una instancia, un estándar Tres canales oficiales de Meta casi siempre significan tres integraciones. Con una sola instancia, el mismo envío y el mismo sobre de webhook, solo cambia un campo: provider. Cómo funciona y qué te ahorra.](https://api-wa.me/es/blog/api-instagram-messenger-misma-api-whatsapp)[### API no oficial de WhatsApp: qué es, si es segura y cómo usarla (2026) Entiende qué es una API no oficial de WhatsApp, cómo funciona la conexión por código QR, si es segura y legal, cuál es el riesgo real de bloqueo y cuándo conviene usarla en lugar de la API oficial.](https://api-wa.me/es/blog/api-no-oficial-whatsapp-que-es)[### API oficial vs no oficial de WhatsApp: ¿cuál elegir? (comparativa 2026) Comparativa completa entre la API oficial de WhatsApp (Cloud API de Meta) y la API no oficial: costo, aprobación, límites de envío, plantillas, soporte y riesgo de bloqueo. Descubre cuál tiene sentido para tu caso.](https://api-wa.me/es/blog/api-whatsapp-oficial-vs-no-oficial) [Volver al blog](https://api-wa.me/es/blog) ## Structured data ```json { "@context": "https://schema.org", "@type": "WebSite", "name": "WAME API", "alternateName": "API Oficial y No Oficial de WhatsApp, Instagram y Messenger", "url": "https://api-wa.me", "inLanguage": "pt-BR", "publisher": { "@id": "https://api-wa.me/#organization", "@type": "Organization", "name": "WAME API", "url": "https://api-wa.me" } } { "@context": "https://schema.org", "@type": "Organization", "@id": "https://api-wa.me/#organization", "name": "WAME API", "alternateName": [ "WAME", "Wame API", "wame.api.br", "api-wa.me" ], "url": "https://api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/web-app-manifest-512x512.png", "width": 512, "height": 512 }, "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.", "identifier": { "@type": "PropertyValue", "propertyID": "INPI-BR", "name": "Pedido de registro de marca (INPI, classe NCL 42)", "value": "944724159" }, "foundingDate": "2017", "slogan": "Socio Oficial de Meta — WhatsApp, Instagram y Messenger en una sola instancia. Desde 2017.", "description": "Plataforma brasileña y Socio Oficial de Meta (Meta Business Partner) para las APIs oficiales de WhatsApp (Cloud API), Instagram Direct y Messenger — las tres en una única instancia, con los mismos endpoints y un único formato de webhook. También ofrece la API no oficial vía Código QR, en la misma plataforma. En el mercado desde 2017, con más de 50 mil instancias creadas, 99,9% de uptime y soporte humano 24/7. SDKs oficiales para Node.js/TypeScript y PHP.", "knowsAbout": [ "WhatsApp Cloud API oficial (Meta)", "API oficial de Instagram (Direct)", "API oficial de Messenger", "API multicanal Meta", "Meta Business Partner", "WhatsApp API", "API não oficial de WhatsApp", "automação de WhatsApp", "números virtuais", "webhooks" ], "sameAs": [ "https://github.com/wame-api", "https://www.linkedin.com/company/wameapi", "https://www.instagram.com/wame.api/", "https://www.youtube.com/@wameapi" ], "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "url": "https://api-wa.me/contact", "availableLanguage": [ "Portuguese" ] } } { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "Cómo crear un chatbot de IA con la API de OpenAI para responder en WhatsApp", "description": "Un webhook, una llamada a la API de OpenAI y una respuesta por la API de WhatsApp: el código completo de un chatbot que atiende en WhatsApp, Instagram y Messenger. Con memoria por contacto, control de costo y salida al humano.", "image": "https://api-wa.me/es/blog/chatbot-ia-openai-whatsapp/opengraph-image", "datePublished": "2026-09-10", "dateModified": "2026-09-10", "author": { "@type": "Person", "name": "Raphael Serafim", "url": "https://github.com/raphaelvserafim", "sameAs": [ "https://github.com/raphaelvserafim" ] }, "publisher": { "@type": "Organization", "name": "api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/screenshot.png" } }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://api-wa.me/es/blog/chatbot-ia-openai-whatsapp" }, "keywords": "chatbot ia whatsapp, openai api whatsapp, gpt en whatsapp, chatgpt whatsapp api, bot de ia whatsapp, integrar openai con whatsapp, asistente virtual whatsapp", "inLanguage": "es" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://api-wa.me" }, { "@type": "ListItem", "position": 2, "name": "Blog de la API de WhatsApp", "item": "https://api-wa.me/blog" }, { "@type": "ListItem", "position": 3, "name": "Cómo crear un chatbot de IA con la API de OpenAI para responder en WhatsApp", "item": "https://api-wa.me/es/blog/chatbot-ia-openai-whatsapp" } ] } { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "¿Cómo conecto la API de OpenAI con WhatsApp?", "acceptedAnswer": { "@type": "Answer", "text": "Son tres piezas: un webhook que recibe el mensaje de WhatsApp, una llamada a la API de OpenAI con el historial de la conversación, y un POST a /{key}/message/text devolviendo la respuesta. El webhook recibe todos los canales en el mismo formato, así que el mismo código atiende WhatsApp, Instagram y Messenger." } }, { "@type": "Question", "name": "¿Necesito n8n para hacer un bot de IA en WhatsApp?", "acceptedAnswer": { "@type": "Answer", "text": "No. n8n es cómodo si quieres armar el flujo visualmente o ya usas la herramienta. En código son unas 60 líneas, y ganas control total sobre la memoria, el costo y las reglas de cuándo no responder." } }, { "@type": "Question", "name": "¿Cuánto cuesta tener un chatbot de IA en WhatsApp?", "acceptedAnswer": { "@type": "Answer", "text": "Dos costos separados: el de OpenAI, cobrado por token consumido, y el del mensaje. En la API no oficial el mensaje tiene precio fijo por instancia; en la oficial, Meta cobra por conversación. El costo de la IA es el que más varía y depende del tamaño del historial que envías en cada llamada." } }, { "@type": "Question", "name": "¿Cómo hago que el bot recuerde la conversación?", "acceptedAnswer": { "@type": "Answer", "text": "La API de OpenAI no guarda estado: cada llamada es independiente. Guardas los últimos mensajes por contacto en un almacenamiento tuyo (Redis, base de datos o memoria) y los envías como historial en cada petición. Con los últimos diez suele alcanzar, y mantiene el costo previsible." } }, { "@type": "Question", "name": "¿Qué hago cuando la IA no sabe responder?", "acceptedAnswer": { "@type": "Answer", "text": "Instruye al modelo en el system prompt para que devuelva un marcador acordado cuando no tenga certeza, y maneja ese marcador en tu código derivando a una persona. Un bot que inventa el plazo de entrega sale más caro que uno que pasa la pelota." } } ] } ```