> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# NOVA

> Agente de IA que recupera pagos rechazados contactando a tus clientes por WhatsApp o mediante una llamada de voz con sonido natural

Cada pago rechazado es un cliente que ya decidió comprar. NOVA es el agente de IA de Yuno para la recuperación de pagos: cuando se rechaza el pago de uno de tus clientes, NOVA se comunica con ese cliente por WhatsApp o mediante una llamada telefónica, le explica lo que ocurrió, resuelve sus dudas y lo guía para completar el pago. Habla con la voz de tu marca, en el idioma de tu cliente y con todo el contexto del pago fallido. No hay nada que integrar: NOVA funciona del lado de Yuno, sobre los pagos que ya procesas.

## Cómo recupera NOVA un pago

**1. Detectar**

Cada pago rechazado o fallido se captura en tiempo real y se evalúa según las reglas de segmentación acordadas contigo: qué tipos de pago, montos y mercados califican para el contacto. También puedes reservar un grupo de control para medir el impacto incremental de NOVA frente a los clientes a los que no contactó.

**2. Contactar**

NOVA contacta al cliente por el canal más adecuado con un mensaje o una llamada creados para ese caso específico: qué estaba comprando, por qué falló el pago y cómo completarlo, incluido un enlace seguro del checkout de Yuno con los métodos de pago que habilites.

**3. Recuperar**

El cliente paga mediante su flujo normal del checkout de Yuno. El pago recuperado llega a tu cuenta como cualquier otro pago exitoso, sin un nuevo flujo de dinero que conciliar.

## Los canales

Ambos canales están disponibles a nivel global y se configuran por comercio y mercado. La combinación es una decisión de estrategia, no una restricción de disponibilidad: usa WhatsApp donde el volumen de mensajería es grande, voz donde una conversación en vivo tiene más peso, o combina ambos en el mismo mercado.

> [tab] WhatsApp
>
> El canal de escala. La conversación comienza con un mensaje personalizado y continúa como un diálogo real dentro de WhatsApp: NOVA responde preguntas, explica el rechazo, ofrece métodos de pago alternativos y vuelve a compartir el enlace de pago. La entrega se rastrea de extremo a extremo, así que sabes si cada mensaje llegó al cliente.
>
> *"¡Hola Ana! Soy Sofía de YourStore. Tu pago de \$28 por tu suscripción mensual no se completó, parece que la tarjeta no tenía fondos suficientes esta vez. No te preocupes: puedes completarlo aquí con cualquiera de tus métodos de pago → \[enlace de pago seguro]. ¡Estoy aquí si tienes alguna pregunta!"*
>
> *Cliente: "¿Puedo pagar con otra tarjeta?"*
> *NOVA: "¡Por supuesto! El mismo enlace te permite pagar con cualquier tarjeta o método alternativo habilitado para YourStore. Toma menos de un minuto y tu suscripción sigue activa."*

> [tab] Voz
>
> El canal de conversión. NOVA realiza una llamada saliente con una voz de IA natural y conversacional, hablando como tu agente con nombre propio en el idioma de tu cliente. Una conversación en vivo resuelve las objeciones en el momento. Cada resultado de llamada (contestada y con interacción, llamada corta, buzón de voz, sin respuesta, ocupado o fallida) se clasifica automáticamente, lo que alimenta tanto los reportes como la lógica de reintentos: si el cliente no contesta, NOVA reintenta automáticamente según un calendario configurado para ti. Los buzones de voz y las señales de ocupado no ponen fin a la historia, los intentos de seguimiento son una de las palancas más fuertes de recuperación.

## Diseñado para convertir y para sentirse como tú

> [card] Tu marca, tu persona
>
> Una identidad de agente con nombre (por ejemplo, "Sofía de YourStore"), tu tono de voz y tus referencias de soporte, configurados durante el onboarding.

> [card] El idioma de tu cliente
>
> Las conversaciones se realizan en el idioma de cada mercado. El español y el portugués están en producción hoy; se habilitan idiomas adicionales por comercio.

> [card] Con contexto, sin guion
>
> Cada contacto se genera a partir del pago real: el nombre del cliente, el monto, el producto y el motivo del rechazo, para que la solución sugerida se ajuste al problema real.

> [card] Bidireccional, no un envío masivo
>
> NOVA mantiene la conversación: responde preguntas, ofrece alternativas y resuelve objeciones.

## Primeros pasos

No hay SDK, integración de API ni cambios de código de tu lado. El onboarding con tu equipo de cuenta de Yuno es un ejercicio de configuración, que normalmente se mide en días:

| Qué se configura | Ejemplos |
| :- | :- |
| Marca y persona | Nombre de la tienda, nombre del agente, tono de voz, referencias de soporte |
| Idioma y mercado | Español o portugués; qué países y monedas |
| Estrategia de canales | WhatsApp, voz o una combinación, por mercado |
| Filtros de segmentación | Qué pagos rechazados califican: tipos de pago, montos, categorías de producto |
| Finalización del pago | Qué métodos de pago ofrecer y el enlace seguro del checkout de Yuno que reciben los clientes |
| Política de reintentos (voz) | Cuántos intentos de seguimiento y con qué demoras |
| Medición | Grupo de control opcional, para la medición A/B del impacto incremental |

