Telinfy MCP server

officiel

Envoyez des SMS, WhatsApp et RCS par programmation avec conformité DLT. Gérez les contacts, planifiez des campagnes et suivez les rapports de livraison.

GitHub

Documentation

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 un standard ouvert qui permet aux applications 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 IA - une manière standardisée de connecter les applications IA à différents services.

Serveur Telinfy MCP

Le serveur Telinfy MCP est un service sécurisé et authentifié qui donne 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 la 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 en utilisant des fichiers Excel et des 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

  1. send_whatsapp_campaign - Envoyer des messages WhatsApp en utilisant des modèles pré-créés
  2. whatsapp_campaign - Lister toutes les campagnes WhatsApp
  3. fetch_whatsapp_smart_report - Obtenir des rapports de campagne WhatsApp avec filtrage par date

Opérations RCS

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

Gestion des contacts

  1. create_phonebook - Créer de nouveaux groupes de répertoire avec des contacts
  2. get_phonebook_groups - Lister tous les groupes de répertoire
  3. get_group_contacts - Voir les contacts dans un groupe spécifique
  4. edit_contact - Mettre à jour les informations de contact
  5. toggle_contact_status - Activer/désactiver des contacts dans un groupe
  6. delete_contact_group - Supprimer des groupes de répertoire

Rapports de messages

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

Authentification

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

Protocole de communication

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. Sauvegardez 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, assurant la conformité réglementaire en Inde.

Campagnes dynamiques

Planifiez des campagnes SMS personnalisées en utilisant des fichiers Excel avec substitution de variables, parfait pour la messagerie personnalisée en masse.

Messagerie multi-canal

  • SMS - Routes promotionnelles et transactionnelles
  • WhatsApp - Messagerie d'entreprise basée sur des modèles
  • RCS - Services de communication enrichis

Rapports complets

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

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

Sécurité et authentification

  • Tous les appels API sont authentifiés en utilisant vos identifiants Telinfy
  • Authentification sécurisée par jeton 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

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 l'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 dans 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. Toujours se connecter d'abord - Authentifiez-vous au début de chaque session
  2. Utiliser les bons identifiants de modèle - Assurez-vous que les modèles DLT correspondent au contenu de votre message
  3. Vérifier les formats de téléphone - Utilisez des numéros indiens à 10 chiffres ou le format international avec l'indicatif du pays
  4. Vérifier les rapports de campagne - Surveillez régulièrement le statut de livraison
  5. Gérer les contacts efficacement - Gardez les groupes de répertoire organisés
  6. Tester 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"
  1. Créer un groupe de contacts
Create a phonebook group "Spring Sale 2024" with my customer list
  1. 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"
  1. Surveiller les résultats
Show me the delivery report for the Spring Sale campaign

Fonctionnalités avancées

Substitution dynamique de variables

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

  • Téléchargez un fichier 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-route

  • Route 0 : Messages promotionnels
  • Route 1 : Messages transactionnels (OTP, alertes)

Support Unicode

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

Liste de vérification 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 de votre compte et vos crédits
  • 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, reportez-vous à la documentation de l'API Telinfy ou contactez votre gestionnaire de compte.