Conectar tu asistente de IA (Claude o ChatGPT)

Conecta Claude o ChatGPT a tu cuenta de Xtarly Rewards para configurar tu programa de lealtad y tus premios conversando.

Puedes conectar tu asistente de IA a tu cuenta de Xtarly Rewards y configurar tu programa de lealtad conversando: le pides «quiero 8 sellos y un café gratis al completar» y el asistente lo prepara, te muestra qué va a cambiar y, cuando se lo confirmas, lo aplica.

Hoy funciona con Claude (claude.ai en web, escritorio y móvil) y con ChatGPT (en la web). Más adelante podrá conectarse cualquier asistente compatible con MCP que use OAuth.

URL del conector: https://api.xtarly.com/api/mcp

Requisitos

Ser owner o admin del negocio en Xtarly. Otros roles no pueden reconfigurar el programa.
Tener una cuenta de Claude (claude.ai) —el plan Free permite 1 conector personalizado— o una cuenta de ChatGPT para agregarlo como plugin personalizado desde la web.
Que tu cuenta de Xtarly esté al corriente: una cuenta morosa o cancelada no puede reconfigurar el programa.

Cómo conectarlo

Agrega el conector en tu asistente

En Claude — planes Free, Pro y Max:

En Claude, ve a Personalizar → Conectores (en inglés: Customize → Connectors).
Elige Agregar conector personalizado (Add custom connector).
Pega la URL https://api.xtarly.com/api/mcp.
Pulsa Add.

En Claude — planes Team y Enterprise: un Owner de la organización agrega el conector en Organization settings → Connectors con la misma URL. Después, cada miembro pulsa Connect para vincular su propia cuenta de Xtarly.

En ChatGPT (en la web):

Ve a Plugins y pulsa Agregar (en inglés: Plugins → Add).
Elige crear un MCP personalizado (Create custom MCP).
El nombre y la descripción los escribes tú, no los pone Xtarly. Ponle el nombre que quieras y una descripción corta: si la dejas vacía, la ficha del conector dirá «No description».
En la URL del servidor pega https://api.xtarly.com/api/mcp.
En Autenticación elige OAuth.

Si no te aparece la opción de crear un MCP personalizado, enciéndela en Configuración → Seguridad e inicio de sesión → Modo desarrollador y vuelve a Plugins.

Inicia sesión en Xtarly

Al conectar, tu asistente abre el inicio de sesión de Xtarly. Entra con la cuenta con la que administras tu negocio.

Revisa y concede los permisos

Xtarly te muestra una pantalla de permisos que explica qué podrá hacer el asistente. Si además quieres que programe envíos a tus clientes, concede también el permiso de campañas. Pulsa Permitir para terminar, o Rechazar si no quieres conectarlo.

Empieza a conversar

De vuelta en tu asistente, pídele lo que necesitas. Xtarly te muestra siempre la vista previa antes de aplicar un cambio y no lo aplica sin tu sí. Tu asistente, además, suele pedirte confirmación en las acciones que cambian algo; tanto Claude como ChatGPT te dejan ajustar con qué frecuencia te pregunta.

Cuando Xtarly agregue funciones nuevas al asistente, tendrás que desconectar y volver a conectar el conector para verlas (ve «Solución de problemas» más abajo).

Qué puede hacer el asistente

