Telinfy MCP server

Guía de Integración de Telinfy MCP

Cómo conectar y usar el servidor Telinfy MCP con asistentes de IA

El servidor Telinfy MCP proporciona acceso programático a las capacidades de mensajería SMS, WhatsApp y RCS de Telinfy, permitiendo a los asistentes de IA enviar mensajes, gestionar contactos, programar campañas y obtener informes en tu nombre.

---

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a las aplicaciones de IA conectarse de forma segura a fuentes de datos y herramientas compatibles con MCP. Piensa en MCP como un puerto USB-C para aplicaciones de IA: una forma estandarizada de conectar aplicaciones de IA a diferentes servicios.

---

Servidor Telinfy MCP

El servidor Telinfy MCP es un servicio seguro y autenticado que proporciona acceso a tu plataforma de mensajería Telinfy.

URL Base del Servidor: https://mcp.telinfy.com/sse

Autenticación Requerida

Para usar el servidor Telinfy MCP, necesitas:

• Nombre de usuario de Telinfy
• Contraseña de Telinfy
• Credenciales API (se obtienen automáticamente después de iniciar sesión)

---

Herramientas Disponibles

El servidor Telinfy MCP ofrece herramientas integrales de mensajería y gestión de campañas:

Operaciones SMS

1. send_sms - Enviar mensajes SMS con cumplimiento DLT
2. schedule_sms - Programar campañas SMS para entrega futura
3. scheduleDynamicCampaign - Programar campañas SMS dinámicas usando archivos Excel y variables de plantilla
4. get_sms_schedule - Ver todas las campañas SMS programadas
5. fetch_sms_campaign_report - Obtener informes detallados de campañas SMS

Operaciones WhatsApp

1. send_whatsapp_campaign - Enviar mensajes de WhatsApp usando plantillas predefinidas
2. whatsapp_campaign - Listar todas las campañas de WhatsApp
3. fetch_whatsapp_smart_report - Obtener informes de campañas de WhatsApp con filtrado por fecha

Operaciones RCS

1. fetch_rcs_report - Recuperar informes de mensajes RCS con filtrado por fecha

Gestión de Contactos

1. create_phonebook - Crear nuevos grupos de agenda telefónica con contactos
2. get_phonebook_groups - Listar todos los grupos de la agenda telefónica
3. get_group_contacts - Ver contactos dentro de un grupo específico
4. edit_contact - Actualizar información de contacto
5. toggle_contact_status - Activar/desactivar contactos en un grupo
6. delete_contact_group - Eliminar grupos de la agenda telefónica

Informes de Mensajes

1. getMessageReport - Obtener informes de entrega de mensajes y estado de mensajes enviados

Autenticación

1. login_to_telinfy - Autenticar y establecer una sesión con la plataforma Telinfy

---

Protocolo de Comunicación

El servidor Telinfy MCP utiliza el protocolo SSE (Eventos Enviados por el Servidor):

SSE (Server-Sent Events) - /sse

• URL: https://mcp.telinfy.com/sse
• La versión oficial de la especificación MCP
• Compatible con Claude, Windsurf, Cursor y otros clientes MCP
• Recomendado para todas las integraciones

---

Instrucciones de Configuración

Para Claude Desktop/Web:

1. Ve a la configuración de Claude
2. Navega a "Integraciones" o "Conexiones"
3. Agrega un nuevo servidor MCP con estos detalles:
   • Nombre: Telinfy
   • URL del Servidor: https://mcp.telinfy.com/sse
4. Guarda la configuración

Para Claude Code (Línea de Comandos):

claude mcp add -s user -t http telinfy https://mcp.telinfy.com/sse

Para Windsurf, Cursor u otros clientes MCP:

Agrega esta configuración a tu archivo de configuración MCP:

{ "mcpServers": { "telinfy": { "serverUrl": "https://mcp.telinfy.com/sse" } } }

---

Uso de Telinfy MCP

Configuración Inicial

Después de conectar el servidor MCP, necesitarás autenticarte con tus credenciales de Telinfy:

Claude, please log me into Telinfy using my username and password.

El asistente de IA usará la herramienta login_to_telinfy para establecer una sesión segura.

Casos de Uso de Ejemplo

Enviar una Campaña SMS

Send an SMS to +919876543210 with the message "Your OTP is 123456" 
using sender name "NOTIFY" and template ID "1234567890"

Programar una Campaña de Marketing

Schedule an SMS campaign named "Weekend Sale" to be sent tomorrow at 10 AM 
to these numbers: +919876543210, +919876543211 with the message 
"Flash Sale this weekend! 50% off. Visit now."

Crear un Grupo de Contactos

Create a new phonebook group called "VIP Customers" with these contacts:
- John Doe, +919876543210
- Jane Smith, +919876543211

Enviar Mensajes de WhatsApp

Send a WhatsApp campaign using my "order_confirmation" template 
to +919876543210 with customer name "John" and order number "ORD123"

Obtener Informes de Campaña

Show me the SMS campaign report for campaign ID "12345"

