Integración oficial con la WhatsApp Business Platform (Cloud API)

Esta página explica de forma abierta cómo se conecta OPTIMA Omnicanal con Meta, qué permisos solicitamos y cómo tratamos la información. Está pensada para clientes, usuarios finales y para los procesos de verificación de Meta (App Review).

☁️ Cloud API oficial 🔐 Embedded Signup 🔄 Webhooks 📡 Meta Conversions API

Cómo fluye un mensaje dentro de OPTIMA

OPTIMA es un proveedor tecnológico que se integra exclusivamente mediante las APIs oficiales de Meta. El cifrado extremo a extremo de WhatsApp se mantiene entre el usuario y WhatsApp; OPTIMA recibe los mensajes que el usuario envía al comercio a través de la Cloud API, bajo la instrucción del propio comercio.

Ruta de un mensaje
01 El usuario escribe al negocio por WhatsApp Mensaje enviado
02 WhatsApp Business Platform (Cloud API) de Meta Entrega a la app autorizada
03 OPTIMA Omnicanal (webhooks + bandeja + IA) Procesado por instrucción del comercio
04 Respuesta al usuario / evento de conversión a Meta CAPI Ciclo completado ✓
🛡️

Integración 100 % oficial. OPTIMA no utiliza automatizaciones no oficiales, ni modificaciones del cliente de WhatsApp, ni técnicas de scraping, ni números virtuales no autorizados. Toda la mensajería opera sobre la WhatsApp Business Platform contratada por cada comercio.

Conexión del negocio mediante Embedded Signup

Cada comercio conecta su propio número de WhatsApp y su propia Meta Business Portfolio a través del flujo oficial de Embedded Signup de Meta. El comercio conserva en todo momento la propiedad de su número, de su cartera de negocios y de sus plantillas.

  1. Inicio desde el panel de OPTIMA

    El administrador del comercio inicia la conexión y Meta despliega la ventana oficial de Embedded Signup.

  2. Inicio de sesión con Facebook Business

    El comercio inicia sesión con el perfil administrador de su Meta Business Portfolio.

  3. Autorización de permisos

    Meta muestra los permisos que OPTIMA solicita (ver tabla siguiente). El comercio los aprueba de forma expresa.

  4. Registro del número de WhatsApp

    Se selecciona o registra el número del comercio. Si el número estaba conectado a otra plataforma, debe desvincularse primero.

  5. Conexión activa

    El número queda operativo en la bandeja de OPTIMA: mensajes entrantes por webhooks y salidas vía Cloud API.

Permisos que solicitamos y para qué

Solicitamos únicamente los permisos necesarios para operar el servicio contratado por el comercio. Ningún permiso se usa para fines publicitarios propios.

Permiso / capacidadTipoPara qué se utiliza
whatsapp_business_messagingMessagingEnviar y recibir los mensajes de WhatsApp del comercio conectado, y recibir notificaciones (webhooks) de entrega y lectura.
whatsapp_business_managementManagementGestionar plantillas de mensaje, el perfil de WhatsApp Business y la configuración del número del comercio.
business_managementBusinessAcceso de administración básico a la Meta Business Portfolio durante el Embedded Signup y la operación autorizada.
ads_management / datos de Ads (opcional)Opt-inSolo si el comercio contrata el módulo de optimización de pauta, para leer el desempeño de sus campañas y mejorar la atribución con CAPI.
🔎

Los tokens de acceso del comercio se almacenan cifrados, se usan exclusivamente para prestar el servicio y se revocan cuando el comercio desvincula su cuenta. Ver la Política de Privacidad.

Meta Conversions API (CAPI) — señal server-to-server

Cuando el comercio lo contrata, OPTIMA envía eventos de conversión (p. ej. Purchase, Lead) directamente desde nuestros servidores a Meta, sin depender únicamente del navegador ni de cookies de terceros.

  • Deduplicación con event_id: cada evento lleva un identificador único que permite a Meta eliminar duplicados entre el píxel del navegador y el evento server-side.
  • Datos mínimos: se envían los campos necesarios según las políticas de eventos de Meta (evento, valor, moneda e identificadores anonimizados conforme a la norma de Meta).
  • Instrucción del comercio: los eventos se envían por cuenta y orden del comercio responsable del tratamiento, en cumplimiento de la Política de Privacidad y los Términos del Servicio.
  • Sin listas de contacto ajenas: nunca enviamos audiencias de usuarios que no interactuaron con el comercio cliente.

Cómo protegemos la conexión

🔐

Tokens cifrados

Las credenciales del comercio se guardan cifradas en reposo y jamás se exponen en el navegador ni en registros públicos.

🌐

Transporte TLS

Toda comunicación entre Meta, OPTIMA y el comercio viaja cifrada en tránsito (HTTPS/TLS).

✍️

Webhooks verificados

Las notificaciones de Meta se validan mediante firma antes de procesarse; los eventos rechazados quedan registrados.

👥

Acceso por roles

Cada usuario del comercio tiene rol propio (administrador, supervisor, agente) con trazabilidad de acciones y opción de revocación inmediata.

Qué NO hacemos — en blanco y negro

🚫

Prácticas que OPTIMA rechaza de forma absoluta:

  • Automatizar cuentas personales de WhatsApp o clientes no oficiales (WhatsApp modificado, apps de terceros no autorizadas).
  • Enviar mensajes masivos sin el consentimiento (opt-in) previo del destinatario, ni facilitar spam a nuestros clientes.
  • Vender, alquilar o compartir bases de datos de usuarios finales con terceros con fines publicitarios.
  • Usar los datos de las conversaciones de un comercio para entrenar servicios para terceros sin su autorización.
  • Solicitar a usuarios finales contraseñas, códigos de verificación o credenciales de sus cuentas Meta o bancarias.
⚖️

El incumplimiento de estas reglas por parte de un cliente puede implicar la suspensión del servicio, conforme a los Términos del Servicio B2B y las políticas de Meta.

Dudas técnicas comunes

El cifrado extremo a extremo de WhatsApp aplica entre el usuario y WhatsApp. La Cloud API es el mecanismo oficial que Meta provee para que empresas y proveedores tecnológicos como OPTIMA reciban y respondan los mensajes del negocio; así lo diseñó Meta para este propósito.
Del comercio. OPTIMA nunca toma propiedad del número ni de la Meta Business Portfolio: opera sobre ellos con los permisos que el comercio autoriza mediante Embedded Signup, y el comercio puede desvincularse en cualquier momento.
Un número de WhatsApp Business solo puede estar registrado en una plataforma a la vez. Antes del Embedded Signup debe desvincularse del proveedor anterior (desde su panel o solicitándolo a ese proveedor) y luego conectarse en OPTIMA. Nuestro equipo acompaña el proceso.
En la Política de Privacidad y en la Política de Tratamiento de Datos Personales (Ley 1581 de 2012). Si deseas ejercer tus derechos o eliminar tus datos, usa la página de Eliminación de Datos.

Conecta tu operación con la vía oficial

Nuestro equipo técnico acompaña el Embedded Signup de principio a fin y deja tu integración lista para operar y para superar las verificaciones de Meta.