Acción	Detalle
Ver tus negocios	Lista los negocios a los que tienes acceso.
Ver tu programa	Tipo (puntos, sellos o niveles), puntos por peso, sellos requeridos, vencimientos y topes antifraude; también tus niveles y premios.
Ver tu menú y tus sucursales	Para premios por producto o por sucursal: el asistente toma de ahí los productos y sucursales a los que aplica el premio.
Dejar listo tu negocio	Datos del negocio y zona horaria, sucursales, menú (también pegando tu menú) y el enlace o QR para que tus clientes se inscriban. El país se cambia en Ajustes.
Encender tus avisos automáticos	Bienvenida, cumpleaños, te extrañamos, novedad y primera visita, por correo, WhatsApp o notificación. Te muestra el aviso antes de encenderlo. Necesita el permiso de campañas.
Invitar a tu personal de caja	Les manda la invitación por correo. Solo da acceso de caja; los administradores se invitan desde el panel.
Ver cómo va tu negocio	Totales por periodo (7 días, 30 días, 90 días o 12 meses, por días completos en la zona horaria de tu negocio): clientes nuevos y activos, transacciones y monto, puntos o sellos emitidos y canjes por premio, también por sucursal. Nunca muestra clientes uno por uno.
Ver segmentos de clientes	Cuántos están cerca del premio, inactivos, cumplen años en el mes, nuevos sin regreso o en cada grupo de actividad, y a cuántos se les puede escribir por correo, WhatsApp o notificación; nunca quiénes. También calcula a cuántos llegaría una audiencia antes de una campaña.
Previsualizar un cambio	Te dice qué cambia y a cuántos clientes con saldo afecta, sin aplicar nada.
Configurar el programa	Pide confirmación. Cambiar el tipo de programa exige doble confirmación.
Configurar niveles	Crea o ajusta los niveles de tu programa.
Crear premios	Nacen desactivados y se publican con un paso aparte que el asistente debe pedirte, porque publicar un premio avisa a tus clientes con notificaciones activadas y, si tienes encendidas las novedades automáticas, también por WhatsApp y correo.
Editar, activar, desactivar y eliminar premios	Eliminar pide confirmación. Desactivar un premio publicado y vigente también: antes te dice cuántos clientes podrían canjearlo hoy.
Crear y publicar cupones	Descuento, producto gratis o cupón de cumpleaños, con vigencia, días y condiciones. Nace desactivado y lo publicas en un paso aparte. Puede dirigirse a grupos de clientes (por ejemplo, los que no han vuelto), nunca a un cliente con nombre. Al editar uno publicado te muestra campo por campo el antes y el después (por ejemplo, «50 % → 40 %») y cómo quedaría. Cada cupón y premio indica si hoy se puede usar (`vigenteHoy`: publicado y dentro de su vigencia).
Ver, editar, desactivar y eliminar cupones	Ve tus cupones y cuántos clientes los tienen asignados o los usaron (nunca quiénes). Desactivar, eliminar o endurecer un cupón publicado te muestra antes a cuántos clientes afecta y pide tu confirmación; un cupón ya usado no se elimina: se desactiva.
Preparar campañas por correo	Crea la campaña en borrador (no envía nada): te propone a qué grupo y con qué mensaje. Solo grupos de clientes (por ejemplo, sin compras en 30, 60 o 90 días, por nivel o por puntos), nunca personas concretas. Necesita tu cuenta de Resend conectada en Xtarly.
Preparar campañas por WhatsApp	Crea la campaña en borrador con una de tus plantillas aprobadas por Meta de categoría marketing: el asistente no escribe el mensaje, solo elige la plantilla y qué dato llena cada variable (nombre, puntos, sellos, nivel, código de invitación o el nombre de tu negocio). Necesita el módulo de WhatsApp en tu plan y tu número conectado en Xtarly.
Enviarte una prueba	Solo correo: manda la campaña solo a tu correo, con datos de demostración, para que veas cómo se ve. WhatsApp no tiene prueba sin costo.
Programar o enviar una campaña	Te muestra a cuántos clientes llegará, cuántos quedan fuera y por qué, y a qué hora sale en la zona horaria de tu negocio; la programa cuando se lo confirmas. Solo llega a clientes que dieron permiso de promociones con registro de cuándo y dónde, y nunca a más clientes de los que confirmaste. En WhatsApp te dice además cuántos mensajes te cobrará Meta, deja fuera a quien ya recibió una promoción ese día o la misma plantilla en los últimos 7 días, y no arranca si la calidad de tu número está en amarillo o rojo.
Cancelar y revisar campañas	Cancela una campaña programada antes de que salga y te da su estado y resultados generales (correo: enviados, entregados, abiertos, clics, rebotes; WhatsApp: enviados, entregados, leídos, fallidos y cuántos clientes volvieron en los 14 días siguientes). En WhatsApp también puede pausar y reanudar una campaña que se está enviando.

