En resumen
Nubefact, Alegra y Bsale (facturación) y Mercado Pago, Stripe y PayPal (pagos) se conectan a FlujosChat desde Configuración → Integraciones. Hoy la conexión verifica la cuenta y guarda la credencial cifrada: FlujosChat no emite comprobantes ni mueve dinero, y que los agentes consulten cobros o comprobantes llegará próximamente. Para cobrar dentro de la conversación ya existe el paso de cobro con Yape.
Lo esencial
- Nubefact se conecta con la RUTA y un TOKEN de su API; Alegra con el correo y el token de un usuario; Bsale con el access token de la API.
- Ninguno de los tres ofrece tokens de solo lectura: FlujosChat solo usa la credencial para comprobar la conexión y nunca emite ni anula comprobantes.
- En pagos, Stripe admite una clave restringida de solo lectura; Mercado Pago y PayPal no permiten limitar la credencial, así que conviene una aplicación solo para FlujosChat.
- Que los agentes de IA consulten cobros o comprobantes llegará próximamente; hoy la conexión deja la cuenta lista y verificada.
- Para cobrar dentro de un flujo de WhatsApp ya existe el paso de cobro con Yape, que confirma el pago con la notificación real del celular del negocio.
Por WhatsApp te preguntan dos cosas una y otra vez cuando alguien compra: cómo pagar y dónde está su comprobante. Detrás de esas respuestas hay dos sistemas que ya usas —tu facturación electrónica y tu pasarela de pagos— y que casi nunca están conectados a tu canal de atención. Esta guía explica cómo conectar Nubefact, Bsale, Alegra, Mercado Pago, Stripe y PayPal a FlujosChat, qué hace hoy cada conexión y qué puedes automatizar ya.
Lo primero: qué hace hoy la conexión
Facturación y pagos son las credenciales más sensibles de tu negocio, así que conviene ser preciso:
- FlujosChat verifica la cuenta con una consulta de lectura antes de guardar la credencial. Si no funciona, no se guarda nada.
- La guarda cifrada y el panel no vuelve a mostrarla.
- No emite ni anula comprobantes y no mueve dinero. Hoy la credencial solo se usa para comprobar la conexión.
- Que tus agentes de IA consulten cobros o comprobantes —por ejemplo, para responder «¿me llegó la factura?»— llegará próximamente.
| Sistema | Área | Forma de conexión | ¿Credencial de solo lectura? |
|---|---|---|---|
| Nubefact | Facturación (Perú) | RUTA + TOKEN de la API | No existe |
| Alegra | Facturación y contabilidad | Correo + token de la API | No existe |
| Bsale | Facturación y punto de venta | Access token de la API | No existe |
| Mercado Pago | Pagos | Access token o OAuth | No se puede limitar |
| Stripe | Pagos | Clave restringida (recomendada) | Sí, con permisos de Lectura |
| PayPal | Pagos | App REST (Client ID + Secret) | No se puede limitar |
Por qué conviene tenerlos cerca de WhatsApp
En Perú las boletas y facturas se emiten de forma electrónica, y el cliente que compró por WhatsApp suele pedir su comprobante por el mismo chat. Lo mismo pasa con los pagos: «ya te pagué», «¿te llegó?», «¿aceptan tarjeta?». Son preguntas de respuesta conocida que hoy ocupan a una persona buscando en otro sistema.
Tener la facturación y la pasarela conectadas al canal de atención no elimina ese trabajo de un día para otro, pero ordena el camino:
- Las credenciales quedan en un solo sitio, verificadas y cifradas, en vez de repartidas en hojas o chats.
- Sabes qué cuenta está conectada y desde cuándo, y puedes probar la conexión desde el panel.
- Cuando llegue la consulta por los agentes, la cuenta ya estará lista y verificada, sin trámites de última hora.
Dónde se conecta
Desde Configuración → Integraciones, en los grupos Facturación y Pagos. Al abrir la tarjeta eliges la forma de conexión y el panel te pide solo lo que esa forma necesita. Lo pueden hacer el dueño de la cuenta o un administrador.
Las cuentas conectables se activan por empresa: si en tu panel aparecen como no disponibles, escríbenos desde contacto. Todo lo que FlujosChat conecta está resumido en integraciones.
Facturación electrónica: Nubefact, Alegra y Bsale
Ninguno de los tres ofrece credenciales de solo lectura: el mismo token que lee también permite emitir. Por eso la regla es crear una credencial solo para FlujosChat, que puedas borrar sin afectar a nada más.
Nubefact: la RUTA y un TOKEN
En tu cuenta de Nubefact, en la sección API (Integración), copia la RUTA y uno de los TOKEN; puedes crear uno solo para FlujosChat y borrarlo cuando quieras. Si no ves esa opción, pide a Nubefact que active la API en tu cuenta. La versión instalada en tu propio equipo (offline) no se puede conectar.
Alegra: el correo y el token de un usuario
En Alegra, Configuración → Integraciones → API, copia el correo del usuario y su token. El token tiene los permisos de ese usuario. Si lo renuevas en Alegra, vuelve a conectar en FlujosChat.
Bsale: el access token de la API
Pega el access token de la API de tu empresa en Bsale. Cada usuario tiene el suyo; si no lo tienes, pídeselo al soporte de Bsale. Para comprobar la conexión, FlujosChat lee tus sucursales y el nombre de la empresa.
Pagos: Mercado Pago, Stripe y PayPal
Aquí la diferencia entre plataformas es grande, y conviene conocerla antes de pegar nada:
- Stripe es el único de los tres que permite una clave restringida de solo lectura. En el Dashboard, Desarrolladores → Claves de API → «Crear clave restringida»: dale permiso de Lectura solo a lo que quieras compartir y Ninguno a lo demás, y pega la clave
rk_live_…. Evita la clave secreta completa. - Mercado Pago no permite limitar su access token a lectura. Crea en Mercado Pago Developers una aplicación solo para FlujosChat y usa sus credenciales de producción, o conéctalo con OAuth desde la cuenta que cobra. Si dejas de usar FlujosChat, renueva el token o borra la aplicación.
- PayPal tampoco permite limitar una app a lectura. En developer.paypal.com, en Apps & Credentials, crea una app REST solo para FlujosChat —en Live, o en Sandbox para probar— y pega su Client ID y Secret. Activa únicamente las funciones que vayas a usar.
Una credencial de pago es una llave de tu caja
Una credencial que no se puede limitar a lectura da acceso completo a tu cuenta. Créala solo para FlujosChat, no la compartas por chat ni por correo y bórrala si dejas de usar la integración. Si desconectas la cuenta en FlujosChat, borramos la credencial; para cortar el acceso del todo, revócala también en la plataforma.
Cobrar dentro de la conversación: lo que ya funciona
Mientras llega la consulta de cobros por los agentes, en Perú hay una forma de cobrar por WhatsApp que ya funciona: el paso de cobro con Yape de los flujos. El flujo le indica al cliente el monto del pedido, y el pago se confirma con la notificación real que la app de FlujosChat captura en el celular del negocio, no con lo que diga el cliente. Si además activas la lectura de la captura del comprobante con IA, ayuda a identificar qué pago es de quién cuando hay varios del mismo monto.
El funcionamiento completo está en el manual, en cobrar dentro del flujo con Yape. Y los avisos posteriores a la compra —pago confirmado, despacho, entrega— se explican en seguimiento de pedidos por WhatsApp.
Qué conviene automatizar y qué no
| Situación | ¿Automatizable hoy? | Cómo |
|---|---|---|
| Explicar los medios de pago | Sí | Un flujo con botones o un agente con base de conocimiento |
| Cobrar un pedido por Yape | Sí | El paso de cobro del flujo |
| Confirmar un pago de la pasarela | Próximamente | Hoy, consultando tu sistema desde un flujo con una llamada a API |
| Enviar el enlace del comprobante al cliente | Sí, desde tu sistema | Tu servidor llama a la API pública de FlujosChat |
| Anular o corregir una factura | No | Es una decisión contable: la hace una persona |
Las guías del manual empiezan en conectar integraciones, con un capítulo para Nubefact, Bsale y Mercado Pago.
Preguntas frecuentes
¿FlujosChat emite facturas o boletas?
No. Hoy FlujosChat conecta tu sistema de facturación —Nubefact, Alegra o Bsale— y solo usa la credencial para comprobar la conexión con una consulta de lectura. Nunca emite ni anula comprobantes.
¿Mi agente de IA puede decirle al cliente si su pago llegó?
Desde la pasarela conectada, todavía no: que los agentes consulten cobros llegará próximamente. Hoy, en los pagos por Yape del paso de cobro, el flujo confirma el pago con la notificación real del celular del negocio.
¿Por qué me piden una aplicación solo para FlujosChat?
Porque Mercado Pago, PayPal y los sistemas de facturación no permiten limitar la credencial a lectura. Una aplicación o un token dedicados se pueden borrar en cualquier momento sin afectar a tus otras integraciones.
¿Puedo conectar Stripe en modo de prueba?
Sí. FlujosChat acepta las claves de prueba de Stripe y marca la conexión como modo de prueba, así puedes comprobar el recorrido antes de usar la clave real.
¿Funciona con Bsale fuera de Perú?
Bsale opera en Chile, Perú y México, y FlujosChat se conecta a la misma API de Bsale en los tres países.
Fuentes
Equipo FlujosChatEquipo de producto
Escribimos lo que aprendemos operando WhatsApp Business API todos los días para negocios de LatAm.
Seguir leyendo