Telinfy MCP server

Telinfy MCP-Integrationsleitfaden

So verbinden und verwenden Sie den Telinfy MCP-Server mit KI-Assistenten

Der Telinfy MCP-Server bietet programmatischen Zugriff auf die SMS-, WhatsApp- und RCS-Messaging-Funktionen von Telinfy und ermöglicht es KI-Assistenten, Nachrichten zu senden, Kontakte zu verwalten, Kampagnen zu planen und Berichte in Ihrem Namen abzurufen.

---

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Anwendungen ermöglicht, sich sicher mit MCP-kompatiblen Datenquellen und Tools zu verbinden. Stellen Sie sich MCP wie einen USB-C-Anschluss für KI-Anwendungen vor – eine standardisierte Möglichkeit, KI-Apps mit verschiedenen Diensten zu verbinden.

---

Telinfy MCP-Server

Der Telinfy MCP-Server ist ein sicherer, authentifizierter Dienst, der Zugriff auf Ihre Telinfy-Messaging-Plattform bietet.

Basis-Server-URL: https://mcp.telinfy.com/sse

Authentifizierung erforderlich

Um den Telinfy MCP-Server zu nutzen, benötigen Sie:

• Telinfy-Benutzername
• Telinfy-Passwort
• API-Anmeldedaten (werden nach dem Login automatisch abgerufen)

---

Verfügbare Tools

Der Telinfy MCP-Server bietet umfassende Messaging- und Kampagnenverwaltungstools:

SMS-Operationen

1. send_sms – SMS-Nachrichten mit DLT-Konformität senden
2. schedule_sms – SMS-Kampagnen für die zukünftige Zustellung planen
3. scheduleDynamicCampaign – Dynamische SMS-Kampagnen mithilfe von Excel-Dateien und Vorlagenvariablen planen
4. get_sms_schedule – Alle geplanten SMS-Kampagnen anzeigen
5. fetch_sms_campaign_report – Detaillierte Berichte für SMS-Kampagnen abrufen

WhatsApp-Operationen

6. send_whatsapp_campaign – WhatsApp-Nachrichten mithilfe vorgefertigter Vorlagen senden
7. whatsapp_campaign – Alle WhatsApp-Kampagnen auflisten
8. fetch_whatsapp_smart_report – WhatsApp-Kampagnenberichte mit Datumsfilterung abrufen

RCS-Operationen

9. fetch_rcs_report – RCS-Nachrichtenberichte mit Datumsfilterung abrufen

Kontaktverwaltung

10. create_phonebook – Neue Telefonbuchgruppen mit Kontakten erstellen
11. get_phonebook_groups – Alle Telefonbuchgruppen auflisten
12. get_group_contacts – Kontakte innerhalb einer bestimmten Gruppe anzeigen
13. edit_contact – Kontaktinformationen aktualisieren
14. toggle_contact_status – Kontakte in einer Gruppe aktivieren/deaktivieren
15. delete_contact_group – Telefonbuchgruppen entfernen

Nachrichtenberichte

16. getMessageReport – Zustellberichte und Status für gesendete Nachrichten abrufen

Authentifizierung

17. login_to_telinfy – Authentifizieren und eine Sitzung mit der Telinfy-Plattform aufbauen

---

Drahtprotokoll

Der Telinfy MCP-Server verwendet das SSE-Protokoll (Server-Sent Events):

SSE (Server-Sent Events) – /sse

• URL: https://mcp.telinfy.com/sse
• Die offizielle MCP-Spezifikationsversion
• Unterstützt von Claude, Windsurf, Cursor und anderen MCP-Clients
• Für alle Integrationen empfohlen

---

Einrichtungsanweisungen

Für Claude Desktop/Web:

1. Gehen Sie zu Ihren Claude-Einstellungen
2. Navigieren Sie zu „Integrationen" oder „Verbindungen"
3. Fügen Sie einen neuen MCP-Server mit diesen Details hinzu:
   • Name: Telinfy
     • Server-URL: https://mcp.telinfy.com/sse
4. Speichern Sie die Konfiguration

Für Claude Code (Befehlszeile):

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

Für Windsurf, Cursor oder andere MCP-Clients:

Fügen Sie diese Konfiguration zu Ihrer MCP-Einstellungsdatei hinzu:

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

---

Verwendung von Telinfy MCP

Ersteinrichtung

Nach dem Verbinden des MCP-Servers müssen Sie sich mit Ihren Telinfy-Anmeldedaten authentifizieren:

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

Der KI-Assistent verwendet das Tool login_to_telinfy, um eine sichere Sitzung aufzubauen.

Beispiel-Anwendungsfälle

Eine SMS-Kampagne senden

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

Eine Marketingkampagne planen

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."

Eine Kontaktgruppe erstellen

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

WhatsApp-Nachrichten senden

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

Kampagnenberichte abrufen

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

Zustellstatus von Nachrichten abrufen

Get the delivery status for all messages sent today

---

Hauptfunktionen

DLT-Konformität

Alle SMS-Kampagnen unterstützen die DLT-Konformität (Distributed Ledger Technology) mit Vorlagen-IDs und Absendernamen, wodurch die Einhaltung gesetzlicher Vorschriften in Indien gewährleistet wird.

