> ## 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.

# Payment Concierge

> Configura tu analista de pagos con IA, hazle cualquier pregunta sobre tus datos de pago y administra los canales donde tu equipo trabaja con él

La sección Payment Concierge del Dashboard configura un agente de IA que funciona como un analista de pagos en tu equipo: ve todo tu stack de pagos y trabaja desde donde tu equipo ya trabaja: Slack, WhatsApp, Telegram o Microsoft Teams. Está disponible las 24 horas, todos los días, así que puedes preguntarle lo que quieras, cuando quieras, y obtener una respuesta en segundos. Por ejemplo:

* *"¿Por qué bajó mi tasa de aprobación en el Reino Unido esta semana?"*
* *"¿A qué PSP debería enrutar las transacciones de Mastercard en Brasil?"*
* *"¿Qué está causando los rechazos de Adyen y cómo los soluciono?"*
* *"Compara todos mis PSP de los últimos 7 días: ¿quién tiene un rendimiento inferior?"*
* *"Prepárame un informe completo del rendimiento de aprobación del mes pasado, desglosado por país y proveedor."*

Tu Concierge no solo responde. Explica la causa raíz hasta el nivel del emisor, recomienda una acción específica y puede convertir todo eso en un informe completo.

Tu Concierge también puede trabajar de forma proactiva. Monitorea tu stack de pagos todo el día y envía resúmenes programados: volumen diario y tasas de aprobación, un desglose por proveedor, los principales motivos de rechazo y alertas sobre cualquier anomalía, como una caída en la tasa de aprobación en varios proveedores o un desplome repentino del volumen, cada una con contexto y próximos pasos específicos. Tú decides sobre qué informa, con qué frecuencia y dónde se entrega cada informe: Slack, WhatsApp, Telegram o Microsoft Teams.

## Configuración del Concierge

Antes de que tu equipo pueda trabajar con el Concierge, un admin lo activa para la organización y asigna a cada persona un nivel de acceso mediante un rol personalizado.

**1. Solicita acceso**

Abre la sección Payment Concierge y selecciona **Request access**. En el cuadro de diálogo, elige tu **primary communication channel** (Slack, WhatsApp o Telegram), selecciona una **desired activation date**, acepta los **Terms and Conditions** y envía la solicitud. El equipo de Yuno revisa la solicitud y activa el Concierge para tu organización.

![Cuadro de diálogo Request access con los campos de canal de comunicación principal, fecha de activación deseada y Terms and Conditions](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/request-access.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=5de507a13aa85795ba100f5849f61ba3)

> [!NOTE]
>
> **Paso solo para admins**
>
> Solo un admin puede solicitar acceso. La fecha de activación debe ser al menos 7 días posterior a hoy.

**2. Asigna niveles de acceso con roles**

Una vez que el Concierge está activo, tú decides qué puede hacer cada persona. Hay dos niveles de acceso:

> [card] Admin
>
> Configura el Concierge para toda la organización: conecta los canales de comunicación, administra quién tiene acceso, define el conocimiento que usa el Concierge y crea tareas programadas para la organización o para personas individuales.

> [card] Member
>
> Configura el Concierge solo para sí mismo: define sus propios canales y sus propias tareas programadas, sin modificar la configuración de toda la organización.

Otorgas estos niveles mediante roles personalizados. Desde **Organization → Roles → Create role**, crea un rol, habilita el permiso de Payment Concierge que corresponde al nivel y asigna el rol a la persona:

* **20.1 Manage Payment Concierge**: otorga la vista Admin.
* **20.2 Manage Member Payment Concierge**: otorga la vista Member.

![Página Create role desplazada hasta los permisos de Payment Concierge 20, 20.1 y 20.2](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/create-role-permissions.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=8e05d71516ae18b2e633ba0af85797e9)

> [!NOTE]
>
> **Las vistas se adaptan al rol**
>
> La sección se ajusta automáticamente al rol de cada persona, de modo que solo ve lo que le corresponde.

## Para admins

Como admin ves tres pestañas: **Access**, **Scheduled tasks** y **Concierge knowledge**.

