Telinfy MCP server

Guide d'intégration Telinfy MCP

Comment connecter et utiliser le serveur Telinfy MCP avec des assistants IA

Le serveur Telinfy MCP fournit un accès programmatique aux capacités de messagerie SMS, WhatsApp et RCS de Telinfy, permettant aux assistants IA d'envoyer des messages, de gérer des contacts, de planifier des campagnes et de récupérer des rapports en votre nom.

---

Qu'est-ce que MCP ?

Le Model Context Protocol (MCP) est une norme ouverte qui permet aux applications d'IA de se connecter de manière sécurisée à des sources de données et des outils compatibles MCP. Considérez MCP comme un port USB-C pour les applications d'IA — une manière standardisée de connecter des applications d'IA à différents services.

---

Serveur Telinfy MCP

Le serveur Telinfy MCP est un service sécurisé et authentifié qui fournit un accès à votre plateforme de messagerie Telinfy.

URL de base du serveur : https://mcp.telinfy.com/sse

Authentification requise

Pour utiliser le serveur Telinfy MCP, vous avez besoin de :

• Nom d'utilisateur Telinfy
• Mot de passe Telinfy
• Identifiants API (récupérés automatiquement après connexion)

---

Outils disponibles

Le serveur Telinfy MCP offre des outils complets de messagerie et de gestion de campagnes :

Opérations SMS

1. send_sms - Envoyer des messages SMS avec conformité DLT
2. schedule_sms - Planifier des campagnes SMS pour une livraison future
3. scheduleDynamicCampaign - Planifier des campagnes SMS dynamiques à l'aide de fichiers Excel et de variables de modèle
4. get_sms_schedule - Voir toutes les campagnes SMS planifiées
5. fetch_sms_campaign_report - Obtenir des rapports détaillés pour les campagnes SMS

Opérations WhatsApp

6. send_whatsapp_campaign - Envoyer des messages WhatsApp à l'aide de modèles pré-créés
7. whatsapp_campaign - Lister toutes les campagnes WhatsApp
8. fetch_whatsapp_smart_report - Obtenir des rapports de campagne WhatsApp avec filtrage par date

Opérations RCS

9. fetch_rcs_report - Récupérer les rapports de messages RCS avec filtrage par date

Gestion des contacts

10. create_phonebook - Créer de nouveaux groupes de répertoire avec des contacts
11. get_phonebook_groups - Lister tous les groupes de répertoire
12. get_group_contacts - Voir les contacts dans un groupe spécifique
13. edit_contact - Mettre à jour les informations de contact
14. toggle_contact_status - Activer/désactiver les contacts dans un groupe
15. delete_contact_group - Supprimer des groupes de répertoire

Rapports de messages

16. getMessageReport - Récupérer les rapports de livraison et le statut des messages envoyés

Authentification

17. login_to_telinfy - S'authentifier et établir une session avec la plateforme Telinfy

---

Protocole filaire

Le serveur Telinfy MCP utilise le protocole SSE (Server-Sent Events) :

SSE (Server-Sent Events) - /sse

• URL : https://mcp.telinfy.com/sse
• La version officielle de la spécification MCP
• Pris en charge par Claude, Windsurf, Cursor et d'autres clients MCP
• Recommandé pour toutes les intégrations

---

Instructions de configuration

Pour Claude Desktop/Web :

1. Allez dans vos paramètres Claude
2. Naviguez vers « Intégrations » ou « Connexions »
3. Ajoutez un nouveau serveur MCP avec ces détails :
   • Nom : Telinfy
     • URL du serveur : https://mcp.telinfy.com/sse
4. Enregistrez la configuration

Pour Claude Code (ligne de commande) :

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

Pour Windsurf, Cursor ou d'autres clients MCP :

Ajoutez cette configuration à votre fichier de paramètres MCP :

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

---

Utilisation de Telinfy MCP

Configuration initiale

Après avoir connecté le serveur MCP, vous devrez vous authentifier avec vos identifiants Telinfy :

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

L'assistant IA utilisera l'outil login_to_telinfy pour établir une session sécurisée.

Exemples de cas d'utilisation

Envoyer une campagne SMS

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

Planifier une campagne 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."

Créer un groupe de contacts

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

Envoyer des messages WhatsApp

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

Obtenir des rapports de campagne

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

Récupérer le statut de livraison des messages

Get the delivery status for all messages sent today

---

Fonctionnalités clés

Conformité DLT

Toutes les campagnes SMS prennent en charge la conformité DLT (Distributed Ledger Technology) avec des identifiants de modèle et des noms d'expéditeur, garantissant la conformité réglementaire en Inde.

