Saltar a contenido

Integración con Wispro

Integración en desarrollo

La integración nativa con Wispro está pendiente — Wispro todavía no tiene documentación pública de variables ni endpoints API estables que podamos consumir desde HybsChat. Por ahora podés usar el gateway genérico con limitaciones (ver abajo). Cuando Wispro libere docs oficiales, lo agregamos completo.

Estado actual

Feature Estado
Envío de mensajes vía gateway gw.hybschat.com/mw ✅ Funciona como genérico
Catálogo oficial de variables ⏳ Sin docs públicas
Lookup automático de cliente por DNI/teléfono ⏳ Sin API pública confirmada
Bot WhatsApp interactivo ❌ Necesita endpoints API
Reporte de pago / promesa de pago ❌ Necesita endpoints API

Configuración temporal

Si necesitás mandar notificaciones desde Wispro mientras tanto:

  1. En tu panel HybsChat → Configuración → Sistema ISP:

    Campo Valor
    Sistema Wispro
    URL del ISP (vacío hasta que Wispro confirme endpoint)
    Token (vacío)
  2. En tu sistema Wispro, configurá el proveedor de mensajería apuntando a:

    https://gw.hybschat.com/mw?appkey=TU_APPKEY
    
  3. Wispro debe reemplazar sus variables con valores reales antes de mandar a HybsChat (porque no podemos hacer lookup automático).


TPL provisional

Como no hay sintaxis oficial confirmada, podés armar el TPL con valores ya renderizados desde Wispro:

TPL:recordatorio_pago | Juan Pérez | 80.00 | 15/06/2026 | Plan 100 Mbps

Convención provisional

  • Separador: | (pipe), como Mikrowisp y WispHub
  • Primera variable: el nombre del cliente (HybsChat lo usa para registrar el contacto Chatwoot)
  • Resto de variables: los valores que tu template Meta espera en {{1}}, {{2}}, etc.

Variables placeholder (estilo Wispro observado)

Las plantillas Wispro suelen usar [variable] con corchetes — Wispro las reemplaza por valores reales antes de mandar:

Placeholder Wispro Valor renderizado
[nombre] Nombre del cliente
[apellido] Apellido
[importe] Monto
[vencimiento] Fecha de vencimiento
[plan] Plan contratado

Cuando llega a HybsChat, los placeholders ya están reemplazados — el parser HybsChat no toca esos [...].


Ejemplo provisional

Plantilla en Wispro:

TPL:recordatorio_pago | [nombre] [apellido] | [importe] | [vencimiento]

Wispro reemplaza antes de enviar:

TPL:recordatorio_pago | Juan Pérez | 80.00 | 15/06/2026

Body del template Meta:

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


Lo que HybsChat sí hace automáticamente

Aunque no haya integración nativa con Wispro todavía, el parser genérico cubre:

  • Padding automático con . si mandás menos vars que el template Meta requiere
  • Vars vacías intermedias rellenadas con .
  • Template name con - o . aceptados
  • Parser robusto al ~ o | embebido en valores

Roadmap

Cuando Wispro libere documentación oficial:

  1. Agregar el catálogo curado de variables Wispro al panel HybsChat (con sintaxis confirmada)
  2. Implementar wispro_getClientName() para lookup automático por DNI
  3. Si Wispro expone endpoints de factura/pago, sumar Bot WhatsApp con reporte de pago y promesa

Mientras tanto, podés usar la integración genérica para notificaciones unidireccionales. Si tu Wispro tiene API publicada en algún canal privado y querés que la incorporemos, contactá a [email protected].