Saltar a contenido

Integración con Mikrowisp

Integración completa

Mikrowisp soporta el flujo bidireccional: notificaciones ISP → cliente final por TPL y Bot WhatsApp para que el cliente reporte pagos, consulte saldo y se identifique por DNI.

Configuración en HybsChat

En tu panel my.hybschat.com → Configuración → Sistema ISP:

Campo Valor
Sistema Mikrowisp
URL del ISP tu-panel.com (sin http:// ni https://)
Token El token de API de tu Mikrowisp

Configuración en Mikrowisp

Configuración en Mikrowisp

En tu panel Mikrowisp, configurá el proveedor de mensajería:

Campo Valor
URL del webhook https://gw.hybschat.com/mw?appkey=TU_APPKEY
Método POST

Reemplazá TU_APPKEY por la que ves en tu panel HybsChat → pestaña Configuración.

Cómo armar un TPL correctamente

Una sola regla para todos tus templates:

TPL:nombre_template | {nombre_cliente} | {otra_var} | ...

Las 3 reglas que tenés que recordar

  1. Separador: | (pipe)
  2. Nombre del cliente: incluí {nombre_cliente} para que HybsChat lo registre en Chatwoot
  3. CEDULA opcional: si querés que HybsChat busque al cliente por DNI en tu Mikrowisp y autocomplete el contacto, agregá | CEDULA={numero_documento} al final del TPL

Cómo funciona el lookup por cédula

Mikrowisp expone una API para buscar clientes por DNI. Cuando HybsChat recibe CEDULA=12345678:

  1. Llama a tu API Mikrowisp con esa cédula
  2. Obtiene el nombre completo del cliente
  3. Crea/actualiza el contacto Chatwoot con ese nombre
  4. Procesa el resto del TPL normalmente

Si no incluís CEDULA=, HybsChat usa la primera variable como nombre del contacto.

Variables disponibles

Mikrowisp usa sintaxis {variable} (una llave). Las oficiales:

Variable Descripción
{nombre_cliente} Nombre completo del cliente
{id_cliente} ID interno del cliente
{codigo_cliente} Código del cliente
{deuda_cliente} Deuda total acumulada
{campo_cliente} Reemplazá campo por el nombre del custom field (ej. {email_cliente}, {ip_cliente})
Variable Descripción
{nfactura} Número de factura
{total} Monto de la factura
{vencimiento} Fecha de vencimiento
{corte} Fecha de corte programado
Variable Descripción
{transaccion} Número de transacción de pago
{fpago} Forma de pago (efectivo, transferencia, etc.)
{fecha} Fecha del pago
Variable Descripción
{servicios} Lista de servicios contratados
{nombre_emisor} / {ip_emisor} Nombre/IP del emisor de red
{nombre_nodo} / {ip_nodo} Nombre/IP del nodo

Referencia oficial Mikrowisp

docs.mikrosystem.net/docs/tags-mikrowisp — listado completo con descripciones.

Ejemplos por caso de uso

TPL en Mikrowisp: 

TPL:recordatorio_pago | {nombre_cliente} | {total} | {vencimiento} | CEDULA={ci_cliente}

Body del template Meta: 

Hola *{{1}}*, tu factura de *S/{{2}}* vence el *{{3}}*.

Cliente ve: 

Hola *Juan Pérez*, tu factura de *S/80.00* vence el *2026-06-05*.

TPL en Mikrowisp: 

TPL:aviso_corte | {nombre_cliente} | {corte} | {total} | CEDULA={ci_cliente}

Body del template Meta: 

Hola *{{1}}*, tu servicio se corta el *{{2}}* por un saldo de *S/{{3}}*. Regularizá para evitar el corte.

TPL en Mikrowisp: 

TPL:confirmacion_pago | {nombre_cliente} | {total} | {transaccion}

Body del template Meta: 

Hola *{{1}}*, recibimos tu pago de *S/{{2}}*. Comprobante: {{3}}. ¡Gracias!

TPL en Mikrowisp: 

TPL:bienvenida | {nombre_cliente} | {servicios}

Body del template Meta: 

Hola *{{1}}*, gracias por contratar *{{2}}*. ¡Te damos la bienvenida!

Bot WhatsApp interactivo

Si activás el addon Bot WhatsApp ($15/mes), tus clientes pueden:

  • Identificarse por DNI desde un menú interactivo
  • Consultar su saldo y factura pendiente
  • Reportar pago subiendo una foto del comprobante
  • Promesa de pago automática que extiende el servicio por N días mientras un humano valida
  • Derivar a un asesor humano por equipo (cobranza/soporte/ventas)

El bot usa tu API Mikrowisp para findClientByDni, getCurrentInvoice, reportPayment y createPaymentPromise (acción PromesaPago del API Mikrowisp, NO PaidInvoice automático — eso requiere validación manual por seguridad).

Activá el bot desde tu panel HybsChat → pestaña Bot WhatsApp. Configuración detallada en Manual del CRM → Bot WhatsApp.

Lo que HybsChat maneja automáticamente

Situación Qué hace HybsChat
Mandás menos vars que el template Meta requiere Padding automático: completa con .
Mandás una variable vacía en el medio Se rellena con . antes de enviar a Meta
Mandás CEDULA= al final Lookup automático del nombre del cliente vía API Mikrowisp
Una variable contiene ~ (raro pero posible) El parser respeta el separador \|, no se rompe
Nombre del template tiene - o . Soportado

Troubleshooting

Meta responde 132xxx 'missing parameter'

El template Meta tiene más {{N}} que las variables que mandás. Soluciones:

  1. HybsChat agrega padding automático — verificá que tu instancia esté actualizada
  2. Reducí los placeholders del body Meta a los que efectivamente vas a usar
  3. Agregá las variables faltantes en el TPL
El cliente aparece en Chatwoot como '+51999...' sin nombre

Asegurate de incluir {nombre_cliente} como primera variable, o agregá CEDULA={ci_cliente} al final para que HybsChat busque el nombre vía API.

El lookup por CEDULA no encuentra al cliente

Verificá:

  1. La cédula coincide exactamente con la guardada en Mikrowisp
  2. El token de API Mikrowisp en HybsChat tiene permisos de lectura sobre clientes
  3. La URL del ISP está sin http:// ni https:// ni / final
El comprobante de pago del bot no se sube a Mikrowisp

Mikrowisp deprecó el endpoint legacy de NewTicket con adjunto. Ahora el bot solo crea promesa de pago (PromesaPago API). El comprobante queda guardado en Chatwoot para que el agente lo valide manualmente.

Una variable custom no se reemplaza

Para campos custom de Mikrowisp usá {campo_cliente} reemplazando campo por el nombre exacto del custom field. Verificá en Mikrowisp el nombre exacto (case-sensitive en algunos casos).