Ligas de pago en el IVR y el agente de IA
MonoPbx cobra sin tocar nunca una tarjeta. El IVR o el agente de IA envía a quien llama una liga de pago (Stripe Checkout, Mercado Pago Checkout Pro o una liga de pago de Conekta) por SMS o WhatsApp. Quien llama paga en la página del proveedor y el webhook del proveedor informa a MonoPbx el resultado.
Configuración
- Abra Admin > Conexiones > Integraciones, instale el proveedor (
stripe,mercado_pagooconekta) y pegue la llave secreta de API (Stripesk_..., el token de acceso de Mercado Pago o la llave privada de Conekta). La llave se sella con la llave de datos de la empresa y no se vuelve a mostrar. Ajustes opcionales: la moneda predeterminada y la página a la que regresa quien paga. - En la misma área, cree un endpoint de hooks entrantes para el conector y registre su dirección
https://<host>/hooks/int/<connector>/<install_key>en el panel del proveedor: eventos de Stripecheckout.session.*, notificaciones de Mercado Pago del temapayment, Conektaorder.paid,order.declined,order.expired,order.refunded. Use el esquema de firma de Stripe para Stripe y el secreto de firma del proveedor para los demás. - Permita las herramientas de IA
send_payment_linkypayment_statusen la instalación cuando un agente de IA deba cobrar.
El mensaje sale por los ajustes de negocio de IA de la empresa: el número remitente de SMS, o el canal de WhatsApp con una plantilla aprobada de un parámetro. Sin ellos la herramienta responde delivery_refused.
En un flujo de llamada
{ "type": "payment_link",
"config": { "provider": "conekta", "amount_var": "amt", "currency": "MXN",
"description": "Deposit", "channel": "whatsapp" },
"next": "thanks", "on_error": "agent" }
Use amount_minor (un monto fijo en centavos) o amount_var (una variable con centavos, por ejemplo de un paso collect). La liga va a quien llama, o al número de to_var. La referencia del proveedor se guarda en payment_ref (o reference_var). Los errores toman la salida on_error.
Estados y eventos
Cada liga está pending y luego paid, failed, expired o refunded según el webhook. Una liga pagada nunca regresa. Solo se guardan los últimos cuatro dígitos del número del destinatario. Una liga pagada o fallida genera una sola vez los eventos integration.payment_succeeded e integration.payment_failed (proveedor, referencia, monto, moneda; nunca quien paga ni el número).
Sin números de tarjeta
- Quien paga escribe la tarjeta en la página del proveedor, nunca por teléfono.
- En el teclado, un paso
collectdescarta la entrada que parece un número de tarjeta y toma su salida de tiempo agotado. - Los números de tarjeta tecleados o dichos en dígitos se reemplazan por
[card number removed]antes de guardar una transcripción, un SMS o un mensaje de chat. - La descripción de una herramienta de IA que contenga un número de tarjeta se rechaza, y el modelo recibe la referencia, nunca la liga.
La protección prefiere enmascarar, así que un número de pedido de 16 dígitos que pase la suma de verificación de tarjetas también se enmascara.