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 recuperar 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 de API (recuperadas automáticamente después del inicio de 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 de WhatsApp

6. send_whatsapp_campaign - Enviar mensajes de WhatsApp usando plantillas precreadas
7. whatsapp_campaign - Listar todas las campañas de WhatsApp
8. fetch_whatsapp_smart_report - Obtener informes de campañas de WhatsApp con filtrado por fecha

Operaciones RCS

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

Gestión de contactos

10. create_phonebook - Crear nuevos grupos de libreta de contactos con contactos
11. get_phonebook_groups - Listar todos los grupos de libreta de contactos
12. get_group_contacts - Ver contactos dentro de un grupo específico
13. edit_contact - Actualizar información de contacto
14. toggle_contact_status - Habilitar/deshabilitar contactos en un grupo
15. delete_contact_group - Eliminar grupos de libreta de contactos

Informes de mensajes

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

Autenticación

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

---

Protocolo de conexión

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

SSE (Eventos enviados por el servidor) - /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. Añade 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:

Añade 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, deberás autenticarte con tus credenciales de Telinfy:

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

El asistente de IA utilizará 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ñas

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 admiten cumplimiento DLT (Tecnología de Libro Mayor Distribuido) con IDs de plantilla y nombres de remitente, garantizando el cumplimiento normativo en India.

Campañas dinámicas

Programa campañas SMS personalizadas usando archivos Excel con sustitución de variables, perfecto para mensajes personalizados masivos.

Mensajería multicanal

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

Informes integrales

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

Gestión de contactos

Organiza contactos en grupos, habilita/deshabilita contactos y mantén listas de libreta de contactos limpias.

---

Seguridad y autenticación

• Todas las llamadas API se autentican con 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 ninguna credencial

---

Soporte y recursos

• Panel de Telinfy: https://telinfy.com
• Documentación de API: Contacta con el soporte de Telinfy para obtener documentación detallada de la API
• Protocolo MCP: https://modelcontextprotocol.io
• Soporte: Contacta con tu gestor de cuentas 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 a la API
3. Contacta con el soporte de Telinfy para asegurarte de 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 registrados correctamente
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. Inicia sesión siempre primero - Autentícate al comienzo 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 los formatos de teléfono - Usa números indios de 10 dígitos o formato internacional con código de país
4. Revisa los informes de campaña - Supervisa el estado de entrega regularmente
5. Gestiona los contactos de manera eficiente - Mantén los grupos de libreta de contactos organizados
6. Prueba antes del envío masivo - Envía mensajes de prueba antes de campañas grandes

---

Flujo de trabajo de ejemplo

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

1. Autentícate

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

2. Crea un grupo de contactos

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

3. Programa la 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. Supervisa los resultados

   Show me the delivery report for the Spring Sale campaign
   

---

Características avanzadas

Sustitución dinámica de variables

Usa archivos Excel para enviar mensajes personalizados a escala:

• Sube un Excel con columnas: Mobile, Name, OrderID, Amount
• Asigna variables: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount
• Plantilla: "Hola {{1}}, tu pedido {{2}} de Rs.{{3}} está confirmado"

SMS de múltiples rutas

• 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
• Comprueba el saldo y los créditos de tu cuenta
• Prueba con un solo SMS antes de campañas masivas
• Crea grupos de libreta de contactos organizados
• Configura campañas programadas para un momento óptimo
• Supervisa los informes regularmente

---

Para especificaciones detalladas de la API y referencias de parámetros, consulta la documentación de la API de Telinfy o contacta con tu gestor de cuentas.