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.
Prórroga cuando el cliente la pide¶
Hasta acá la prórroga nace de un comprobante. Pero el caso más común es otro: el cliente escribe «no puedo pagar hoy, dame unos días». Si activas esta opción, el bot puede otorgarla sin comprobante.
Antes de darla verifica tres cosas, y si alguna falla deriva a un asesor en vez de improvisar:
- Que el cliente tenga deuda real (si está al día, no hay nada que prorrogar).
- Que no tenga ya una prórroga corriendo.
- Que le quede cupo, según el tope que definas abajo.
El bot no promete de palabra
Solo confirma la fecha que su sistema devolvió. Si la prórroga no se pudo registrar, se lo dice al cliente y lo pasa a un asesor. Antes, sin esta función, el bot tendía a responder «te damos unos días» sin registrar nada: el cliente quedaba tranquilo y el corte le llegaba igual.
Cuántas prórrogas por cliente¶
Una prórroga mantiene el servicio activo sin haber cobrado. Sin un límite, el cliente que aprende el camino pide una cada semana y no paga nunca.
| Campo | Qué hace |
|---|---|
| Máximo por cliente | Cuántas prórrogas puede tener cada cliente en la ventana. 0 = sin tope (el comportamiento de siempre). |
| Cada (días) | La ventana sobre la que se cuenta. 30 = «N por mes». |
Al llegar al tope, el bot se lo explica al cliente con la fecha en que vuelve a tener cupo y lo deriva a un asesor. El tope frena al bot, no a tus agentes: una prórroga otorgada desde el panel se registra igual pero nunca se bloquea, porque ahí decide una persona.
Las dos vías son independientes
Puedes tener la prórroga por comprobante y no la que se pide, o al revés. Incluso si eliges «solo dejar el comprobante en el chat» —sin reportar el pago a tu sistema— el bot puede seguir dando prórrogas: no acredita el pago, solo corre la fecha de corte mientras tu asesor lo valida.
4. La pestaña Comprobantes: qué recibiste y qué decidió el bot¶
Todo comprobante que llega por WhatsApp queda registrado. En tu panel, pestaña Comprobantes, ves los últimos 90 días:
- Cuántos se aprobaron y cuánto dinero suman.
- Cuántos se rechazaron y por qué, explicado en palabras: monto distinto, pagó a otra cuenta, no se pudo leer la imagen, comprobante viejo, sin factura pendiente, número de operación repetido…
- El número de operación, el banco, el monto detectado y a qué factura correspondía.
Mira la captura antes de decidir¶
Cada fila trae la miniatura del comprobante: un clic y la ves en grande. Al lado, el enlace 💬 ver la conversación te lleva al chat donde llegó, por si necesitas el contexto.
Los comprobantes anteriores al 22 de agosto de 2026
Las capturas se empezaron a guardar en esa fecha. Los más viejos aparecen sin miniatura; para esos, usa el enlace a la conversación.
Aprobar un comprobante que el bot rechazó¶
El bot rechaza por reglas, y a veces la regla no aplica: pagó un familiar, el cliente pagó en una bodega que hace de agente, o la foto salió recortada. Cuando revisas y ves que el pago es real, el botón «Aprobar igual» hace tres cosas:
- Registra el pago en tu sistema (Mikrowisp, WispHub o Wispro), con la imagen como respaldo.
- Extiende el servicio los días que tengas configurados, para que el cliente vuelva a navegar mientras acreditas el pago definitivo.
- Le avisa al cliente por WhatsApp, en la misma conversación.
Si ya lo cargaste a mano en tu sistema
Aprobarlo acá lo registraría dos veces. En ese caso, cárgalo solo en un lado.
Lo que decidió el bot no se borra
El rechazo del OCR queda tal cual, y aparte se guarda que tú lo aprobaste, cuándo y con qué cuenta. Así el historial no miente sobre quién decidió qué.
El aviso al cliente puede no salir
WhatsApp solo deja escribirle libremente dentro de las 24 horas siguientes a su último mensaje. Si pasó más tiempo, el panel te lo dice para que lo contactes tú.
5. Conciliar con tu banco¶
Una foto no es un depósito. El OCR valida que el comprobante se vea legítimo, pero no puede saber si el dinero entró de verdad: la imagen pudo editarse, el pago pudo revertirse, o el número de operación pudo pertenecer a otra transacción.
Para cerrar esa brecha, en la misma pestaña Comprobantes puedes subir tu estado de cuenta y compararlo:
Qué archivo subir¶
| Formato | Cómo obtenerlo |
|---|---|
| CSV | Es el más confiable. Casi toda la banca por internet ofrece «Descargar / Exportar movimientos». |
Excel (.xlsx) |
También sirve; se lee la primera hoja. |
| Sirve si es el PDF digital del banco. Si es un escaneo (una foto del papel), no tiene texto que leer y te lo avisaremos: en ese caso descarga el CSV. |
No hace falta que le des ningún formato especial ni que borres columnas: se buscan las líneas que tengan una fecha y un importe, que es lo que todo extracto trae.
Los tres resultados¶
El comprobante tiene su movimiento en el banco. Además te decimos cómo calzó:
- Exacto — por número de operación. Es un identificador: no hay ambigüedad.
- Probable — por monto y fecha. Cuando el número de operación no está o no coincide, se busca un movimiento del mismo importe con hasta 3 días de diferencia. Es una coincidencia razonable, no una certeza.
Estos son los que hay que revisar. El bot los dio por pagados y no están en el extracto. Puede ser:
- Una captura editada (el caso que importa).
- Un pago que se revirtió después.
- Un extracto que no cubre esa fecha — si el comprobante es del 30 y descargaste hasta el 28, va a aparecer acá sin que haya nada malo.
Movimientos de tu cuenta sin ningún comprobante asociado. Casi siempre es un cliente que pagó y no avisó — y que hoy figura como moroso en tu sistema. Vale la pena revisarlo: suele haber cobranza que ya estaba paga.
No guardamos tu estado de cuenta
El archivo se lee, se compara y se descarta. No se almacena ningún movimiento bancario tuyo: el resultado se vuelve a calcular cada vez que lo subes.
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 |
| Comprobar que los pagos entraron de verdad | Sube tu estado de cuenta en la pestaña Comprobantes | Nada; el CSV o PDF que te da tu banco |
| Dé prórrogas si se las piden | Casilla «Cuando el cliente la pide» en Prórrogas | Nada más; conviene fijar un Máximo por cliente |
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.
- No se ve el destinatario en la captura (recortada, o un banco que no lo imprime). Esto no quiere decir que el cliente haya pagado a otra cuenta: el bot le pide la captura completa antes de escalar.
- 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".
La conciliación dice que mi PDF es un escaneo
El PDF que descargaste es una imagen, no texto: pasa cuando el extracto se escaneó o se fotografió. No hay nada que leer ahí. Entra a tu banca por internet y descarga el movimiento en CSV o Excel, que además es más preciso.
Muchos comprobantes salen como «no aparecen en tu banco»
Antes de preocuparte, revisa el período del extracto: si descargaste solo el último mes y tienes comprobantes más viejos, van a salir todos ahí. Debajo del resumen te decimos desde qué fecha se comparó. Si el período es correcto y aun así aparecen muchos, ahí sí conviene revisarlos uno por uno.