Dynamische Kampagnen

Planen Sie personalisierte SMS-Kampagnen mithilfe von Excel-Dateien mit Variablensubstitution – ideal für massenhafte personalisierte Nachrichten.

Multi-Kanal-Messaging

• SMS – Werbe- und Transaktionsrouten
• WhatsApp – Vorlagenbasiertes Geschäftsmessaging
• RCS – Rich Communication Services

Umfassende Berichterstattung

Verfolgen Sie Nachrichtenzustellung, Kampagnenleistung und erstellen Sie detaillierte Berichte mit Datumsfilterung.

Kontaktverwaltung

Organisieren Sie Kontakte in Gruppen, aktivieren/deaktivieren Sie Kontakte und pflegen Sie saubere Telefonbuchlisten.

---

Sicherheit & Authentifizierung

• Alle API-Aufrufe werden mit Ihren Telinfy-Anmeldedaten authentifiziert
• Sichere tokenbasierte Authentifizierung nach dem ersten Login
• Sitzungen werden für die Dauer Ihrer Konversation aufrechterhalten
• Keine Anmeldedaten werden vom KI-Assistenten gespeichert

---

Support & Ressourcen

• Telinfy-Dashboard: https://telinfy.com
• API-Dokumentation: Kontaktieren Sie den Telinfy-Support für detaillierte API-Dokumente
• MCP-Protokoll: https://modelcontextprotocol.io
• Support: Kontaktieren Sie Ihren Telinfy-Kundenbetreuer

---

Fehlerbehebung

Authentifizierungsprobleme

Wenn Sie Anmeldeprobleme haben:

1. Überprüfen Sie, ob Benutzername und Passwort korrekt sind
2. Prüfen Sie, ob Ihr Konto API-Zugriff aktiviert hat
3. Kontaktieren Sie den Telinfy-Support, um sicherzustellen, dass Ihr Konto MCP-Zugriff hat

Verbindungsprobleme

Wenn der MCP-Server keine Verbindung herstellt:

1. Überprüfen Sie, ob die Server-URL exakt lautet: https://mcp.telinfy.com/sse
2. Prüfen Sie Ihre Internetverbindung
3. Versuchen Sie, den MCP-Server in Ihren KI-Client-Einstellungen neu zu verbinden

Probleme bei der Nachrichtenzustellung

Wenn Nachrichten nicht gesendet werden:

1. Stellen Sie sicher, dass Sie über ausreichendes Guthaben in Ihrem Telinfy-Konto verfügen
2. Überprüfen Sie, ob die DLT-Vorlagen-IDs korrekt registriert sind
3. Stellen Sie sicher, dass Absendernamen in Ihrem Telinfy-Konto genehmigt sind
4. Bestätigen Sie, dass Telefonnummern im richtigen Format vorliegen

---

Best Practices

1. Immer zuerst anmelden – Authentifizieren Sie sich zu Beginn jeder Sitzung
2. Korrekte Vorlagen-IDs verwenden – Stellen Sie sicher, dass DLT-Vorlagen zu Ihrem Nachrichteninhalt passen
3. Telefonformate überprüfen – Verwenden Sie 10-stellige indische Nummern oder das internationale Format mit Ländercode
4. Kampagnenberichte prüfen – Überwachen Sie den Zustellstatus regelmäßig
5. Kontakte effizient verwalten – Halten Sie Telefonbuchgruppen organisiert
6. Vor Massenversand testen – Senden Sie Testnachrichten vor großen Kampagnen

---

Beispiel-Workflow

Hier ist ein vollständiger Workflow zum Senden einer Kampagne:

1. Authentifizieren

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

2. Kontaktgruppe erstellen

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

3. Kampagne planen

   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. Ergebnisse überwachen

   Show me the delivery report for the Spring Sale campaign
   

---

Erweiterte Funktionen

Dynamische Variablensubstitution

Verwenden Sie Excel-Dateien, um personalisierte Nachrichten in großem Umfang zu senden:

• Excel mit Spalten hochladen: Mobile, Name, OrderID, Amount
• Variablen zuordnen: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount
• Vorlage: „Hallo {{1}}, Ihre Bestellung {{2}} über Rs.{{3}} ist bestätigt"

Multi-Route-SMS

• Route 0: Werbenachrichten
• Route 1: Transaktionsnachrichten (OTPs, Benachrichtigungen)

Unicode-Unterstützung

Senden Sie Nachrichten in regionalen Sprachen, indem Sie den Unicode-Modus aktivieren.

---

Checkliste für den Einstieg

• Telinfy MCP-Server mit Ihrem KI-Assistenten verbinden
• Mit Ihren Telinfy-Anmeldedaten authentifizieren
• Überprüfen, ob aktive Absendernamen und DLT-Vorlagen vorhanden sind
• Kontostand und Guthaben prüfen
• Mit einer einzelnen SMS vor Massenkampagnen testen
• Organisierte Telefonbuchgruppen erstellen
• Geplante Kampagnen für optimales Timing einrichten
• Berichte regelmäßig überwachen

---

Für detaillierte API-Spezifikationen und Parameterreferenzen lesen Sie die Telinfy-API-Dokumentation oder kontaktieren Sie Ihren Kundenbetreuer.