Operar Fidelizador con un agente de IA (servidor MCP)

Para desarrolladores

Con un agente de IA compatible puede consultar reportes y solicitar envíos utilizando lenguaje natural. La conexión utiliza MCP (Model Context Protocol), un estándar que permite al agente acceder únicamente a las funciones autorizadas de Fidelizador. Es un canal adicional que complementa la API pública REST y SMTP.

Alcance. Puede enviar a muchos destinatarios de una vez, como una notificación a un conjunto grande de clientes. Este canal tiene dos límites. No envía a una lista guardada: los destinatarios se indican en cada envío. Tampoco programa envíos: cada uno sale en el momento. El detalle de cada operación está en Qué puede hacer.

Qué es

Un agente de IA autorizado por usted puede consultar y operar Fidelizador de forma controlada, sin acceso directo a sus credenciales ni a datos de otras instancias. El agente se conecta al servidor MCP. Usted inicia sesión con su cuenta de Fidelizador, la misma con la que accede a la plataforma. Desde ahí conversa con el agente, y el servidor traduce cada intención a las operaciones de la plataforma.

Qué puede hacer

A través del agente, en lenguaje natural:

Sus instancias

• Listar las instancias de Fidelizador que administra, para indicar sobre cuál operar cuando tiene varias.

Reportes y análisis

• Entregabilidad por período: enviados, entregados, rebotes, quejas, con tasas y tendencia.
• Actividad: listado filtrable de eventos (enviados, rebotes, quejas, aperturas, no aperturas, clics). Incluye consultar el estado de un envío por su identificador.
• Estado y bitácora de un correo puntual: los metadatos de un correo y su bitácora de entrega, por el ID del correo.
• Aperturas y clics por país y por dispositivo.
• Desuscripciones: listado con fecha y motivo, y un desglose por período.
• Estadísticas por remitente: desempeño de un remitente en un período.
• Uso del plan: consumo actual frente al límite de cada recurso (dominios, remitentes, cuota de envío, usuarios). El límite ya considera los complementos. Sirve para saber cuánto le queda antes de un envío grande.

Campañas de email — lectura

• Sus campañas: buscarlas por nombre, estado, lista, remitente o categoría, y saber en qué estado está cada una, cuánto avanzó su envío y, si está pausada, por qué y qué hacer. El avance es el mismo que muestra la plataforma: los correos aceptados sobre los destinatarios estimados.
• Cómo le fue a una campaña: sus cifras y tasas, comparadas con el promedio de sus campañas o con otra campaña, las aperturas y los clics por hora, y los enlaces con más clics.
• Sus resultados agrupados: por dominio de los destinatarios, por tipo y razón de rebote o descarte, y por motivo de baja o de queja, siempre en cifras. Un dominio con pocos correos se suma en «Otros», para que ninguna fila apunte a una persona.
• El asistente no crea, programa, pausa, reanuda ni cancela campañas. Para eso le entrega el enlace a la campaña en la plataforma, donde lo hace en el paso Programación. Para ver quiénes son los contactos detrás de una cifra o descargar un CSV, le entrega el enlace a las Estadísticas de la campaña.

Configuración: lectura, publicación y activación

• Remitentes: los verificados, el detalle de uno puntual (por nombre, email o ID), y su configuración de consentimiento.
• Dominios de envío y su verificación.
• Plantillas: disponibles, su contenido, su historial de versiones, y publicarlas o despublicarlas (habilitarlas o deshabilitarlas para envíos).
• Formularios: los que tiene la instancia y su detalle (ítems, link público, estado), y activarlos o desactivarlos.
• Consentimiento (Ley 21.719): el estado vigente por identificador, el historial de eventos, los términos y las finalidades declaradas. Ese estado es el que consulta un envío antes de descartar un destinatario.
• Campos personalizados que usan los formularios.

Contactos