Campagnes dynamiques

Planifiez des campagnes SMS personnalisées à l'aide de fichiers Excel avec substitution de variables, idéal pour la messagerie personnalisée en masse.

Messagerie multicanal

• SMS - Itinéraires promotionnels et transactionnels
• WhatsApp - Messagerie professionnelle basée sur des modèles
• RCS - Services de communication enrichis

Rapports complets

Suivez la livraison des messages, les performances des campagnes et générez des rapports détaillés avec filtrage par date.

Gestion des contacts

Organisez les contacts en groupes, activez/désactivez les contacts et maintenez des listes de répertoire propres.

---

Sécurité et authentification

• Tous les appels API sont authentifiés à l'aide de vos identifiants Telinfy
• Authentification sécurisée basée sur des jetons après la connexion initiale
• Les sessions sont maintenues pendant la durée de votre conversation
• Aucun identifiant n'est stocké par l'assistant IA

---

Support et ressources

• Tableau de bord Telinfy : https://telinfy.com
• Documentation API : Contactez le support Telinfy pour des documents API détaillés
• Protocole MCP : https://modelcontextprotocol.io
• Support : Contactez votre gestionnaire de compte Telinfy

---

Dépannage

Problèmes d'authentification

Si vous rencontrez des problèmes de connexion :

1. Vérifiez que votre nom d'utilisateur et votre mot de passe sont corrects
2. Vérifiez si votre compte a l'accès API activé
3. Contactez le support Telinfy pour vous assurer que votre compte a accès à MCP

Problèmes de connexion

Si le serveur MCP ne se connecte pas :

1. Vérifiez que l'URL du serveur est exactement : https://mcp.telinfy.com/sse
2. Vérifiez votre connexion Internet
3. Essayez de reconnecter le serveur MCP dans les paramètres de votre client IA

Problèmes de livraison de messages

Si les messages ne sont pas envoyés :

1. Assurez-vous d'avoir suffisamment de crédits sur votre compte Telinfy
2. Vérifiez que les identifiants de modèle DLT sont correctement enregistrés
3. Vérifiez que les noms d'expéditeur sont approuvés dans votre compte Telinfy
4. Confirmez que les numéros de téléphone sont au format correct

---

Meilleures pratiques

1. Connectez-vous toujours en premier - Authentifiez-vous au début de chaque session
2. Utilisez des identifiants de modèle corrects - Assurez-vous que les modèles DLT correspondent au contenu de votre message
3. Vérifiez les formats de téléphone - Utilisez des numéros indiens à 10 chiffres ou le format international avec l'indicatif du pays
4. Consultez les rapports de campagne - Surveillez régulièrement le statut de livraison
5. Gérez les contacts efficacement - Gardez les groupes de répertoire organisés
6. Testez avant l'envoi en masse - Envoyez des messages de test avant les grandes campagnes

---

Exemple de flux de travail

Voici un flux de travail complet pour envoyer une campagne :

1. S'authentifier

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

2. Créer un groupe de contacts

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

3. Planifier la campagne

   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. Surveiller les résultats

   Show me the delivery report for the Spring Sale campaign
   

---

Fonctionnalités avancées

Substitution de variables dynamiques

Utilisez des fichiers Excel pour envoyer des messages personnalisés à grande échelle :

• Téléchargez un Excel avec les colonnes : Mobile, Nom, IDCommande, Montant
• Mappez les variables : {{1}} = Nom, {{2}} = IDCommande, {{3}} = Montant
• Modèle : « Bonjour {{1}}, votre commande {{2}} de Rs.{{3}} est confirmée »

SMS multi-itinéraires

• Itinéraire 0 : Messages promotionnels
• Itinéraire 1 : Messages transactionnels (OTP, alertes)

Prise en charge Unicode

Envoyez des messages dans les langues régionales en activant le mode Unicode.

---

Liste de contrôle pour démarrer

• Connectez le serveur Telinfy MCP à votre assistant IA
• Authentifiez-vous avec vos identifiants Telinfy
• Vérifiez que vous avez des noms d'expéditeur et des modèles DLT actifs
• Vérifiez le solde et les crédits de votre compte
• Testez avec un seul SMS avant les campagnes en masse
• Créez des groupes de répertoire organisés
• Configurez des campagnes planifiées pour un timing optimal
• Surveillez les rapports régulièrement

---

Pour les spécifications API détaillées et les références de paramètres, consultez la documentation API Telinfy ou contactez votre gestionnaire de compte.