Saltar a contenido

Integración con Wimovil

Integración nativa

HybsChat es proveedor oficial de mensajería WhatsApp en Wimovil. La integración aparece directamente en el panel Wimovil como opción en la lista de proveedores.

Configuración en Wimovil

Configuración en Wimovil

En tu panel Wimovil → Mensajería → Proveedores → HybsChat:

Campo Valor
Appkey (la que ves en tu panel HybsChat)

Eso es todo. Wimovil arma la URL completa internamente.

Cómo funciona (no escribas el TPL a mano)

HybsChat genera el snippet por vos. El flujo es:

  1. Creás la plantilla en Meta (desde el editor de plantillas de HybsChat).
  2. En HybsChat mapeás cada variable {{N}} a la variable Wimovil que le corresponde.
  3. Copiás el snippet que HybsChat te muestra (card "🔌 Conectar tu sistema ISP" o el editor de plantillas).
  4. Lo pegás en tu panel Wimovil.
  5. (Opcional) Activás los checkboxes de Wimovil para los extras (cuentas, total a pagar, etc.).

Copiá, no escribas

El snippet ya viene con el separador correcto, el token de nombre y el comodín en su lugar. Solo copiá y pegá.

Anatomía del snippet

TPL:recordatorio ~ {{{fecha_de_suspension}}} ~ . ~ NOMBRE={{{nombres_y_apellidos_usuario}}}
       │                    │                   │                    │
   nombre del          variable {{1}}        comodín            nombre del contacto
   template            del template        (extras checkbox)    (dato aparte, NO es variable)

Separador: ~ (tilde, no pipe |).

El nombre del cliente: NOMBRE=

Wimovil no tiene API de búsqueda, así que el nombre del cliente viaja dentro del mensaje como un token aparte:

NOMBRE={{{nombres_y_apellidos_usuario}}}

HybsChat lo usa para crear el contacto en Chatwoot con el nombre real.

Es un dato aparte, no una variable de la plantilla

El NOMBRE= no ocupa un {{N}} de tu template Meta. Tu plantilla queda libre — podés saludar por nombre (Hola {{1}}) o no, es independiente.

  • HybsChat agrega NOMBRE= al snippet automáticamente si tenés activado el switch "Nombre del cliente en los contactos" (card Configuración del sistema ISP).
  • Si lo desactivás, el contacto queda como Cliente +51... (sin nombre).

El comodín . (para los extras de Wimovil)

Wimovil tiene checkboxes en su panel que agregan contenido automático al final del mensaje:

  • ☑️ Enviar total a pagar
  • ☑️ Enviar cuentas bancarias
  • ☑️ Enviar día de pago
  • ☑️ Enviar próxima fecha de suspensión

Ese contenido es variable (depende de qué checkboxes prendas). El comodín . es una variable reservada en tu plantilla que absorbe todo ese extra en un solo lugar.

Las reglas del comodín

  1. Es opcional: solo lo necesitás si querés los extras de los checkboxes.
  2. Va como la última variable de tu plantilla Meta.
  3. HybsChat lo pone solo: si dejás una variable sin mapear en HybsChat, el snippet la muestra como . automáticamente.
  4. Tenés que activar el checkbox en Wimovil para que el contenido aparezca.

Cuentas bancarias y total: van por checkbox, no por variable inline

En Wimovil las cuentas bancarias y el total suelen venir por checkbox (contenido extra), no como variable inline. Por eso, para que aparezcan:

  • Dejá la última variable como comodín . (sin mapear en HybsChat), y
  • Activá el checkbox correspondiente en tu panel Wimovil.

El comodín absorbe ese contenido en el {{N}} de tu plantilla.

Cómo diseñar el body del template Meta

Si usás el comodín, reservá la última {{N}} para él y diseñá la frase para que cierre natural.

Body en Meta: 

Hola, tu servicio vence el *{{1}}*.
{{2}}
Atte. Tu ISP.
{{1}} = fecha (variable mapeada) · {{2}} = comodín (cuentas, total, etc.)

Con los checkboxes prendidos, el cliente ve: 

Hola, tu servicio vence el *7*.
Total a pagar: S/60.00. BCP / Cta: 192-... / Titular: TU ISP
Atte. Tu ISP.

Si mapeás todas tus variables con valores reales y no usás checkboxes, no necesitás comodín: 

TPL:bienvenida ~ {{{razon_social_empresa}}} ~ NOMBRE={{{nombres_y_apellidos_usuario}}}

Por qué el contenido extra se ve en una sola línea

Meta no permite saltos de línea dentro de una variable. Por eso el comodín junta todos los extras de Wimovil en una línea, separados por /. Es una limitación de Meta, no de HybsChat.

Variables disponibles

Wimovil usa sintaxis {{{variable}}} (triple llave). Tu panel Wimovil reemplaza el valor real antes de enviarlo a HybsChat.

Variable Descripción
{{{primer_nombre_usuario}}} Primer nombre del cliente
{{{nombre_usuario}}} Nombres del cliente
{{{apellido_paterno_usuario}}} Apellido paterno
{{{apellido_materno_usuario}}} Apellido materno
{{{nombres_y_apellidos_usuario}}} Nombre completo — se usa en el token NOMBRE= para nombrar el contacto
{{{tipo_de_documento_usuario}}} Tipo de documento (DNI, RUC, etc.)
{{{numero_de_documento_usuario}}} Número del documento
Variable Descripción
{{{ruc_empresa}}} RUC del ISP
{{{razon_social_empresa}}} Razón social
{{{direccion_empresa}}} Dirección
{{{telefono_principal}}} · {{{telefono_segundario}}} Teléfonos empresa
{{{correo_principal}}} Email empresa
{{{telefono_ventas_principal}}} · {{{telefono_ventas_segundario}}} Teléfonos ventas
{{{correo_ventas_principal}}} Email ventas
{{{telefono_soporte_tecnico_principal}}} · {{{telefono_soporte_tecnico_segundario}}} Teléfonos soporte
{{{correo_soporte_principal}}} Email soporte
Variable Descripción
{{{fecha_de_pago}}} Fecha límite de pago
{{{fecha_de_suspension}}} Fecha de suspensión por mora
{{{total_a_pagar}}} Monto pendiente (sin currency — agregalo en el body Meta: S/{{N}})
{{{cuentas_bancarias}}} Cuentas bancarias / medios de pago
{{{link_comprobante}}} Link de pago o comprobante

