Canales de mensajería

Módulo del grupo PLATFORM_ADMINISTRATION / Administración de plataforma. Ruta base: /settings/messaging-channels. Identificador de menú: messaging-channels. Disponible con la Conexión WhatsApp (+$99, en cualquier plan) e incluido en el plan Control.

Operación y comportamiento de la pantalla

La pantalla muestra las cuentas conectadas que alimentan Inbox. La conexión con una aplicación de Meta y la desconexión cambian la recepción de mensajes; revisa el canal seleccionado antes de confirmar. La revisión de esta guía no requiere enviar mensajes reales.

Objetivo operativo

Esta pantalla conecta el número de WhatsApp Business del negocio con STE Flux. Una vez conectado, los mensajes que los clientes envían a ese número llegan al inbox de conversaciones, el asistente puede tomar pedidos y las respuestas salen con el número propio del negocio: todo dentro de la plataforma.

Formas de conectar el número

Conectar con Meta (registro embebido)

Cuando la plataforma tiene configurada su app de Meta, el botón Conectar con Meta abre el flujo oficial de Meta: eliges tu cuenta de WhatsApp Business y el número queda registrado sin capturar tokens a mano.

Usar mi propia app de Meta (BYO_APP)

Si el negocio ya tiene una app en Meta for Developers, el formulario pide:

• Phone Number ID y WhatsApp Business Account ID (visibles en el panel de la app).
• App ID y App Secret (para validar la firma de los webhooks).
• Access Token permanente (system user token con permisos whatsapp_business_messaging).

El token y el secreto se guardan cifrados; nunca se muestran después del alta.

Después de registrar, en tu app de Meta configura el webhook con:

• Callback URL: la que muestra la cuenta registrada (botón Copiar).
• Verify token: el token de verificación generado para tu cuenta.
• Suscríbete a los campos messages de whatsapp_business_account.

Qué revisar en cada cuenta

• Estado: Activo, Pendiente, Desconectado o Error.
• Origen: Registro embebido o App propia.
• WABA y Phone Number ID para soporte.
• Desconectar: deja de recibir y enviar mensajes; la conversación histórica se conserva.

Secciones de la cuenta

La cuenta activa reúne sus secciones de configuración. Algunas acciones requieren permisos de administración o ejecución:

• Menú de servicios: las opciones que el asistente ofrece cuando el mensaje del cliente no corresponde a una campaña ni a un pedido.
• Colas de atención: cómo se reparten las conversaciones que escalan a un humano.
• Campañas: el editor de campañas de oferta (OFFER_TO_ORDER).
• Plantillas: el catálogo de plantillas aprobadas por Meta de esa cuenta.
• Conversiones: la configuración de la API de conversiones de Business Messaging (CAPI).

Campañas (OFFER_TO_ORDER)

El editor crea y opera campañas con el preset Oferta a pedido: un journey finito de bienvenida → pasos promocionales → selección de producto → cotización/pedido por el asistente → pasos posteriores al pago.

• Disparadores: cada campaña entra por un origen de referencia (el anuncio click-to-WhatsApp identificado por su sourceId/sourceType) o por un mensaje exacto configurado. Un mensaje exacto abre la campaña sin fabricar atribución de anuncio; solo un referral real de Meta lleva ctwa_clid.
• Pasos del editor: texto, medio (imagen, audio, video o documento del catálogo privado de la cuenta) o plantilla aprobada. Los seguimientos y los pasos posteriores al pago permiten configurar una espera.
• Ciclo de vida: la campaña se edita como borrador, se valida (disparadores únicos entre campañas publicadas de la misma cuenta, contenido requerido por tipo de paso, plantillas aprobadas), se publica y puede deshabilitarse. Cada versión publicada es inmutable: editar crea el siguiente borrador, no reescribe la historia.
• Cancelación: los seguimientos pendientes se cancelan cuando el cliente responde, pide no recibir mensajes, paga, la campaña se deshabilita o un humano toma la conversación.

Plantillas

El catálogo muestra las plantillas sincronizadas de esa cuenta (nombre, idioma, categoría y estado). La sincronización es una acción explícita que consulta la WABA real; las plantillas aprobadas se usan en los pasos de campaña y en el composer del inbox cuando la ventana de 24 horas ya cerró. Plantillas no aprobadas, de otro idioma o de otra cuenta no se pueden enviar.

Conversiones (CAPI)

La sección Conversiones activa el reporte server-side de Purchase a Meta Business Messaging para los pedidos pagados que nacieron de un click-to-WhatsApp:

• Dataset ID de Meta y access token (se captura una sola vez; queda cifrado y nunca se vuelve a mostrar: la pantalla solo indica si hay uno configurado).
• Confirmación de base de procesamiento: el envío es fail-closed, sin dataset, token y confirmación, nada sale a Meta.
• El evento viaja con event_id determinista del pedido y el snapshot congelado de la atribución; los reintentos repiten el mismo event_id y una falla de Meta nunca revierte el pago ni bloquea el pedido.
• Solo pedidos con origen WHATSAPP alimentan esta vía; los pedidos web siguen reportándose por la CAPI del sitio como antes, y un pedido de WhatsApp pagado por link de invitado no se duplica en el sitio.

Cuándo usar esta pantalla

• Para dar de alta el canal por primera vez.
• Para rotar el access token: desconecta la cuenta y regístrala con el token nuevo.
• Para revisar el statusDetail cuando una cuenta queda en Error.
• Para recuperar la URL de callback y el verify token al reconfigurar el webhook en Meta.

Cómo entra en el modelo de negocio

El canal convierte el número de WhatsApp del negocio en una ventana de venta transaccional, no solo un medio de avisos:

• El asistente de pedidos abre el catálogo o la oferta de campaña, permite navegar y buscar productos y arma el carrito con precios reales. Solicita los datos faltantes del cliente antes del cierre y crea la orden con canal WHATSAPP, nombre y teléfono asociados, después de aceptar la cotización vigente.
• La orden cae a la misma bandeja de /orders que las de mostrador y tienda en línea, con el mismo inventario y el mismo motor de precios.
• Los métodos de pago que el asistente ofrece son los que el negocio tiene configurados en Métodos de pago; cada uno define cómo se cobra (referencia en el chat, link de pago o acuerdo manual).
• El catálogo que ve el cliente es el publicado en el canal de venta WhatsApp (ver Canales de venta), incluido el almacén del que descuenta stock.

Prerrequisitos de operación

Para que el asistente venda de punta a punta, el negocio necesita:

1. El canal conectado y en estado Activo (esta pantalla).
2. Un canal de venta WHATSAPP con catálogo publicado y almacén asignado (Canales de venta).
3. Al menos un método de pago activo y operativo (Métodos de pago); si no hay ninguno, el asistente confirma el pedido y deja el cobro al contacto directo.

Notas

• El canal de mensajería completo (inbox + asistente de pedidos) y los avisos de estatus por WhatsApp requieren la Conexión WhatsApp (cualquier plan) o el plan Control. Los avisos dentro de la app y por correo son de la base y no la necesitan.
• Los mensajes entrantes no tienen la restricción de plantilla de la ventana de 24 horas: el asistente responde en texto libre mientras la conversación esté viva.
• El cliente puede pedir que se detengan los mensajes escribiendo alto o stop.