Cobros del bot: links de pago y comprobantes¶
El bot de HybsChat puede ayudarte a cobrar de dos formas distintas e independientes:
- Links de pago (pasarelas). El bot genera un link por el monto exacto de la deuda del cliente. Cuando el cliente paga, el sistema reactiva el servicio y notifica al cliente por WhatsApp.
- Comprobantes con OCR (Yape / Plin / transferencia). Si el cliente paga por su cuenta y manda la foto del comprobante, el bot lo lee con inteligencia artificial, valida que sea legítimo y le da un margen de días al servicio mientras una persona confirma el pago.
Las dos formas son independientes
Tú decides qué activar: solo links, solo comprobantes, ambas o ninguna. Esto vale tanto en modo Flujos como en modo IA. No hace falta tener pasarela para aceptar comprobantes, ni viceversa.
El bot solo ofrece lo que configuraste
El bot nunca ofrece un método de cobro que no tengas activo. Si no cargaste una pasarela, no menciona links de pago; si no cargaste tus cuentas de Yape/Plin, no pide comprobantes. Así el cliente nunca recibe una opción que no funciona.
Funciona en la moneda de tu país
HybsChat atiende a ISPs de varios países. Los montos (deuda, tope de comprobantes, confirmaciones) se muestran en la moneda de tus clientes según el país configurado — soles (S/) en Perú, y el símbolo correspondiente en cada país (por ejemplo $ en la mayoría de LatAm, Bs en Bolivia). No hace falta que configures nada: se deriva del código de país de tus clientes.
1. Links de pago con pasarela¶
El bot crea una orden de pago por el saldo del cliente y le envía un link por WhatsApp. El cliente lo abre, paga, y el bot se encarga del resto.
Pasarelas soportadas¶
| Pasarela | Métodos de pago | Notas |
|---|---|---|
| Izipay | Tarjeta Visa / Mastercard y otros | Pasarela histórica. El cliente ve un formulario seguro de Izipay. |
| Culqi | Yape nativo, tarjeta, banca móvil, billeteras | Recomendada si tus clientes pagan con Yape. Muestra un checkout con Yape como método principal. |
Culqi para Yape
Si la mayoría de tus clientes paga con Yape, Culqi es la mejor opción: el cliente paga con Yape directamente desde el link, sin salir de su teléfono.
Cómo configurarla¶
- Entra al dashboard y abre el tab Cobros.
- Elige la pasarela (Izipay o Culqi) y carga tus credenciales (las que te entrega la pasarela).
- Usa el botón Probar para verificar que las credenciales funcionan antes de activar.
- Marca la pasarela como activa. Si tienes más de una, define cuál es la predeterminada.
Las credenciales son tuyas
El dinero de los pagos va directo a tu cuenta de Izipay o Culqi. HybsChat no toca ese dinero ni guarda los datos bancarios del cliente: solo genera el link y confirma cuándo se pagó.
Cómo se usa en el bot¶
- Modo Flujos: agrega el bloque "Generar link de pago" en el punto del flujo donde quieras ofrecer el cobro.
- Modo IA: activa el switch "Ofrecer link de pago". El bot ofrecerá el link cuando detecte que el cliente quiere pagar.
Qué pasa cuando el cliente paga¶
- El bot genera el link por el monto exacto de la deuda (no por un valor fijo).
- El cliente abre el link y paga (con Yape, tarjeta, etc.).
- La pasarela confirma el pago a HybsChat.
- El sistema reporta el pago al ISP (Mikrowisp / WispHub) para reactivar el servicio y le manda al cliente un WhatsApp de confirmación con la fecha hasta la que queda activo.
Idempotencia y links que no se duplican
Si el cliente vuelve a pedir el link por la misma factura y todavía hay uno vigente, el bot reusa el mismo link en vez de crear otro. Cada link tiene un vencimiento (unos 30 minutos); pasado ese tiempo, se genera uno nuevo cuando el cliente lo pida.
2. Comprobantes con OCR (Yape / Plin / transferencia)¶
Muchos clientes pagan por su cuenta con Yape, Plin o transferencia, y después mandan la captura. Con el OCR activado, el bot lee esa imagen con IA (visión de OpenAI), extrae los datos y los valida automáticamente.
El bot NUNCA marca la factura como pagada por su cuenta
Cuando un comprobante pasa las validaciones, el bot no da el pago por cobrado. Lo que hace es crear una promesa de pago (extiende el servicio unos días) y dejar el comprobante registrado para que una persona del equipo lo confirme contra el banco. Esto te protege de comprobantes falsos o editados.
Requisito: aceptar los términos del OCR¶
Para activar esta función tienes que aceptar los términos del OCR en la configuración del bot. Mientras no los aceptes, el bot no validará comprobantes automáticamente (ni en Flujos ni en IA).
Las 4 validaciones anti-fraude¶
Antes de aceptar un comprobante, el bot revisa cuatro cosas. Si cualquiera falla, el comprobante no se valida solo y queda para revisión manual:
| # | Validación | Qué revisa |
|---|---|---|
| 1 | Tope de monto | El monto del comprobante no puede superar un máximo configurable (por defecto 150 en la moneda de tu país). Montos altos siempre van a revisión humana. |
| 2 | Remitente | El nombre de quien paga en el comprobante debe parecerse al nombre del cliente identificado (coincidencia aproximada ≥ 60 %). |
| 3 | Destinatario | El destinatario del comprobante debe coincidir con alguna de tus cuentas de pago configuradas (por nombre del titular o por número de cuenta). |
| 4 | Número de operación | El número de operación tiene que tener un formato válido de Yape/Plin o banca. |
Además, el bot revisa que el monto coincida con la deuda y que el número de operación no se haya usado antes (anti-duplicación): un mismo comprobante no sirve dos veces.
Configura tus cuentas de pago
Para que la validación del destinatario funcione, carga en la configuración del bot tus formas de pago (titular y número de Yape/Plin/cuenta). Sin esas cuentas configuradas, el bot no puede confirmar que el dinero te llegó a ti.
Cómo se usa en el bot¶
- Modo Flujos: usa el bloque "Pedir comprobante" en el flujo.
- Modo IA: activa el switch "Aceptar comprobantes". El bot pedirá y leerá la foto cuando el cliente diga que ya pagó.
3. La promesa de pago¶
Cuando un comprobante pasa todas las validaciones (o cuando se confirma un pago por pasarela), el bot crea una promesa de pago: extiende el servicio del cliente por una cantidad de días que tú defines (de 1 a 20, por defecto 3). Así el cliente recupera el servicio al instante mientras tú confirmas el pago con calma.
Mikrowisp y WispHub se comportan distinto
El resultado depende de tu sistema ISP:
- WispHub: la promesa registra y reactiva el servicio al instante (acción "registrar promesa y activar servicio").
- Mikrowisp: registra la promesa de pago según cómo tengas configurado el comportamiento de promesas en tu Mikrowisp.
En ambos casos, el comprobante queda guardado para que un agente confirme el pago real más tarde. La promesa es reversible: si el pago resulta falso, el agente puede no confirmarlo.
Resumen: qué activar¶
| Quiero que el bot... | Activa | Necesitas configurar |
|---|---|---|
| Cobre con link de pago | Bloque "Generar link" (Flujos) o switch "Ofrecer link de pago" (IA) | Pasarela en el tab Cobros (Izipay o Culqi) |
| Lea comprobantes de Yape/Plin | Bloque "Pedir comprobante" (Flujos) o switch "Aceptar comprobantes" (IA) | Aceptar términos del OCR + cargar tus cuentas de pago |
| Ambas | Las dos cosas a la vez | Pasarela y términos OCR + cuentas |
| Ninguna | Deja ambas desactivadas | El bot solo conversa, sin cobrar |
Problemas frecuentes¶
El bot no genera el link de pago
Lo más común es que no haya una pasarela activa para tu cuenta. Ve al tab Cobros y verifica que tengas Izipay o Culqi activa y, si tienes varias, marcada como predeterminada. Usa Probar para confirmar que las credenciales son válidas: si la prueba da "credenciales inválidas", vuelve a cargarlas desde el panel de tu pasarela.
El cliente abrió el link y dice 'configuración pendiente' o 'link inválido'
Falta cargar la clave pública de la pasarela en el tab Cobros, o el link expiró (cada link vive unos 30 minutos). Pídele al cliente que vuelva a solicitar el cobro para generar uno nuevo, y revisa que las credenciales estén completas.
El comprobante no se validó automáticamente
Es el comportamiento esperado cuando falla alguna de las 4 validaciones. Las causas más comunes:
- El monto supera el tope configurado (por defecto 150 en tu moneda) → va a revisión humana.
- El nombre del remitente no se parece al del cliente.
- El destinatario no coincide con tus cuentas de pago → revisa que tengas tus cuentas (Yape/Plin/banco) cargadas en la configuración del bot.
- El número de operación ya se usó antes, o no tiene un formato reconocible.
En todos estos casos el comprobante no se pierde: queda registrado para que un agente lo confirme manualmente.
El comprobante se validó pero el servicio no se reactivó (WispHub)
En WispHub, registrar promesas requiere el permiso "Promesas de Pago" en el rol del token API que cargaste. Si ese permiso falta, la promesa devuelve un error de permiso (HTTP 403) y el servicio no se reactiva. Revisa los permisos del token API en tu panel de WispHub.
El bot acepta comprobantes pero no hace nada con ellos
Verifica que hayas aceptado los términos del OCR. Sin ese paso, la validación automática queda desactivada aunque el switch de comprobantes esté encendido. En modo IA, además, revisa que el modo esté en "reportar" y no en "solo chat".