Para saber cómo funciona cada ajuste, consulta Programa de lealtad y Recompensas.

Qué NO puede hacer

El asistente trabaja con la configuración del programa, los premios, los cupones, tus campañas y avisos automáticos por correo y WhatsApp, los datos de tu negocio, tus sucursales, tu menú y las invitaciones a tu personal de caja, y consulta las métricas generales de tu negocio. No puede ver ni tocar:

datos de tus clientes finales (nombres, teléfonos, correos, saldos individuales);
transacciones o canjes uno por uno (solo ve totales por periodo);
a qué clientes se asignó un cupón ni quién lo usó (solo ve cuántos);
a quién le llegó cada campaña (solo ve totales);
campañas por notificaciones: próximamente;
crear, editar o mandar a revisión plantillas de WhatsApp, ni escribir el texto de un WhatsApp (usa las que ya aprobó Meta);
editar una campaña de WhatsApp ya creada (se cancela y se crea otra);
el remitente de tus correos ni la baja de un clic (los pone Xtarly);
el país de tu negocio (decide la moneda de tu plan y del programa: se cambia en Ajustes del negocio);
las imágenes de tu menú o de tu tarjeta (se suben desde el panel);
encender o editar los avisos automáticos por notificación (solo los consulta; se cambian en el panel);
el texto de los correos de bienvenida y premio listo (te propone el texto y tú lo pegas en el editor del panel, donde aceptas el compromiso de no usarlos para promociones);
invitar administradores ni cambiar el rol de nadie de tu equipo, ni ver sus correos o teléfonos;
pagos ni facturación.

Consejo: antes de confirmar cualquier cambio, pide «muéstrame primero qué va a cambiar». El asistente te enseña el efecto (incluido a cuántos clientes con saldo afecta) y tú decides.

Ejemplos de peticiones

«Configura mi programa con 8 sellos y un café gratis al completar.»
«Quiero puntos: 1 punto por cada $10 y que venzan a los 12 meses.»
«Crea tres premios: postre gratis a 5 sellos, bebida a 8 y 20 % de descuento a 10, pero no los publiques todavía.»
«¿Cómo tengo configurado el programa hoy?»
«Acabo de abrir mi cuenta: ayúdame a dejar listo el negocio. Te pego mi menú.»
«Prepara un correo para los clientes que no vienen hace 60 días y mándame una prueba.»

Cómo revocar el acceso

El acceso dura hasta que tú lo revoques. Tienes dos caminos:

Desde Xtarly: ve a Ajustes de cuenta → Seguridad → Asistentes de IA conectados y pulsa Revocar. El acceso se corta de inmediato, y si vuelves a conectar el asistente te pedirá los permisos otra vez.
Desde tu asistente: quita el conector en sus ajustes de conectores — en Claude, Personalizar → Conectores; en ChatGPT, en Plugins.

Seguridad y privacidad