• Ficha de un contacto: lo que la instancia tiene registrado de un email, teléfono o código único, en una sola respuesta. Incluye si se le puede enviar correo, su consentimiento por finalidad, lo más reciente de sus envíos (con el motivo de un descarte), sus restricciones de envío, desuscripciones y quejas, y sus datasets, con el origen de cada registro. Es la misma información que la Ficha de contacto del panel, con los mismos permisos. Solo la consulta un usuario con el rol operativo Administrador en Mail, y cada consulta que encuentra datos queda en el log de actividad.
• Oposición y bloqueo de un contacto [ACTION]: registrar que un contacto se opone a recibir correos (masivos, transaccionales o ambos), o bloquear temporalmente todos sus envíos mientras se atiende una solicitud suya. Antes de registrar, el agente le muestra la dirección y lo que se detiene, y solo registra si usted lo confirma. Exige el mismo rol que la Ficha de contacto y queda en el log de actividad a su nombre. Un bloqueo solo se levanta desde el panel o al llegar su fecha de término, así que al bloquear indique siempre hasta cuándo. Exportar los datos de un contacto también se hace desde el panel.

Diseño de plantillas

• Crear una plantilla desde cero: el agente escribe el diseño a partir de la especificación del formato y de sus ejemplos, lo revisa con el validador y crea la plantilla como borrador.
• Editarla por partes: cambiar un texto, un botón o una imagen sin reescribir el resto. Cada cambio se apoya en la versión que el agente leyó; si alguien la modificó entretanto, el cambio no se aplica y el agente vuelve a leerla.
• Corregirla con el validador: un diseño con errores no se guarda, y el agente recibe dónde está cada error y cómo corregirlo.
• Previsualizarla antes de guardarla.
• Partir de la biblioteca de plantillas de Fidelizador, cuando usted lo pide.

El agente le muestra la plantilla cuando la crea y cuando un cambio afecta más de dos bloques o reemplaza el diseño completo. Un ajuste menor, como corregir un texto o el enlace de un botón, no la muestra; si quiere verla igual, pídaselo.

El agente trabaja solo con plantillas en borrador: una plantilla publicada no se edita. Cada cambio queda en el historial de versiones. Una plantilla en modo HTML crudo, que guarda su propio HTML tal cual, no se edita por bloques: para cambiarla use el panel o la API. La importación de un HTML existente también se hace desde el panel o la API.

Diseño de formularios

Un formulario pide datos de contacto, consentimiento o ambos. El agente trabaja cada formulario como un solo documento, que reúne todo lo que lo define.

• Crear un formulario completo a partir de su pedido, siguiendo la especificación del formato y sus ejemplos. El documento incluye las preguntas, los textos y el diseño de la página, los correos que envía, el dataset que alimenta y a quién se avisa de cada respuesta. Si necesita un campo que el catálogo no tiene, lo declara en el documento y se crea junto con el formulario.
• Editarlo: el agente parte del formulario como documento, cambia lo pedido y lo envía completo. Lo que falte en el documento se quita del formulario.
• Revisarlo antes de guardar: el validador devuelve los errores, con dónde está cada uno y cómo corregirlo, o el plan completo de lo que se guardaría. El plan indica quién recibe los datos de cada respuesta (opción por opción, si el aviso depende de lo que responde el contacto), los sitios que pueden insertar el formulario, los campos que se crean en el catálogo y el CSS de la página. El agente le muestra ese plan y guarda solo si usted lo confirma.
• Activarlo o desactivarlo: el agente le muestra primero desde qué link y en qué sitios el formulario empezaría a recibir registros, o dejaría de recibirlos, y lo cambia solo si usted lo confirma.

Importante

Editar un formulario activo cambia de inmediato lo que ven sus visitantes, en su link y en los sitios donde está insertado. El plan lo advierte.

Un formulario creado así queda inactivo hasta que se activa. Lo guardado tiene que ser exactamente el plan que usted vio: si el documento, el formulario o algo que nombra cambió después de la revisión, no se guarda y el agente debe revisarlo y mostrárselo de nuevo.

