En Turquía, cuando un cliente quiere comunicarse con usted, lo más probable es que la primera aplicación que abra sea WhatsApp. Ahora bien, ¿cómo convertir ese canal, que hoy depende de una persona que escribe desde la aplicación verde de su teléfono, en un sistema de atención al cliente disponible 24/7, impulsado por IA y gestionado desde su propia interfaz? La respuesta: la WhatsApp Business Cloud API y, detrás de ella, la API de Claude (Anthropic).
Este artículo no se queda en la superficie. Explicamos qué es exactamente la “nueva API”, por qué no puede usar ese número en su teléfono, cómo crear su propia interfaz de WhatsApp con webhooks y —el tema que más se malinterpreta— las plantillas de mensajes y la regla de las 24 horas, de principio a fin. Después mostramos la arquitectura para colocar a Claude detrás y poner en marcha un asistente de soporte autónomo.
¿Qué es exactamente la “nueva API”? La WhatsApp Business Cloud API
La primera fuente de confusión son los nombres. Hay tres cosas distintas:
- WhatsApp (aplicación personal): El WhatsApp normal de su teléfono.
- WhatsApp Business App: Para pequeñas empresas; también se gestiona manualmente desde un teléfono.
- WhatsApp Business Platform (Cloud API): La API programática alojada en la nube de Meta. A esto nos referimos con “la nueva API”. Sustituyó a la antigua On-Premises API, que había que alojar por cuenta propia; ahora Meta gestiona la infraestructura y usted simplemente se conecta a la API.
La Cloud API permite que un software (su sistema) envíe y reciba mensajes por WhatsApp. Dicho de otro modo, quien habla no es una persona, sino el código. De ahí proceden tanto su potencia como sus reglas.
El punto crítico: este número no se usa en el teléfono
La confusión más habitual: “cuando conecte la API, también lo miraré desde WhatsApp en mi teléfono”. No. Cuando registra un número de teléfono en la Cloud API, ese número ya no puede usarse al mismo tiempo en la aplicación normal de WhatsApp ni en la de WhatsApp Business. Se convierte en un “número de API”.
Por eso, en la práctica, recomendamos usar para la comunicación con clientes un número independiente, dedicado exclusivamente a la API. Si además desea seguir usando manualmente su número de empresa actual, no lo migre a la API: reserve una línea nueva. Así, el sistema no se rompe por la expectativa de “voy a mirarlo también en el teléfono”.
Entonces, ¿dónde verá los mensajes? La respuesta está en la siguiente sección: en su propia interfaz.
Cómo crear su propia interfaz de WhatsApp con webhooks
La Cloud API funciona en dos direcciones:
- Mensajes entrantes: Cuando un cliente le escribe, Meta envía el evento a su servidor al instante como una solicitud HTTP POST mediante un webhook. Usted no “sondea” en busca de mensajes: Meta se los envía. Las confirmaciones de entrega y de lectura llegan por el mismo canal.
- Mensajes salientes: Para responder, usted hace una solicitud al endpoint
/messagesde la Graph API de Meta (con el ID de su número de teléfono y su token de acceso).
Con estos dos extremos puede crear su propia interfaz de WhatsApp: captura cada mensaje entrante en el webhook, lo guarda en su base de datos (y en su CRM) y lo muestra como una “bandeja de entrada” en su propio panel. Los agentes responden desde ahí y el historial de la conversación se acumula en la ficha del cliente. Ya no hace falta la aplicación verde. Verificar el webhook (verify token) y validar las solicitudes entrantes con una firma (app secret) son los pasos básicos de seguridad.
Las plantillas y la regla de las 24 horas: el tema que más se malinterpreta
Aquí es donde todo el mundo se atasca, así que seamos precisos. Para evitar que las empresas envíen spam a las personas, WhatsApp aplica una regla estricta:
La ventana de atención al cliente de 24 horas
En el momento en que un cliente le escribe, se abre una ventana de 24 horas. Dentro de ella puede enviarle mensajes de formato libre (con el contenido que desee), como en un chat normal. Cada nuevo mensaje del cliente vuelve a extender la ventana a 24 horas.
Cuando la ventana se cierra o nunca se abrió: solo plantillas aprobadas
Ahora viene la frase clave: no puede enviar un mensaje de formato libre a través de la API a alguien que nunca le ha escrito. Del mismo modo, una vez cerrada la ventana de 24 horas, tampoco puede enviar texto libre. En ambos casos, la única vía es enviar una plantilla de mensaje previamente aprobada por Meta.
Por tanto, en un escenario del tipo “tengo 5000 números, voy a enviarles una campaña a todos”, si esas personas no le han escrito antes, solo puede llegar a ellas con una plantilla aprobada y su consentimiento previo (opt-in). Las plantillas pasan por la aprobación de Meta y se dividen en categorías:
- Utility (utilidad): Mensajes transaccionales, como el estado del pedido, los recordatorios de citas o la información de envío.
- Marketing: Campañas, comunicados y mensajes de reactivación.
- Authentication (autenticación): Mensajes con contraseñas de un solo uso (OTP).
En resumen, la lógica es esta: si el cliente inicia la conversación → conversa libremente durante 24 horas. Si quiere iniciarla usted → son obligatorios una plantilla aprobada + el opt-in. Cualquier sistema creado sin conocer esta regla se estrella en la primera campaña.
Nota: los precios de Meta para conversaciones y plantillas se basan en categorías y se actualizan de vez en cuando; antes de empezar, confirme los precios vigentes en la documentación oficial de Meta.
Colocar la API de Claude detrás: un programa autónomo de atención al cliente
Ahora viene lo mejor. Usted captura el mensaje entrante en el webhook, pero ¿quién escribe la respuesta? Aquí entra en juego la API de Claude. El flujo funciona así:
- 1. El cliente escribe por WhatsApp → Meta reenvía el mensaje a su servidor mediante un webhook.
- 2. Su servidor (p. ej., Laravel) recibe el mensaje y reúne el historial de la conversación y el contexto del cliente (desde el CRM).
- 3. Usted envía este contexto, junto con una instrucción de sistema (system prompt), a la Messages API de Claude: “Usted es el asistente de soporte de la marca X, siga estas reglas, dispone de esta información…”
- 4. Claude genera una respuesta. Cuando hace falta, mediante el uso de herramientas (tool use) accede a los datos reales de su sistema: consultar un pedido, comprobar el stock, crear una cita, iniciar una devolución.
- 5. Si la ventana de 24 horas está abierta, usted devuelve la respuesta a través de la API de WhatsApp como mensaje de formato libre. Si está cerrada, continúa con una plantilla adecuada.
Con esta arquitectura, su asistente deja de ser “un bot con respuestas predefinidas” y se convierte en una capa de soporte capaz de razonar y conectada a los datos de su empresa. Gracias al uso de herramientas de Claude, responde a “¿dónde está mi pedido?” con el estado real del envío y a “¿hay alguna cita mañana?” con el calendario real. Con el prompt caching guarda en caché la instrucción de sistema que se repite para reducir costos; con las reglas de derivación a una persona (human handoff) traslada los temas delicados a un agente humano.
¿Qué puede crear con esto?
- Soporte de primer nivel 24/7: Responde al instante a preguntas frecuentes y a consultas sobre el seguimiento de pedidos y envíos o el proceso de devolución, incluso a medianoche.
- Citas y reservas: Clínica, peluquería, servicio técnico: el cliente reserva por WhatsApp y el sistema lo anota en el calendario.
- Cualificación de leads: El asistente madura la solicitud entrante mediante preguntas y deriva a ventas las que están cualificadas.
- Soporte multilingüe: Turco, inglés, alemán: Claude cambia de idioma dentro del mismo asistente.
- Notificaciones de pedidos: Mensajes transaccionales como “su pedido ha sido enviado” (mediante plantillas de utilidad).
Aspectos que debe tener en cuenta
- Opt-in: Debe contar con el consentimiento de las personas a las que enviará plantillas; de lo contrario, baja la calificación de calidad de su número.
- Calificación de calidad y límites de mensajería: Meta asigna una calificación de calidad a su número y establece niveles para la cantidad de mensajes diarios que puede enviar. Un comportamiento propio del spam reduce ese límite.
- Protección de datos (KVKK, Ley turca n.º 6698, y RGPD): Configure correctamente el consentimiento explícito, la conservación y la supresión al tratar datos de clientes.
- Salvaguardas de la IA: Indique claramente al asistente lo que puede y lo que no puede hacer; restrinja temas como los compromisos de precio o el asesoramiento jurídico y derívelos a una persona.
Cómo le ayuda Partnerfy
Este sistema se apoya en cuatro pilares y los cuatro son nuestra especialidad: la infraestructura de mensajería multicanal, la integración de API (webhook + Graph API + gestión de plantillas), la IA y la automatización (integración de Claude, uso de herramientas, salvaguardas) y la conexión con CRM/ERP. Desde la migración del número a la API hasta su propia interfaz de bandeja de entrada y el asistente impulsado por Claude, lo construimos todo de principio a fin.
Si desea automatizar con IA su línea de soporte por WhatsApp, póngase en contacto con nosotros: analizaremos sus escenarios y le propondremos la arquitectura adecuada.