Una vez en funcionamiento, NOVA trabaja de forma autónoma: detecta los rechazos, contacta a los clientes, gestiona las conversaciones y recupera pagos, de manera continua. Los pagos recuperados aparecen como pagos exitosos normales en tus reportes de Yuno existentes.

## Medición honesta

Los reportes de NOVA son conservadores por diseño. Un pago cuenta como recuperado solo cuando se logró contactar al cliente **y** luego completó un pago exitoso dentro de una ventana de atribución definida. Los clientes a los que nunca se contactó, o que volvieron por su cuenta más tarde, no se reclaman como una recuperación.

Tus reportes incluyen:

* **Comunicaciones**: intentos de contacto enviados, por canal y mercado.
* **Tasa de finalización**: la proporción de comunicaciones en las que se logró contactar al cliente, el techo de alcance de todo el programa.
* **Recuperación sobre el total**: pagos recuperados ÷ todas las comunicaciones enviadas (el resultado de negocio).
* **Recuperación sobre las completadas**: pagos recuperados ÷ clientes contactados (calidad de la conversión una vez establecido el contacto).
* **Valor recuperado**: el valor del pago rechazado que se recuperó, en USD.
* **Satisfacción del cliente**: consulta la sección siguiente.

> [!NOTE]
>
> ¿Quieres comprobar que es incremental? Habilita un **grupo de control**: NOVA reserva una parte de los clientes elegibles para que puedas comparar la recuperación con y sin contacto.

### Satisfacción del cliente, medida

Después de que termina una conversación por WhatsApp, NOVA puede enviar una breve encuesta de satisfacción de dos preguntas, para que no solo veas los pagos recuperados, sino también cómo vivieron los clientes el contacto. Los resultados se incorporan a tus reportes junto con las métricas de recuperación.

## Datos y seguridad

> [card] Los pagos permanecen en el checkout de Yuno
>
> NOVA comparte un enlace de pago seguro. Nunca solicita números de tarjeta ni credenciales dentro de la conversación.

> [card] Limitado a tu organización
>
> NOVA solo contacta a tus clientes sobre tus pagos, bajo las reglas de segmentación acordadas contigo.

> [card] Los clientes mantienen el control
>
> Las solicitudes para dejar de ser contactado se respetan, y las reglas de exclusión a nivel de comercio siempre se cumplen.

> [card] Totalmente auditable
>
> Cada comunicación incluye un historial de estados completo, enviada, entregada, respondida, resultado, reflejado en tus reportes.

## Cómo obtener acceso

NOVA está disponible para los comercios de Yuno, no hay trabajo de integración de tu lado. Contacta a tu gerente de cuenta de Yuno para habilitarlo en tu organización.

> [!NOTE]
>
> NOVA mejora continuamente: la calidad de las conversaciones y el rendimiento de recuperación se ajustan a partir de cada interacción, y se habilitan nuevos canales y mercados según lo necesiten los comercios.

## Preguntas frecuentes

> [accordion] ¿Qué cuenta exactamente como un pago recuperado?
>
> Solo un pago en el que se logró contactar al cliente (mensaje entregado y con interacción, o llamada contestada) y que luego completó un pago exitoso dentro de una ventana de atribución definida después del contacto. No se cuentan los clientes a los que nunca se contactó, ni los que pagaron por su cuenta fuera de la ventana.

> [accordion] ¿Necesito integrar algo?
>
> No. NOVA funciona del lado de Yuno, usando los pagos que ya procesas con Yuno. El onboarding es configuración (voz de marca, canales, segmentación), no código.

> [accordion] ¿A qué clientes contacta NOVA?
>
> Solo a los clientes cuyo pago fue rechazado y que cumplen los filtros de segmentación acordados contigo (tipos de pago, montos, mercados). También puedes reservar un grupo de control para medir el impacto incremental.

> [accordion] ¿Qué pasa si el cliente no contesta una llamada?
>
> NOVA reintenta automáticamente según un calendario configurable (el número de intentos y las demoras se definen por comercio). Los intentos de seguimiento son una de las palancas más fuertes del rendimiento de recuperación.

> [accordion] ¿Cómo se identifica NOVA ante mis clientes?
>
> Como tu marca: una persona de agente con nombre que habla en nombre de tu tienda, configurada durante el onboarding. La experiencia está diseñada para sentirse como si tu propio equipo de soporte se comunicara para ayudar a completar la compra.

> [accordion] ¿Con qué rapidez actúa NOVA después de un rechazo?
>
> La detección es en tiempo real y basada en eventos; el contacto sigue las reglas de campaña configuradas para tu organización.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.