Qué es la API de WhatsApp para enviar mensajes

La API de WhatsApp para enviar mensajes es la interfaz oficial que ofrece Meta para que una empresa mande y reciba mensajes de WhatsApp desde un software, sin depender de un celular con la app abierta. Hoy la versión principal es la WhatsApp Cloud API, alojada por Meta, y las empresas la usan directamente o a través de una plataforma que se conecta a ella. Para iniciar conversaciones usa plantillas aprobadas por Meta, y para contestar usa mensajes libres dentro de una ventana de atención.

En la calle se la llama de muchas formas: "API de WhatsApp Business", "WhatsApp API", "API oficial" o directamente "la API". En todos los casos se habla de lo mismo: un canal programable, con reglas que pone Meta, pensado para negocios que manejan más mensajes de los que una persona puede atender desde un teléfono.

¿Por qué le importa a una PyME?

Mientras un negocio recibe pocos mensajes por día, la app de WhatsApp Business alcanza. El problema aparece cuando el volumen crece: varias personas tienen que contestar desde el mismo número, hay que mandar recordatorios de turnos o avisos de pedido, y nadie sabe quién respondió qué. La API resuelve justamente esa parte operativa.

• Permite que varias personas del equipo atiendan el mismo número desde una bandeja compartida, en vez de pasarse un celular.
• Habilita mensajes automáticos o programados (confirmaciones, recordatorios, avisos de envío) con plantillas aprobadas.
• Se conecta con otros sistemas: agenda, tienda online, planillas o herramientas de automatización mediante webhooks.
• Deja registro de cada conversación, lo que sirve para medir tiempos de respuesta y no perder consultas.
• Usa un canal oficial, con reglas claras sobre qué se puede mandar, en vez de herramientas que imitan a un usuario humano.

¿Cómo se usa en la práctica?

Casi ninguna PyME programa contra la API desde cero. Lo habitual es usar una plataforma que ya hizo esa integración y ofrece una interfaz para el equipo. Igual conviene conocer los pasos de fondo, porque explican buena parte de los problemas que aparecen después:

1. 1Tener una cuenta de Meta Business y un número de teléfono para dedicarlo a la API. Según la documentación oficial de Meta sobre números de teléfono (https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers), hay requisitos y pasos de registro propios para cada número.
2. 2Dar de alta el número, muchas veces con el registro integrado (Embedded Signup) que ofrecen las plataformas: https://developers.facebook.com/docs/whatsapp/embedded-signup.
3. 3Crear las plantillas de mensaje que vas a usar para iniciar conversaciones y mandarlas a aprobación. La aprobación puede tardar hasta 48 hs.
4. 4Configurar los webhooks, que son el mecanismo con el que Meta avisa a tu sistema de que entró un mensaje o cambió un estado (enviado, entregado, leído): https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks.
5. 5Empezar a enviar: mensajes libres para contestar a quien te escribió y plantillas para iniciar contacto, siempre dentro de la política de WhatsApp Business.

Desde ahí, el trabajo diario pasa por la plataforma. Por ejemplo, en Wando el equipo atiende desde una bandeja donde la IA sugiere respuestas que aprende de las respuestas reales del negocio, y una persona las aprueba con un click antes de que salgan. La API es el caño por el que viajan los mensajes; la plataforma es lo que el equipo ve y usa.

Un ejemplo concreto: recordatorios de turnos en un centro de estética

Supongamos un centro de estética con dos profesionales y unos treinta turnos por semana. Antes, la recepcionista mandaba recordatorios uno por uno desde su celular y anotaba las respuestas en un cuaderno. Con la API el circuito queda así:

1. 1El negocio crea una plantilla de categoría utilidad: "Hola {{1}}, te recordamos tu turno de {{2}} mañana a las {{3}}. ¿Confirmás?", con botones de respuesta "Confirmo", "Cancelo" y "Quiero cambiarlo". Meta la revisa (hasta 48 hs).
2. 2El día anterior a cada turno, el sistema manda la plantilla con los datos de ese cliente cargados en las variables.
3. 3La clienta toca "Quiero cambiarlo". Ese toque llega por webhook como respuesta a un mensaje con botones (https://developers.facebook.com/docs/whatsapp/cloud-api/messages/interactive-reply-buttons-messages).
4. 4Como la clienta respondió, se abre la ventana de atención y la recepcionista puede contestar con mensajes libres: le ofrece dos horarios y le manda la dirección.
5. 5La clienta elige un horario, la agenda se actualiza y queda todo registrado en la conversación, sin cuaderno.

En el ejemplo se ven los dos tipos de envío que tiene la API: la plantilla que inicia el contacto y los mensajes libres que siguen después de que el cliente contesta. Entender esa diferencia es la base de todo lo demás.

¿Qué tipos de mensajes se pueden enviar por la API?

La API no se limita al texto. Según la documentación oficial de Meta sobre el envío de mensajes (https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-messages), admite varios formatos, cada uno con su propia página de referencia:

¿Con qué se confunde y en qué se diferencia?

Hay tres cosas que muchas veces se mezclan con la API y que no son lo mismo:

La confusión más cara es la tercera fila: alguien busca "API de WhatsApp para enviar mensajes", encuentra una herramienta barata que manda cientos de mensajes desde WhatsApp Web y cree que está usando la API. No la está usando, y las reglas que lo protegen en la API oficial no corren para esa herramienta.

¿Cómo se relaciona con la API oficial de Meta?

No existen "varias APIs de WhatsApp" en competencia: la API la provee Meta. Según la documentación oficial de Meta sobre la Cloud API (https://developers.facebook.com/docs/whatsapp/cloud-api/overview), la Cloud API está alojada en la infraestructura de Meta y es el camino que hoy recomienda para que las empresas se conecten. Lo que ofrecen las distintas plataformas del mercado es una forma de usar esa misma API: interfaz, bandeja, automatizaciones, reportes.

Eso define una división de responsabilidades que conviene tener clara. Meta decide qué plantillas se aprueban, qué se puede enviar según su política, cuánto se cobra cada mensaje y cuántos mensajes puede mandar un número. La plataforma que elijas decide cómo trabaja tu equipo: cómo se reparten las conversaciones, qué se automatiza y cómo se ven los datos. Si una plataforma te promete saltarse una regla de Meta, desconfiá, porque no puede hacerlo. Los cambios de la API se publican en el registro oficial de cambios: https://developers.facebook.com/docs/whatsapp/business-platform/changelog.

¿Cuánto cuesta enviar mensajes por la API?

Hay dos costos distintos que no hay que mezclar. El primero lo cobra Meta por los mensajes. Según la documentación oficial de Meta sobre precios (https://developers.facebook.com/docs/whatsapp/pricing), el valor depende del país del destinatario y de la categoría del mensaje (por ejemplo, marketing o utilidad), y Meta lo actualiza cada tanto. Por eso no tiene sentido fijar un número en un artículo: consultá siempre la tabla vigente en esa página.

El segundo costo es el de la plataforma que uses arriba de la API, si usás una. Ese precio lo fija cada proveedor y no incluye necesariamente lo que cobra Meta. Antes de comparar opciones, preguntá si el precio que ves incluye o no los cargos de Meta, porque es una de las fuentes más comunes de sorpresas en la primera factura.

¿Qué errores comunes hay al usarla y qué hacer con cada uno?

• Querer mandar un mensaje libre a alguien que no te escribió hace rato. Según la documentación oficial de Meta, fuera de la ventana de atención sólo se puede iniciar contacto con una plantilla aprobada (https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates). Qué hacer: prepará de antemano plantillas para los casos repetidos (seguimiento, recordatorio, aviso).
• Elegir mal la categoría de la plantilla, por ejemplo cargar como utilidad un mensaje que en realidad es promocional. Qué hacer: si es una oferta, cargala como marketing; si te la rechazan, leé el motivo, corregí el texto y volvé a mandarla.
• Registrar en la API un número que ya se usa en la app WhatsApp Business sin revisar antes qué pasa con ese número. Según la documentación oficial de Meta sobre números (https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers), el registro tiene condiciones propias. Qué hacer: leé esas condiciones o consultá con tu proveedor antes de migrar, y si no estás seguro usá primero un número de prueba.
• No configurar bien los webhooks y creer que "no llegan mensajes". Qué hacer: revisá que la URL del webhook esté verificada y suscripta a los eventos de mensajes. Si después de revisarlo sigue fallando, escalalo a soporte de tu plataforma con el número y la hora del intento: el tiempo de resolución depende de cada caso.
• Armar plantillas genéricas que nadie lee. Qué hacer: usá variables con datos reales (nombre, fecha, pedido) y un botón claro de acción.

¿Qué pasa si no lo tenés en cuenta?

Los errores de arriba se arreglan en el día a día. Lo grave es lo que se acumula cuando el negocio usa la API sin respetar sus reglas. Según la documentación oficial de Meta sobre límites y calidad (https://developers.facebook.com/docs/whatsapp/messaging-limits), cada número tiene un límite de cuántos destinatarios distintos puede contactar y una calificación de calidad que depende de cómo reaccionan las personas. Si mucha gente bloquea o denuncia tus mensajes, esa calidad puede bajar, y con ella la capacidad de enviar.

• Campañas a listas compradas o sin permiso: es posible que la calidad del número baje y que la cuenta quede con restricciones según la política de WhatsApp Business (https://business.whatsapp.com/policy).
• Presupuesto sin calcular: si no mirás los precios por categoría y por país, una campaña grande puede costar bastante más de lo que pensabas.
• Dependencia de herramientas no oficiales: si el número que usás para vender termina restringido, perdés el canal justo cuando más lo necesitás.
• Clientes molestos: un recordatorio útil se agradece, pero tres promociones por semana hacen que te silencien o te bloqueen, y eso no se recupera con un mensaje.

¿Cuándo NO te conviene usar la API?

La API no es para todos, y es mejor decirlo claro. Si tu negocio recibe pocos mensajes por día, los contesta una sola persona y no necesitás recordatorios automáticos ni integraciones, la app WhatsApp Business probablemente te alcance y te ahorre configuración y costos por mensaje.

• Cuando querés mandar mensajes masivos a personas que nunca te dieron permiso: la API no lo habilita y la política de WhatsApp lo prohíbe.
• Cuando buscás un canal "gratis e ilimitado": la API tiene costos de Meta y límites por número.
• Cuando todavía no tenés claro qué vas a automatizar: primero ordená tus mensajes repetidos y después decidí la herramienta.
• Cuando necesitás seguir usando ese mismo número desde la app del celular igual que siempre: revisá antes las condiciones de registro de números de Meta, porque puede no ser compatible.