API Oficial de WhatsApp: la guía práctica

Qué es la API Oficial de WhatsApp

La API Oficial de WhatsApp Business es la forma aprobada por Meta para que una empresa use WhatsApp a través de un sistema. Funciona en la nube de la propia Meta y es lo que permite enviar mensajes a muchos clientes, activar un robot de atención y tener varias personas atendiendo el mismo número.

La app WhatsApp Business del celular sigue existiendo y es ideal para que una persona atienda a la vez. La API entra cuando la atención crece: equipo, automatización, IA, difusiones con informes e integración con otros sistemas.

Qué necesitas

• ✓Una cuenta de Facebook con acceso al portafolio empresarial de tu empresa en Meta. Si no la tienes, puedes crearla durante la conexión.
• ✓Un número que reciba SMS o llamada para el código de confirmación.
• ✓Un medio de pago en tu cuenta de Meta, para los mensajes que ella cobra.
• ✓Contactos que dieron permiso (opt-in) para recibir mensajes de tu empresa.

Cómo conectar en InvestCRM

1. 1Crea tu cuenta gratis en InvestCRM y confirma el correo.
2. 2En Conexiones, elige conectar un número nuevo o el Modo Coexistencia WhatsApp Business (para el número que ya está en la app del celular).
3. 3En la ventana de Meta, entra con Facebook, elige o crea el portafolio de la empresa y la cuenta de WhatsApp e indica el número.
4. 4Confirma el número con el código (número nuevo) o lee el código QR con la app WhatsApp Business (Coexistencia).
5. 5Listo: el número aparece conectado y las conversaciones llegan a la bandeja de entrada de InvestCRM.

No necesitas crear ninguna aplicación ni tocar configuraciones técnicas de Meta: InvestCRM es Tech Provider y se ocupa de esa parte.

Plantillas de mensaje y categorías

Para hablar primero con alguien, o después de 24 horas sin respuesta, el mensaje tiene que ser una plantilla aprobada por Meta. Cada plantilla tiene una categoría, y la categoría define el precio:

• ✓Marketing: ofertas, invitaciones, novedades, carrito abandonado.
• ✓Utilidad: algo que el cliente pidió o acordó contigo, como confirmación de pedido, recordatorio de cita o aviso de pago. Sin ofertas.
• ✓Autenticación: códigos de acceso y de confirmación, con el texto estándar de Meta.

Si el texto no coincide con la categoría elegida, Meta puede cambiar la categoría (y el precio). InvestCRM avisa cuando eso pasa.

¿Quieres ejemplos listos para copiar? Mira las plantillas de mensaje

La ventana de 24 horas

Cuando el cliente envía un mensaje, se abre una ventana de 24 horas. Dentro de ella respondes con mensajes comunes: texto, foto, audio, documento y botones. Cada nuevo mensaje del cliente reinicia la cuenta. Fuera de la ventana, solo se puede enviar una plantilla aprobada.

Cuánto cobra Meta

Meta cobra por mensaje entregado, con precio por categoría (marketing es la más cara) y por el país de quien recibe. Desde el 1 de octubre de 2026, las respuestas comunes dentro de la ventana de 24 horas (la categoría servicio) también se cobran, después de 1.000 gratis por número cada mes. Los mensajes que envía el cliente son gratis.

Cuánto cuesta cada categoría en reales: mira la tabla completa y un ejemplo de cuenta

Haz la cuenta de tu mes: abrir la calculadora de costos

Fuente: precios de Meta

Tarjeta rechazada en Meta: qué se detiene y cuándo

Meta cobra los mensajes en el medio de pago de tu cuenta de WhatsApp en Meta. Cuando el cobro no pasa (una tarjeta sin saldo, por ejemplo), rechaza el envío con el error 131042, que vale para toda la cuenta y no para un contacto. En la lista de Meta también están: cuenta de pago no vinculada a la cuenta de WhatsApp, línea de crédito por encima del límite o sin activar, y zona horaria o moneda sin definir.

• ✓Se detienen las plantillas de marketing, utilidad y autenticación, que Meta cobra en cada entrega. Eso incluye las difusiones y cualquier automatización o secuencia que envíe una plantilla.
• ✓Las respuestas de atención dentro de la ventana de 24 horas se detienen después de las 1.000 gratis del mes: desde el 1 de octubre de 2026, sin medio de pago, Meta entrega solo esas 1.000 de cada número y no entrega las siguientes.

Qué hace InvestCRM: con el primer error 131042, pausa las difusiones en curso de ese número, para que nadie de la fila se vuelva un fallo, y muestra un aviso en el panel. Después de arreglar el pago en Meta, haz clic en Reanudar: el sistema envía 1 mensaje de prueba, como máximo 1 cada 10 minutos. Si pasa, el aviso desaparece y el envío vuelve al ritmo normal; si Meta lo rechaza de nuevo, la difusión se pausa otra vez.

Fuente: códigos de error de Meta (131042)

Calidad del número y límite de envío

Meta sigue cómo reaccionan las personas a tus mensajes. Muchos bloqueos y denuncias bajan la calidad del número y pueden llevar a restricciones. También limita a cuántas personas distintas llegas con plantillas por día, y ese límite sube a medida que envías con calidad.

En InvestCRM confirmas el opt-in del público antes de cada difusión, quien pide salir sale al instante y la calificación del número queda a la vista para que actúes antes de un problema.

Coexistencia: la app y la API en el mismo número

Con la Coexistencia, el número sigue en la app WhatsApp Business del celular y también queda en la API. Sigues atendiendo por el celular y las conversaciones aparecen en InvestCRM. En la conexión puedes traer los contactos y hasta 6 meses de conversaciones individuales.

• ✓El envío queda limitado a 20 mensajes por segundo.
• ✓La app pierde mensajes temporales, ver una vez, ubicación en tiempo real y listas de difusión (las que existen quedan solo para lectura).
• ✓Los dispositivos vinculados se desconectan.

Por eso la Coexistencia es para atención. Para difusiones grandes, lo mejor es un número solo en la API.

¿Quieres entenderlo mejor? Lee el artículo sobre Coexistencia

Errores comunes y qué hacer

Fuente: códigos de error de Meta