> [tab] Access
>
> Aquí decides dónde puede hablar el Concierge y a quién puede contactar.
>
> **Canales de comunicación.** Selecciona los canales donde Payments Concierge puede hablar: Slack, WhatsApp, Telegram y Microsoft Teams.
>
> ![Tarjeta Communication channels con las opciones Slack, WhatsApp, Telegram y Microsoft Teams](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/communication-channels.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=04dce6ec9356f4416a7f08e9ede6dde5)
>
> Conectar Microsoft Teams requiere algunos pasos adicionales. Al conectarlo, una guía paso a paso te muestra cómo incorporar el Concierge a tu organización:
>
> * Crea el bot en Azure.
>
> * Habilita el canal de Microsoft Teams.
>
> * Copia el Microsoft App ID y el App Tenant ID.
>
> * Genera y copia un client secret.
>
> * Otorga el permiso de Microsoft Graph, para que el Concierge pueda identificar a tus usuarios por email.
>
> * Sube la app a Teams y luego selecciona **Connect**.
>
> > [!NOTE]
> >
> > **Quién puede conectar Microsoft Teams**
> >
> > Este paso afecta el registro de tu app de Azure y requiere el consentimiento de un administrador del tenant, por lo que necesitarás a un administrador de Teams de tu organización o a un desarrollador para completarlo.
>
> **Chats grupales.** Agrega los canales o grupos compartidos donde el Concierge puede publicar: un canal de Slack, un grupo de Telegram o un canal de Microsoft Teams. Selecciona **Add group chat**, elige la plataforma y pega el enlace del canal (por ejemplo `https://acme.slack.com/archives/C0BH7B56GD6`). El panel incluye una guía **How to add the Concierge** (con un video corto) que te muestra de dónde copiar el enlace.
>
> ![Tarjeta Group chats con el botón Add group chat y sin chats grupales agregados todavía](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/group-chats.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=092d732a9f7e654f962988b8e2e84658)
>
> ![Panel Add group chat con Slack seleccionado, el campo del enlace del canal de Slack y los pasos para agregar el Concierge a Slack](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/add-group-chat.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=32056fd36e7837f07b999dc2930452a3)
>
> > [!NOTE]
> >
> > **Los chats grupales de Slack necesitan un canal de Slack Connect**
> >
> > Para habilitar **@Tom (Payments Concierge)** en Slack, tu TAM primero debe crear un canal de Slack Connect entre Yuno y tu workspace, y luego invitar al agente allí.
>
> **Usuarios con acceso.** Asocia a cada persona de tu organización con su identidad de Slack, WhatsApp o Telegram para que el Concierge sepa quién escribe y pueda contactarla por mensaje directo. No necesitas conocer ningún formato especial. Cada canal tiene un enlace **How do I find it?** que guía a la persona para obtener su propio ID:
>
> * **Slack**: busca **@Tom (Payments Concierge)** en Slack y luego agrega el enlace de tu perfil de Slack para que el agente pueda enviarte mensajes directos.
> * **WhatsApp**: abre un chat con el agente desde **Open WhatsApp** o comparte el enlace con tu equipo. Agrega tu número de teléfono con el código de país (por ejemplo `+573000000000`).
> * **Telegram**: abre un chat con el agente desde **Open Telegram** y luego agrega tu ID de Telegram para que pueda contactarte por mensaje directo.
>
> Define la identidad de cada persona para sus canales directamente en la tabla de usuarios. Para administrar quién pertenece a tu organización y sus roles, selecciona **Manage access**.
>
> ![Tarjeta Users with access con las tarjetas de conexión de Slack y WhatsApp, el botón Manage access y la tabla de usuarios](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/users-with-access.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=d2580303daef00d18f44a8f9d0dd9e6f)