El agente usa los términos, plantillas, remitentes y datasets que ya existen, y no modifica los campos del catálogo. La misma operación está disponible desde el panel, con cualquier asistente. La guía es Formularios con un asistente de IA.

Datasets

• Ver los datasets de la instancia, sus columnas y sus contactos. Buscar por el identificador, exacto o por cómo empieza, responde al instante. Otras búsquedas pueden tardar en un dataset muy grande.
• Crear un dataset con sus columnas, y sumarle columnas después. Si los canales del dataset no definen por cuál identificador reconoce a un contacto (correo, teléfono o código único) y usted no lo indicó, el agente se lo pregunta. Ese identificador no se puede cambiar después.
• Agregar un contacto. Se valida igual que desde un formulario o la API, contra las columnas y las reglas de cada campo. Puede tardar hasta un minuto en aparecer en el dataset.
• Crear un campo en el catálogo, para usarlo como columna.

Desde el agente las columnas y los campos solo se agregan: quitar una columna, volverla obligatoria, o editar o desactivar un campo se hace en el panel.

Listas

• Ver las listas de la instancia y el detalle de una: sus columnas, el estado de su importación con las filas importadas, rechazadas y duplicadas, y sus copias a datasets.

• Crear una lista y cargarle un archivo CSV, plano o comprimido en gzip, zip o 7z, desde:

  • una URL pública https;
  • un enlace de OneDrive o SharePoint, tal como se copia, compartido como «Cualquier persona con el vínculo» (el diálogo de compartir indica «El vínculo funciona para cualquier persona»). Un enlace compartido solo con su organización pide iniciar sesión y no sirve.
  • una planilla de Google Sheets o un archivo de Google Drive, con su enlace tal como se copia. Una planilla compartida como «Cualquier persona con el enlace» se carga directamente, desde la pestaña que indica el enlace o, si no indica ninguna, desde la primera. Si no está compartida así, se carga con la misma autorización de solo lectura que la carga de destinatarios.

  El archivo pasa directamente a la plataforma: el agente solo recibe sus primeras líneas, para proponer las columnas.

  • Una planilla de Excel se guarda antes como CSV.
  • Un archivo que está en su equipo se sube desde la pantalla de la lista en el panel. El agente le entrega el enlace a esa pantalla y después continúa con la lista.
  • Con el archivo cargado, el agente le muestra las primeras líneas y el campo que propone para cada columna, y declara las columnas con su visto bueno. Si una columna necesita un campo nuevo, lo crea en el catálogo.
  • Una lista recibe datos una sola vez. Si la carga falla, la lista sigue vacía y el agente puede cargar en ella el archivo corregido.

• Combinar listas en una nueva, copiar un dataset a una lista nueva y copiar una lista a un dataset. La copia a un dataset escribe los contactos bajo la política de colisión del dataset y lleva solo las columnas que el dataset declara: si a la lista le sobra alguna, el agente se lo indica antes de copiar, para agregarla al dataset o copiar sin ella. Repetir una copia ya hecha a ese dataset pide su confirmación en el chat.

• Exportar una lista: el archivo no llega a la conversación, porque contiene datos de contactos. El agente le entrega el enlace a la lista en el panel, desde donde se descarga.

Las importaciones, combinaciones y copias corren en segundo plano, y el agente las sigue hasta que terminan. Ver las filas de una lista y descargar las filas rechazadas de una importación se hace en el panel.

Crear, editar o eliminar remitentes y dominios, y eliminar cualquier recurso (una plantilla, un formulario, un dataset, una lista, una columna o un campo), solo se puede hacer desde el panel. Cambiar el link público de un formulario también se hace desde el panel.

Envío

• Enviar un correo a uno o varios destinatarios, por ejemplo un boletín o una notificación a un conjunto de clientes. Cada destinatario recibe su propio correo y no ve las direcciones de los demás. El envío usa un remitente masivo de la instancia. Si el envío supera el umbral de volumen (por defecto, más de 5 destinatarios), se pide confirmación en el chat (ver Enviar correos).
• Los correos transaccionales, como la recuperación de una contraseña o una boleta, no se envían desde aquí: los envía su aplicación por la API o por SMTP cuando ocurre el evento que los origina.

