Saltar al contenido principal
El nodo AI Agent puede cobrar con las pasarelas de pago que tienes instaladas: genera el link de pago dentro de la conversación y consulta si el cliente ya pagó, sin salir del agente. A diferencia del nodo de pago, donde armas el cobro en el flujo, acá el agente crea la orden a partir de lo que conversó con el cliente. Tú decides qué valores quedan fijos y cuáles completa el agente.
Nodo AI Agent con la pestaña Herramientas abierta, las pasarelas Stripe, Payphone y Wompi agregadas, y la configuración de la herramienta Generar link de pago Wompi con el monto en modo Estático

Herramientas de Wompi en el nodo AI Agent, con el monto fijo


Antes de comenzar

Necesitas la pasarela instalada y conectada, con su IVA configurado, ya sea desde el Marketplace o con la habilitación asistida del equipo Jelou. Revisa cómo se instala tu proveedor. El agente usa las credenciales de esa instalación. No las ve ni tienes que volver a ingresarlas en el nodo. Pasarelas disponibles: Wompi, Kushki, Nuvei, Mercado Pago, Payphone, DeUna, PayPal, Datafast, Stripe y Conekta. Placetopay, Niubiz, Culqi y Jelou Pay no tienen herramientas para el agente: para cobrar con ellas, usa el nodo de pago.
Stripe y Conekta funcionan solo con las llaves propias del comercio. Si la instalación usa Stripe Connect o Conekta Connect, el cobro desde el AI Agent se rechaza.

Herramientas disponibles

Cada pasarela trae dos herramientas. El nombre incluye la pasarela, así que puedes agregar varias pasarelas al mismo agente sin que se confundan.
El medio de pago no pasa por el agente: el sistema se lo envía directamente al cliente. El agente solo recibe el número de orden para usarlo como referencia.

Agregar las herramientas al agente

1

Abrir las herramientas del nodo

En Canvas, abre el nodo AI Agent y entra a la pestaña Herramientas.
2

Agregar la pasarela

Presiona Agregar tool, filtra por Marketplace y elige la pasarela. Aparece en la lista de herramientas del agente.
3

Configurar la herramienta de cobro

Presiona el ícono de configuración de la pasarela y entra a Generar link de pago. Ahí defines cómo se completa cada parámetro y el comportamiento después de ejecutarla.Para cobrar, usa Continuar: el agente recibe el número de orden y sigue la conversación para dárselo al cliente.
4

Probar el cobro

Prueba la conversación desde el tester antes de publicar. Cada cobro crea una orden real en la pasarela, así que usa una instalación en modo prueba o con credenciales de prueba. El modo prueba admite hasta 10 pruebas por configuración, y DeUna no lo tiene.

Fijar el monto y otros valores

Cada parámetro de Generar link de pago puede completarse de dos formas:
  • IA: el agente lo obtiene de la conversación.
  • Estático: el valor queda fijo. El agente no lo pide y no lo puede cambiar, aunque el cliente diga otro monto en el chat.
Fija el monto y el concepto cuando el precio no depende de la conversación, por ejemplo una cuota o un servicio con tarifa única.
amount se cobra más IVA. Si fijas un precio que ya incluye el IVA, activa without_tax; si no, el cliente paga el impuesto dos veces. Para cobrar sin IVA usa without_tax: true: un tax_percentage en 0 no quita el impuesto, porque toma el IVA de la instalación.
Configura tax_percentage y without_tax como Estático. El cliente no debe decidir el impuesto del cobro.
El total que paga el cliente es el monto más el IVA, salvo que without_tax esté activo. El agente recibe ese total en la respuesta de la herramienta.

Datos del cliente por pasarela

Además del monto y el concepto, cada pasarela exige algunos datos del pagador. El agente solo pide los que exige la pasarela y que todavía no conoce; los opcionales los envía si el cliente ya los dio.
En WhatsApp el teléfono sale de la conversación, así que el agente no lo pide.

Qué ve el cliente

Cuando el agente genera el cobro, el cliente recibe el mismo mensaje de pago que envía el nodo de pago, con el botón Proceder al pago. Con WhatsApp Business verificado, el checkout se abre como WebView sin salir de WhatsApp; si la cuenta no está verificada, se abre en el navegador del dispositivo. Después puede preguntarle al agente si su pago se registró, y el agente lo consulta con Consultar estado del pago.
Conversación en el tester en la que el cliente recibe el mensaje de pago con el botón Proceder al pago, el agente indica el total y el número de orden, y luego confirma que el pago fue exitoso

Cobro y confirmación del pago, probados desde el tester

El agente solo consulta órdenes generadas para el mismo contacto, aunque sean de otra conversación. Así el cliente puede volver otro día a preguntar por su pago, pero no puede consultar órdenes de otros contactos.

Límites actuales

  • Vencimiento del link. En Mercado Pago, Stripe, Conekta y DeUna el link vence a los 30 minutos. En Kushki, la sesión de pago dura 15 minutos desde que se abre el link. En las demás pasarelas no hay un vencimiento común; mientras el cliente no pague, la orden queda pendiente.
  • Cada cobro es una orden nueva. Si el agente vuelve a generar un cobro, se crea otra orden, aunque haya una pendiente.
  • No hay monto máximo. Si amount está en modo IA, el monto lo define la conversación. Cuando el precio es conocido, déjalo en Estático.

Recomendaciones para el prompt

  • Confirma antes de cobrar. Cada llamada crea una orden real. Indícale al agente que muestre el concepto y el monto y espere la confirmación del cliente.
  • Revisa si hay una orden pendiente. Antes de generar otro cobro, el agente debe consultar el estado de la orden anterior.
  • No pidas lo que ya está fijo. Si el monto o el concepto son estáticos, evita instrucciones como “confirma el monto con el cliente”: el agente no puede cambiarlo.
  • No pegues el link. El cliente ya recibe el mensaje de pago. El agente solo debe mencionar el número de orden.

Solución de problemas

Revisa que el parámetro esté en modo Estático en la herramienta y que el prompt no le pida confirmar ese dato al cliente.
Cada pasarela tiene un monto mínimo por moneda. Si el total queda por debajo, la herramienta responde con un mensaje como “<pasarela> no acepta cobros menores a <mínimo> <moneda>”. Sube el monto o revisa el IVA aplicado.
La instalación usa Stripe Connect o Conekta Connect. Conecta la pasarela con las llaves propias del comercio.
Algunas pasarelas exigen correo, nombre, apellido o teléfono. Revisa la tabla de datos del cliente por pasarela y que el agente no envíe valores vacíos.
Revisa la ejecución en el debugger para ver el mensaje real que devolvió la herramienta.

Siguientes pasos

Proveedores de pago

Cómo instalar y conectar cada pasarela.

Modo prueba

Prueba una pasarela sin credenciales propias.

Experiencias de pago

Diferencias entre checkout, pago nativo y confirmación externa.

Comisiones y costos

Qué cobra cada pasarela por transacción.