¿Inline o por checkbox?

Algunas variables (cuentas, total, día de pago) Wimovil las ofrece también como checkbox. Si la variable inline te llega vacía, usá el comodín + checkbox (ver arriba).

Ejemplos por caso de uso

Snippet (copialo del dashboard): 

TPL:recordatorio_pago ~ {{{fecha_de_suspension}}} ~ . ~ NOMBRE={{{nombres_y_apellidos_usuario}}}
El . es el comodín. En Wimovil prendé los checkboxes (total, cuentas, etc.).

Body Meta: 

Tu servicio vence el *{{1}}*.
{{2}}
Atte. Tu ISP.

Cliente ve: 

Tu servicio vence el *7 de junio*.
Total a pagar: S/60.00 / BCP: 192-... / YAPE: 989...
Atte. Tu ISP.

Snippet: 

TPL:confirmacion_pago ~ {{{total_a_pagar}}} ~ NOMBRE={{{nombres_y_apellidos_usuario}}}

Body Meta: 

Recibimos tu pago de *S/{{1}}*. ¡Gracias!

Cliente ve: 

Recibimos tu pago de *S/150.00*. ¡Gracias!

Snippet: 

TPL:bienvenida ~ {{{razon_social_empresa}}} ~ NOMBRE={{{nombres_y_apellidos_usuario}}}

Body Meta: 

¡Bienvenido a *{{1}}*! Gracias por confiar en nosotros.

Lo que HybsChat maneja automáticamente

Situación Qué hace HybsChat
El nombre del contacto Lo toma del token NOMBRE= y crea el contacto con el nombre real (no +51...)
Variable sin mapear La pone como comodín . en el snippet, lista para absorber los extras de Wimovil
Wimovil agrega extras por checkbox El comodín los absorbe. Si por algún motivo no hay comodín, HybsChat los anexa a la última variable para que no se pierdan
Variable vacía o faltante Se rellena con . antes de enviar a Meta (Meta rechaza variables vacías)
Saltos de línea / tabs en una variable Se aplanan a espacios (Meta los rechaza con error 132018)
Una variable contiene \| El parser respeta el separador ~, no se rompe
Editaste la plantilla en Meta HybsChat usa siempre la versión más reciente de Meta (no una cacheada vieja)
Nombre del template con - o . Soportado

Limitaciones conocidas

Bot WhatsApp no disponible para Wimovil todavía

El bot interactivo (identificación por DNI, reportar pago con comprobante, derivación a equipos) no funciona con Wimovil porque requiere endpoints API que Wimovil no expone públicamente (búsqueda de cliente, reporte de pago, promesa de pago). Cuando Wimovil los libere, lo agregaremos.

Sin búsqueda automática por DNI

Como Wimovil no tiene API pública, el token NOMBRE= es la única forma de que el contacto Chatwoot quede con nombre real. HybsChat lo agrega al snippet automáticamente — no lo borres.

Troubleshooting

El contacto en Chatwoot quedó como '+51999...' sin nombre

Verificá que el snippet incluya NOMBRE={{{nombres_y_apellidos_usuario}}} al final (HybsChat lo agrega solo si el switch "Nombre del cliente en los contactos" está activado en la card Configuración del sistema ISP). Si lo desactivaste, los contactos quedan sin nombre.

Las cuentas bancarias / el total no aparecen en el mensaje

Dos cosas tienen que estar:

  1. La última variable del template debe ser el comodín . (dejala sin mapear en HybsChat → el snippet la pone sola).
  2. Activá el checkbox correspondiente en tu panel Wimovil ("Enviar cuentas bancarias", "Enviar total a pagar", etc.).

Si solo está una de las dos, ese contenido no se envía.

Una variable muestra un valor raro (ej. solo un número en vez de la fecha completa)

Eso es lo que Wimovil está mandando para esa variable. HybsChat reenvía el valor tal cual llega. Revisá en tu panel Wimovil qué valor real produce esa variable.

Meta responde 132xxx 'missing parameter'

Tu template Meta tiene más {{N}} que las variables que mandás. HybsChat completa con . las faltantes automáticamente — verificá que estás usando el snippet generado por el dashboard (no uno viejo escrito a mano).

Editaste la plantilla en Meta pero sigue saliendo la versión vieja

HybsChat ya usa siempre la versión más reciente de Meta. Si editaste la plantilla (cambiaste variables), regenerá y copiá el snippet de nuevo desde HybsChat, porque la cantidad de variables pudo cambiar.

Próximas funciones para Wimovil

Cuando Wimovil libere endpoints API públicos, podremos agregar: búsqueda de cliente por DNI desde el bot, reporte de pago con comprobante, promesa de pago automática y activación/suspensión del servicio desde HybsChat.

Por ahora Wimovil cubre el flujo unidireccional (ISP → cliente con notificaciones por TPL), que es lo principal para cobranza y comunicación masiva.