Sandbox

• Consultar el catálogo de escenarios que se pueden simular.
• Simular un envío sin tocar destinatarios reales y ver sus métricas. Sirve para validar la integración antes de un envío real. Cada simulación admite hasta 200 destinatarios por defecto; para una más grande, el agente la divide en varias.

El propio servidor expone al agente el catálogo vigente de herramientas y sus parámetros. La tabla de abajo es la referencia legible para una persona.

Seguridad y límites

• Aislamiento por instancia: el agente opera solo sobre las instancias a las que su usuario tiene acceso. El servidor valida la autorización con su sesión. Un intento de operar una instancia ajena se rechaza.
• Al cargar destinatarios, el agente no los recibe todos: recibe una referencia, la cantidad de destinatarios, el tipo de origen y una vista previa de los primeros 5. Los destinatarios quedan almacenados temporalmente en el servidor y send_mail los usa mediante esa referencia. Los destinatarios que escriba directamente en el chat pasan por el agente, como todo lo que le escribe.
• Respeta la restricción de red de la instancia: si la instancia tiene una lista de IPs permitidas, el servidor la aplica a cada llamada del agente, igual que a la aplicación web. La dirección que evalúa es la del cliente de IA:
  • Un cliente que corre en su equipo, como Claude Code, llega con la IP de su red.
  • Un conector remoto, como el de Claude.ai, llega desde la red de su proveedor. Para usarlo con una instancia restringida, agregue esa red a la lista. El rango de salida de los conectores de Claude.ai es 160.79.104.0/21.
• El archivo de una lista no pasa por el agente: va directamente a la plataforma, sin guardarse en el servidor MCP. El agente sí recibe las primeras líneas, para proponer las columnas, y esas líneas llegan al proveedor del agente de IA como cualquier otra respuesta. La exportación de una lista nunca llega a la conversación.
• La ficha de un contacto contiene datos personales: la respuesta reúne lo que la instancia guarda de esa persona y llega al proveedor del agente de IA, como cualquier otra respuesta. El agente la consulta solo cuando usted nombra al contacto. La consulta exige el mismo rol que la Ficha de contacto del panel (Administrador en Mail) y, si encuentra datos, queda en el log de actividad igual que desde ahí.
• Las credenciales de terceros no pasan por el agente: la autorización de Google se hace fuera del agente y solo otorga permiso de lectura.
• Confirmación sobre el umbral de volumen: ver Enviar correos.
• Un formulario se guarda solo con el plan que usted confirmó: el plan nombra cada dirección que recibe los datos personales de los envíos y cada sitio que puede insertar el formulario, así que una dirección agregada sin que usted la pidiera queda a la vista antes de guardar. Revise esas dos partes antes de confirmar, aunque el resto del plan sea lo que pidió.
• Límites que fija Fidelizador: al alcanzar uno, el agente recibe un aviso.
  • Llamadas por minuto. El valor es el mismo para todas las instancias y se cuenta por separado en cada una.
  • Destinatarios por envío o por carga.
  • Volumen a partir del cual se pide confirmación.
  • Destinatarios por simulación en sandbox.
• Límites de la descarga de un archivo: al cargar destinatarios, un tamaño máximo de archivo y un tiempo máximo total. El tamaño se mide tanto en lo transferido como en lo descomprimido, para que un archivo comprimido no exceda el tope al expandirse. El archivo de una lista tiene su propio tamaño máximo, el mismo que acepta la plataforma, y su propio tiempo máximo, que incluye la descarga y el envío a la plataforma: un archivo más grande se divide en varias listas que después se combinan, y uno de un origen más lento se sube desde el panel. En los dos casos el origen debe ser https: una URL http, o una https que redirija a http, se rechaza, porque sobre texto plano un tercero puede alterar la lista de destinatarios en tránsito.