Actúa con tu cuenta y tus permisos. El asistente no puede hacer nada que tú no puedas hacer; solo owners y admins del negocio pueden reconfigurar, y una cuenta morosa o cancelada no puede.
Todo queda registrado. Cada cambio aparece en el registro de actividad del negocio (Ajustes → Actividad) con la marca del asistente, para que sepas qué se hizo desde la conversación.
Revisa antes de aprobar. Los cambios delicados (configurar el programa o los niveles, publicar, desactivar o eliminar premios, publicar, desactivar, eliminar o endurecer un cupón publicado, programar una campaña, cambiar los datos del negocio, las sucursales o el menú, encender o configurar un aviso automático, invitar a alguien de tu equipo) solo se aplican con la vista previa que generó Xtarly: el asistente tiene que mostrártela y preguntarte antes, y si los cambios ya no son los mismos o pasaron más de 10 minutos, no se aplica nada y te muestra una vista previa nueva. Tu asistente suele pedirte confirmación además de la vista previa, pero eso lo decides tú en sus ajustes: la garantía que no depende de cómo lo configures es la vista previa de Xtarly. Si algo no salió como querías, lo ves en Actividad.
Qué datos viajan al proveedor del asistente: tu nombre, correo y foto de perfil, y la información de tu negocio que consulte: la configuración del programa (niveles, premios, cupones y avisos automáticos), los datos de tu negocio, tu menú (con los precios de sus opciones), tus sucursales con su dirección, el nombre y el rol de tu personal, métricas generales por periodo (cuántos clientes, transacciones y canjes, con montos totales y promedio) y, si diste el permiso de campañas, los borradores, el estado y los resultados generales de tus campañas. No los datos personales de tus clientes: los mensajes de tus campañas (correos y WhatsApp) los personaliza y envía Xtarly, no el asistente. De tu número de WhatsApp el asistente solo ve los últimos 4 dígitos y la calidad que le da Meta.
Las campañas y los avisos automáticos tienen un permiso aparte. Al conectar, la pantalla de permisos te pide por separado el de campañas, que también cubre encender y configurar avisos automáticos (apagarlos no lo necesita). Si conectaste el asistente antes de que existiera, no puede crear ni enviar campañas ni encender avisos hasta que lo desconectes y lo vuelvas a conectar para concederlo.
Tu personal: para ayudarte a organizar a tu equipo, el asistente ve el nombre, el rol y la sucursal de cada persona. Nunca recibe su correo, su contraseña ni su teléfono, y de las invitaciones pendientes solo ve cuántas hay.
Las campañas salen a nombre de tu negocio: las de correo desde tu cuenta de Resend, que es quien te cobra los correos, y las de WhatsApp desde tu número: Meta cobra cada mensaje de WhatsApp en tu cuenta de WhatsApp Business, según sus tarifas. Xtarly no cobra por mensaje y no conoce tu tarifa con Meta, así que el asistente te dice cuántos mensajes son, no cuánto cuestan. Antes de confirmar, revisa el texto: es responsabilidad de tu negocio (Términos, sección 14.2).

Solución de problemas

Mensaje o síntoma	Qué significa	Qué hacer
«No pudimos confirmar a qué sitio te regresaremos»	Xtarly no pudo verificar a dónde regresa la conexión.	Continúa solo si tú iniciaste la conexión desde tu asistente. Si no, cierra la ventana.
«La solicitud caducó»	La solicitud de conexión dura 10 minutos y pasó ese tiempo.	Vuelve a conectar desde tu asistente.
«insufficient scope»	La conexión no tiene los permisos que pide la acción.	Reconecta el conector desde tu asistente y concede los permisos.
El asistente no tiene una herramienta nueva que anunciamos	Tu asistente guarda la lista de herramientas al conectar y no la actualiza sola.	Desconecta y vuelve a conectar el conector: en Claude, en Personalizar → Conectores (Xtarly Rewards → Desconectar → Conectar); en ChatGPT, en sus ajustes de aplicaciones y conectores. Te pedirá permiso de nuevo. Abrir un chat nuevo a veces basta.

Límites de esta primera versión

Funciona con Claude (claude.ai en web, escritorio y móvil) y con ChatGPT en la web, agregándolo como plugin personalizado. Claude Code con puerto local todavía no está soportado.
La app de Gemini todavía no: sus aplicaciones personalizadas están limitadas a Estados Unidos, en inglés y con cuenta personal de Google.
El premio tipo «producto gratis» puede vincularse a productos del menú solo si esos productos ya existen.
Las fechas de premios, cupones y campañas se toman en la zona horaria de tu negocio: si le das al asistente solo el día de inicio o de vencimiento, empieza a las 00:00 y vence a las 23:59 de ese día. Por eso, si cambias la zona horaria, el asistente te avisa cuántas ofertas activas con fecha se mueven.
El asistente no sube imágenes: las categorías y productos que crea quedan sin foto hasta que la subas en el panel.
Las invitaciones de caja no guardan sucursales: si quieres limitar a alguien a una sucursal, hazlo desde el panel cuando acepte.

Conectar tu asistente de IA (Claude o ChatGPT)

En esta página