Obtener Estado de Entrega de Mensajes

Get the delivery status for all messages sent today

---

Características Clave

Cumplimiento DLT

Todas las campañas SMS soportan cumplimiento DLT (Tecnología de Libro Mayor Distribuido) con IDs de plantilla y nombres de remitente, asegurando el cumplimiento normativo en India.

Campañas Dinámicas

Programa campañas SMS personalizadas usando archivos Excel con sustitución de variables, perfecto para mensajería masiva personalizada.

Mensajería Multicanal

• SMS - Rutas promocionales y transaccionales
• WhatsApp - Mensajería empresarial basada en plantillas
• RCS - Servicios de Comunicación Enriquecida

Informes Completos

Rastrea la entrega de mensajes, el rendimiento de campañas y genera informes detallados con filtrado por fecha.

Organiza contactos en grupos, activa/desactiva contactos y mantén listas de agenda telefónica limpias.

---

Seguridad y Autenticación

• Todas las llamadas API se autentican usando tus credenciales de Telinfy
• Autenticación segura basada en tokens después del inicio de sesión inicial
• Las sesiones se mantienen durante la duración de tu conversación
• El asistente de IA no almacena credenciales

---

Soporte y Recursos

• Panel de Telinfy: https://telinfy.com
• Documentación API: Contacta al soporte de Telinfy para documentación API detallada
• Protocolo MCP: https://modelcontextprotocol.io
• Soporte: Contacta a tu gerente de cuenta de Telinfy

---

Solución de Problemas

Problemas de Autenticación

Si encuentras problemas de inicio de sesión:

1. Verifica que tu nombre de usuario y contraseña sean correctos
2. Comprueba si tu cuenta tiene habilitado el acceso API
3. Contacta al soporte de Telinfy para asegurar que tu cuenta tenga acceso MCP

Problemas de Conexión

Si el servidor MCP no se conecta:

1. Verifica que la URL del servidor sea exactamente: https://mcp.telinfy.com/sse
2. Comprueba tu conexión a internet
3. Intenta reconectar el servidor MCP en la configuración de tu cliente de IA

Problemas de Entrega de Mensajes

Si los mensajes no se envían:

1. Asegúrate de tener créditos suficientes en tu cuenta de Telinfy
2. Verifica que los IDs de plantilla DLT estén correctamente registrados
3. Comprueba que los nombres de remitente estén aprobados en tu cuenta de Telinfy
4. Confirma que los números de teléfono estén en el formato correcto

---

Mejores Prácticas

1. Siempre inicia sesión primero - Autentícate al inicio de cada sesión
2. Usa IDs de plantilla correctos - Asegúrate de que las plantillas DLT coincidan con el contenido de tu mensaje
3. Verifica formatos de teléfono - Usa números indios de 10 dígitos o formato internacional con código de país
4. Revisa informes de campaña - Monitorea el estado de entrega regularmente
5. Gestiona contactos eficientemente - Mantén los grupos de la agenda telefónica organizados
6. Prueba antes del envío masivo - Envía mensajes de prueba antes de campañas grandes

---

Flujo de Trabajo de Ejemplo

Aquí hay un flujo de trabajo completo para enviar una campaña:

1. Autenticar

Log me into Telinfy with username "myuser" and password "mypass"  

2. Crear Grupo de Contactos

Create a phonebook group "Spring Sale 2024" with my customer list  

3. Programar Campaña

Schedule an SMS campaign "Spring Sale Announcement" to the "Spring Sale 2024"  
group for tomorrow at 9 AM with message "Exclusive Spring Sale! 40% off all items.  
Shop now at example.com" using sender "RETAIL" and template "1234567890"  

4. Monitorear Resultados

Show me the delivery report for the Spring Sale campaign  

---

Funciones Avanzadas

Sustitución Dinámica de Variables

Usa archivos Excel para enviar mensajes personalizados a escala:

• Sube Excel con columnas: Móvil, Nombre, IDPedido, Monto
• Mapea variables: {{1}} = Nombre, {{2}} = IDPedido, {{3}} = Monto
• Plantilla: "Hola {{1}}, tu pedido {{2}} de ${{3}} está confirmado"

SMS Multiruta

• Ruta 0: Mensajes promocionales
• Ruta 1: Mensajes transaccionales (OTPs, alertas)

Soporte Unicode

Envía mensajes en idiomas regionales habilitando el modo Unicode.

---

Lista de Verificación para Comenzar

• Conecta el servidor Telinfy MCP a tu asistente de IA
• Autentícate con tus credenciales de Telinfy
• Verifica que tengas nombres de remitente y plantillas DLT activos
• Revisa tu saldo de cuenta y créditos
• Prueba con un solo SMS antes de campañas masivas
• Crea grupos de agenda telefónica organizados
• Configura campañas programadas para un momento óptimo
• Monitorea informes regularmente

---

Para especificaciones API detalladas y referencias de parámetros, consulta la documentación API de Telinfy o contacta a tu gerente de cuenta.