Integrar WhatsApp Business API con los sistemas de una empresa colombiana requiere cinco pasos en orden: verificar tu empresa en Meta, elegir un proveedor de soluciones certificado (BSP), obtener tus credenciales de la API, configurar los webhooks que sincronizarán los mensajes con tus sistemas y crear plantillas aprobadas para iniciar conversaciones. La verificación de negocio es el requisito previo para activar la API; algunas etapas, como la elección del BSP y el registro del número, siguen un orden lógico y omitirlas genera problemas en el despliegue.
Este artículo cubre cada etapa con los requisitos concretos, los identificadores técnicos que necesitarás y las reglas de cumplimiento que aplican a líneas colombianas con prefijo +57. Al final, también te explicamos cómo Unique EPAD, nuestra plataforma empresarial, reduce gran parte de este trabajo para organizaciones que no quieren construir la integración desde cero.
Lo que debes saber antes de empezar
- Verificación como primer paso: sin aprobación de Meta Business Manager, no puedes registrar ningún número en la API.
- Documentos exactos: el RUT y el certificado de Cámara de Comercio deben coincidir en razón social, NIT y dirección con lo registrado en Meta.
- Número exclusivo: la línea colombiana que uses no puede estar activa en la aplicación de WhatsApp antes de conectarla a la API.
- Tres credenciales esenciales: WABA ID, Phone Number ID y un token de acceso son los identificadores que autentican cada llamada a la API.
- Consentimiento auditable: la normativa colombiana obliga a registrar quién aceptó recibir mensajes, cuándo y para qué tipo de comunicaciones.
- Integración empaquetada: Unique EPAD incluye conexión con WhatsApp Business API dentro de la plataforma, lo que reduce el desarrollo personalizado requerido.
Cómo integrar WhatsApp Business API con los sistemas de una empresa colombiana: requisitos previos
El punto de partida es un portafolio empresarial activo en Meta Business Suite con la información legal exacta de tu empresa: razón social, NIT, dirección y sitio web con HTTPS. Los documentos de respaldo que Meta solicita para empresas colombianas son el RUT, el certificado reciente de existencia y representación legal de la Cámara de Comercio y, en algunos casos, una factura de servicios públicos o un extracto bancario. La información debe ser idéntica en todos los documentos y en el pie de página de tu sitio web; cualquier diferencia en el nombre o la dirección genera demoras o rechazos.
Una vez aprobada la verificación, debes elegir un proveedor BSP certificado para acceder a la API. Para empresas colombianas que ya cuentan con CRM o ERP, los candidatos más comunes a evaluar son 360dialog, Twilio, Infobip, Zenvia y Messangi. La decisión debe basarse en el costo total por mensaje entregado, el acuerdo de nivel de servicio contractual y los conectores disponibles para tus sistemas, no únicamente en la tarifa mensual de la plataforma.
| Proveedor | Perfil de uso | Conectores CRM/ERP | Soporte regional |
|---|---|---|---|
| 360dialog | Control técnico con CRM existente | HubSpot, Salesforce, Zoho, Odoo, API propia | Soporte técnico; verificar acuerdo de nivel de servicio en propuesta |
| Twilio | Arquitecturas multicapa (SMS, voz, WhatsApp) | Muy amplio: CRM, ERP, centro de contacto, webhooks | Global; sin equipo local confirmado en Colombia |
| Infobip | Operación omnicanal empresarial | CRM, bots, campañas, APIs propias | Servicios para Colombia; acuerdo de nivel de servicio negociable |
| Zenvia | Cercanía regional en Latinoamérica | HubSpot, Salesforce, RD Station, ERPs, webhooks | Soporte regional; exigir disponibilidad por escrito |
| Messangi | Empresas que requieren facturación en pesos colombianos | API oficial, incorporación acompañada | Soporte en español y zona horaria colombiana |
Cómo obtener tus credenciales y autenticar cada llamada
La API de WhatsApp Business Cloud opera sobre graph.facebook.com y requiere tres identificadores: el WABA ID (identificador de tu cuenta de WhatsApp Business), el Phone Number ID (identificador interno de Meta del número registrado, distinto al número en formato internacional) y un token de acceso. Para producción, el token debe generarse desde un usuario del sistema en Meta Business Manager con los permisos whatsapp_business_messaging y whatsapp_business_management. Nunca uses el token temporal de prueba en producción ni lo expongas en repositorios, registros de actividad ni URLs.
El punto de acceso principal para enviar mensajes es POST /{PHONE_NUMBER_ID}/messages, con el token en el encabezado Authorization: Bearer. Una llamada mínima de texto requiere los campos messaging_product, to (número del destinatario en formato internacional sin el signo más), type y el objeto correspondiente al tipo de mensaje. Para enviar plantillas, se agrega el objeto template con el nombre aprobado, el código de idioma y los componentes con variables cuando los tiene.
Pasos para integrar WhatsApp Business API con tu CRM o ERP en Colombia
Los webhooks son el canal por el que WhatsApp envía a tu servidor los mensajes entrantes, los estados de entrega y los errores. Tu punto de recepción debe ser una URL pública con HTTPS que acepte peticiones POST, valide la firma HMAC del cuerpo del mensaje y responda con código 2xx lo antes posible. El procesamiento real debe ejecutarse de forma asíncrona en una cola separada: si el punto de recepción tarda en responder, Meta reintenta la entrega y genera duplicados que debes controlar mediante un identificador único de evento en una tabla con restricción UNIQUE.
Una vez validado y persistido el evento, el proceso de sincronización busca el contacto en el CRM por su número de WhatsApp, lo crea si no existe y registra el mensaje como actividad con una clave de idempotencia estable. Los estados de entrega (enviado, entregado, leído, fallido) deben actualizar el registro existente, no crear uno nuevo. Si tu CRM no permite búsqueda por número de WhatsApp, mantén una tabla local de correspondencias entre el identificador de WhatsApp y el identificador interno del sistema.
Reglas de plantillas y consentimiento para líneas +57
Para iniciar una conversación o escribir después de 24 horas de la última interacción del usuario, solo puedes usar plantillas aprobadas por Meta. Cada plantilla debe usarse para el propósito con el que fue aprobada; Meta puede pausarla o rechazarla si detecta uso indebido. Dentro de la ventana de 24 horas abierta por el usuario, puedes enviar mensajes libres sin plantilla, siempre que sean pertinentes a la conversación en curso.
Las empresas colombianas deben obtener consentimiento explícito antes de enviar cualquier mensaje, registrar quién aceptó, cuándo y para qué tipo de comunicaciones, y ofrecer un mecanismo claro de exclusión. La base de consentimiento debe ser auditable y separar la autorización para mensajes transaccionales y promocionales. La normativa colombiana de protección de datos personales obliga además a publicar el aviso de privacidad e informar el uso de los datos. Los bloqueos y reportes de correo no deseado reducen la calificación de calidad de la cuenta y pueden generar restricciones dinámicas de envío.
Unique EPAD: integración con WhatsApp Business API sin construir desde cero
Si seguiste los pasos anteriores, ya sabes que integrar WhatsApp Business API con los sistemas de una empresa colombiana tiene más capas de las que parece: verificación legal, selección de BSP, credenciales, webhooks, colas, deduplicación y cumplimiento normativo. Unique EPAD, nuestra plataforma empresarial, tiene esta conexión con WhatsApp Business API construida dentro de la plataforma. Eso significa que una empresa colombiana puede automatizar el envío y la recepción de mensajes y ejecutar flujos de comunicación sin necesidad de desarrollar una integración personalizada desde cero; para casos con requisitos muy específicos o ERP de arquitectura cerrada, tu ejecutivo de EPAD puede orientarte sobre el nivel de configuración requerido.
La plataforma también centraliza documentos, formularios, flujos de trabajo y tableros en tiempo real, por lo que el canal de WhatsApp queda conectado directamente con la operación y los datos de tu empresa, no como un sistema paralelo e independiente. Unique EPAD permite automatizar comunicaciones empresariales sin desarrollar una integración personalizada desde cero. Si tu operación necesita además control de inventarios, producción o logística, Core EPAD complementa esta propuesta con una visión integral del ciclo operativo.
Escríbenos para conocer cómo Unique EPAD puede adaptarse a los procesos y sistemas de tu empresa. Cuéntanos el tamaño de tu operación y te preparamos una propuesta concreta.
Preguntas frecuentes
¿Se puede usar un número celular colombiano existente para la API?
Sí, siempre que no esté activo en la aplicación de WhatsApp. Debes desvincularlo antes de registrarlo en la API; de lo contrario, el proceso de verificación del número fallará.
¿Cuánto tarda la verificación de empresa en Meta?
El plazo habitual es de 24 a 48 horas, aunque Meta puede tardar hasta 14 días hábiles si solicita documentos adicionales o realiza una revisión manual. Conviene tener toda la documentación lista y consistente antes de iniciar el trámite para evitar demoras.
¿La insignia azul de WhatsApp es necesaria para usar la API?
No. La insignia azul (Meta Verified) es una suscripción opcional. La verificación empresarial de Meta es un proceso distinto y sí es un requisito para activar la API, pero no implica obtener la insignia.
¿Qué pasa si envío mensajes sin plantilla fuera de la ventana de 24 horas?
La API rechazará el mensaje. Solo las plantillas aprobadas pueden iniciar conversaciones o enviarse fuera de esa ventana de atención. Intentar eludir esta regla afecta la calificación de calidad de la cuenta.
¿Unique EPAD requiere contratar un BSP externo por separado?
La integración con WhatsApp Business API está incluida en la plataforma Unique EPAD. Consulta con tu ejecutivo de EPAD los detalles de implementación y facturación según tu caso específico.
¿Cómo se calcula el costo de mensajes para una línea colombiana?
Meta cobra por cada mensaje entregado según su categoría (mercadeo, utilidad, autenticación o servicio). Según el tarifario oficial de Meta, los primeros 1.000 mensajes de servicio mensuales por número son gratuitos a partir del 1 de octubre de 2026; el resto se factura según la tarifa vigente de Meta para Colombia. A ese costo se suma el cargo del proveedor o plataforma tecnológica que uses.