> [tab] Scheduled tasks
>
> Tareas recurrentes que el Concierge ejecuta y entrega automáticamente, para toda la organización o para una sola persona. Para agregar una, selecciona **New scheduled task** y completa el panel:
>
> **1. Who is this for?**
>
> Elige **Whole organization** (todas las personas con acceso la reciben) o **Just me** (solo tú la recibes).
>
> ![Panel New scheduled task con Just me seleccionado](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/new-scheduled-task-just-me.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=5b8ae7f279666b40d4f2fa443680efb7)
>
> **2. Task name**
>
> Asigna un nombre a la tarea, por ejemplo *Daily Morning Brief*.
>
> **3. Frequency, Language, and Delivery time**
>
> Define con qué frecuencia se ejecuta (Daily, Weekly o Monthly), el idioma y cuándo se entrega. La hora de entrega usa la zona horaria configurada en los ajustes de tu Dashboard.
>
> Weekly agrega un campo **Day of the week** y Monthly agrega un campo **Day of the month**.
>
> ![Panel New scheduled task con frecuencia Weekly y el campo Day of the week](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/new-scheduled-task-weekly.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=4693f1b73c33fdbd2b4592004e10c909)
>
> ![Panel New scheduled task con frecuencia Monthly y el campo Day of the month](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/new-scheduled-task-monthly.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=ea4831eb009a854eff35e65d8bee24d1)
>
> **4. What should this brief include?**
>
> Describe, en lenguaje sencillo, qué debe cubrir el informe, por ejemplo: *"Resumen de la tasa de aprobación de ayer por país."*
>
> ![Panel New scheduled task desplazado hasta la tabla Send to y el editor What should this brief include? con sus sugerencias](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/new-scheduled-task-brief.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=ddbadd34d5d140a9fbd19f22756c33d5)
>
> **5. Send to**
>
> Elige las personas y los chats grupales que lo reciben, por canal (Slack, WhatsApp), o usa **Select all**.
>
> **6. Create task**
>
> Selecciona **Create task**.
>
> ![Panel New scheduled task con Whole organization seleccionado y frecuencia Daily](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/new-scheduled-task.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=10cbfdfa2c818f1770a5edbd101b814b)
>
> Puedes editar, pausar, reanudar o eliminar cualquier tarea en cualquier momento, y aquí verás todas las tareas de tu organización.

> [tab] Concierge knowledge
>
> Los productos, el tono y las políticas que el Concierge aplica en cada conversación. Usa esta pestaña para darle al Concierge contexto de negocio, por ejemplo los mercados en los que operas, los métodos de pago que priorizas y el tono que quieres que use. Escríbelo en el editor y selecciona **Save context**, y el Concierge lo aplicará en todas partes.
>
> ![Pestaña Concierge knowledge con el editor de texto y el botón Save context](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/concierge-knowledge.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=e9173cbd0ed16cc52a4e6b0b922a1438)

## Para members

Como member, la sección Payment Concierge es una sola página enfocada en ti: los canales donde el Concierge puede contactarte y tus propias tareas programadas. No ves la configuración de Access ni de Concierge knowledge de toda la organización.

![Vista Member de Payments Concierge con las secciones Your channels y Scheduled tasks](https://mintcdn.com/yuno-3979e326/kylvVVLttpKKT9Ky/images/reference/payment-concierge/member-view.png?fit=max\&auto=format\&n=kylvVVLttpKKT9Ky\&q=85\&s=b4668782e11429712141fce54e96ae49)

**Tus canales.** Configura tu propia identidad para que el Concierge pueda contactarte en los canales que tu admin habilitó. No necesitas conocer ningún formato especial. Cada canal tiene un enlace **How do I find it?** que te muestra exactamente cómo obtener tu ID:

* **Slack**: busca **@Tom (Payments Concierge)** y luego agrega el enlace de tu perfil de Slack para que pueda enviarte mensajes directos.
* **WhatsApp**: abre un chat con el agente desde **Open WhatsApp** y agrega tu número de teléfono con el código de país (por ejemplo `+573000000000`).
* **Telegram**: abre un chat con el agente desde **Open Telegram** y luego agrega tu ID de Telegram.

Estos son tus identificadores personales; no administras los canales de la organización.

**Tus tareas programadas.** Crea tareas recurrentes que el Concierge ejecuta para ti. Tú eliges la frecuencia, la hora de entrega, el idioma y sobre qué informa, y se entrega en tus canales. Solo verás las tareas que son para ti: las que creaste, las que un admin te asignó, además de los resúmenes de toda la organización que llegan a todos. Puedes editar, pausar, reanudar o eliminar tus propias tareas en cualquier momento.

Puedes acceder a Payment Concierge desde el [Yuno Dashboard](https://dashboard.y.uno/).


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