Telinfy MCP server

Telinfy MCP Entegrasyon Rehberi

Telinfy MCP sunucusuna nasıl bağlanılır ve AI asistanlarıyla nasıl kullanılır

Telinfy MCP sunucusu, Telinfy'nin SMS, WhatsApp ve RCS mesajlaşma yeteneklerine programatik erişim sağlar; AI asistanlarının sizin adınıza mesaj göndermesine, kişileri yönetmesine, kampanyaları planlamasına ve raporlar almasına olanak tanır.

---

MCP Nedir?

Model Context Protocol (MCP), AI uygulamalarının MCP uyumlu veri kaynaklarına ve araçlarına güvenli bir şekilde bağlanmasını sağlayan açık bir standarttır. MCP'yi AI uygulamaları için bir USB-C bağlantı noktası gibi düşünün - AI uygulamalarını farklı hizmetlere bağlamanın standart bir yolu.

---

Telinfy MCP Sunucusu

Telinfy MCP sunucusu, Telinfy mesajlaşma platformunuza erişim sağlayan güvenli ve kimlik doğrulamalı bir hizmettir.

Temel Sunucu URL'si: https://mcp.telinfy.com/sse

Kimlik Doğrulama Gereklidir

Telinfy MCP sunucusunu kullanmak için şunlara ihtiyacınız vardır:

• Telinfy kullanıcı adı
• Telinfy şifresi
• API kimlik bilgileri (girişten sonra otomatik olarak alınır)

---

Kullanılabilir Araçlar

Telinfy MCP sunucusu kapsamlı mesajlaşma ve kampanya yönetimi araçları sunar:

SMS İşlemleri

1. send_sms - DLT uyumlu SMS mesajları gönderin
2. schedule_sms - Gelecekteki teslimat için SMS kampanyaları planlayın
3. scheduleDynamicCampaign - Excel dosyaları ve şablon değişkenleri kullanarak dinamik SMS kampanyaları planlayın
4. get_sms_schedule - Planlanan tüm SMS kampanyalarını görüntüleyin
5. fetch_sms_campaign_report - SMS kampanyaları için ayrıntılı raporlar alın

WhatsApp İşlemleri

6. send_whatsapp_campaign - Önceden oluşturulmuş şablonları kullanarak WhatsApp mesajları gönderin
7. whatsapp_campaign - Tüm WhatsApp kampanyalarını listeleyin
8. fetch_whatsapp_smart_report - Tarih filtreleme ile WhatsApp kampanya raporları alın

RCS İşlemleri

9. fetch_rcs_report - Tarih filtreleme ile RCS mesaj raporlarını alın

Kişi Yönetimi

10. create_phonebook - Kişilerle yeni telefon defteri grupları oluşturun
11. get_phonebook_groups - Tüm telefon defteri gruplarını listeleyin
12. get_group_contacts - Belirli bir gruptaki kişileri görüntüleyin
13. edit_contact - Kişi bilgilerini güncelleyin
14. toggle_contact_status - Bir gruptaki kişileri etkinleştirin/devre dışı bırakın
15. delete_contact_group - Telefon defteri gruplarını kaldırın

Mesaj Raporlama

16. getMessageReport - Gönderilen mesajlar için mesaj teslimat raporlarını ve durumunu getirin

Kimlik Doğrulama

17. login_to_telinfy - Telinfy platformuyla kimlik doğrulayın ve bir oturum başlatın

---

Tel Protokolü

Telinfy MCP sunucusu SSE (Sunucu Tarafından Gönderilen Olaylar) protokolünü kullanır:

SSE (Sunucu Tarafından Gönderilen Olaylar) - /sse

• URL: https://mcp.telinfy.com/sse
• Resmi MCP spesifikasyon sürümü
• Claude, Windsurf, Cursor ve diğer MCP istemcileri tarafından desteklenir
• Tüm entegrasyonlar için önerilir

---

Kurulum Talimatları

Claude Desktop/Web için:

1. Claude ayarlarınıza gidin
2. "Entegrasyonlar" veya "Bağlantılar" bölümüne gidin
3. Şu ayrıntılarla yeni bir MCP sunucusu ekleyin:
   • Ad: Telinfy
     • Sunucu URL'si: https://mcp.telinfy.com/sse
4. Yapılandırmayı kaydedin

Claude Code (Komut Satırı) için:

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

Windsurf, Cursor veya diğer MCP istemcileri için:

Bu yapılandırmayı MCP ayarlar dosyanıza ekleyin:

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

---

Telinfy MCP Kullanımı

İlk Kurulum

MCP sunucusunu bağladıktan sonra Telinfy kimlik bilgilerinizle kimlik doğrulamanız gerekecektir:

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

AI asistanı, güvenli bir oturum başlatmak için login_to_telinfy aracını kullanacaktır.

Örnek Kullanım Durumları

SMS Kampanyası Gönderin

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

Pazarlama Kampanyası Planlayın

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

Kişi Grubu Oluşturun

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

WhatsApp Mesajları Gönderin

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

Kampanya Raporları Alın

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

Mesaj Teslimat Durumunu Getirin

Get the delivery status for all messages sent today

---

Temel Özellikler

DLT Uyumluluğu

Tüm SMS kampanyaları, Hindistan'da düzenleyici uyumluluğu sağlayan şablon kimlikleri ve gönderen adlarıyla DLT (Dağıtık Defter Teknolojisi) uyumluluğunu destekler.

Dinamik Kampanyalar

Değişken değiştirme ile Excel dosyaları kullanarak kişiselleştirilmiş SMS kampanyaları planlayın; toplu kişiselleştirilmiş mesajlaşma için idealdir.

Çok Kanallı Mesajlaşma

• SMS - Tanıtım ve işlemsel yollar
• WhatsApp - Şablon tabanlı iş mesajlaşması
• RCS - Zengin İletişim Hizmetleri

Kapsamlı Raporlama

Mesaj teslimatını, kampanya performansını takip edin ve tarih filtreleme ile ayrıntılı raporlar oluşturun.

Kişi Yönetimi

Kişileri gruplar halinde düzenleyin, kişileri etkinleştirin/devre dışı bırakın ve temiz telefon defteri listeleri tutun.

---

Güvenlik ve Kimlik Doğrulama

• Tüm API çağrıları Telinfy kimlik bilgileriniz kullanılarak doğrulanır
• İlk girişten sonra güvenli token tabanlı kimlik doğrulama
• Oturumlar konuşmanız boyunca korunur
• AI asistanı tarafından hiçbir kimlik bilgisi saklanmaz

---

Destek ve Kaynaklar

• Telinfy Panosu: https://telinfy.com
• API Dokümantasyonu: Ayrıntılı API belgeleri için Telinfy desteğiyle iletişime geçin
• MCP Protokolü: https://modelcontextprotocol.io
• Destek: Telinfy hesap yöneticinizle iletişime geçin

---

Sorun Giderme

Kimlik Doğrulama Sorunları

Giriş sorunlarıyla karşılaşırsanız:

1. Kullanıcı adınızın ve şifrenizin doğru olduğunu doğrulayın
2. Hesabınızda API erişiminin etkin olup olmadığını kontrol edin
3. Hesabınızın MCP erişimine sahip olduğundan emin olmak için Telinfy desteğiyle iletişime geçin

Bağlantı Sorunları

MCP sunucusu bağlanmıyorsa:

1. Sunucu URL'sinin tam olarak şu olduğunu doğrulayın: https://mcp.telinfy.com/sse
2. İnternet bağlantınızı kontrol edin
3. AI istemci ayarlarınızda MCP sunucusunu yeniden bağlamayı deneyin

Mesaj Teslimat Sorunları

Mesajlar gönderilmiyorsa:

1. Telinfy hesabınızda yeterli krediniz olduğundan emin olun
2. DLT şablon kimliklerinin doğru şekilde kayıtlı olduğunu doğrulayın
3. Gönderen adlarının Telinfy hesabınızda onaylandığını kontrol edin
4. Telefon numaralarının doğru formatta olduğunu onaylayın

---

En İyi Uygulamalar

1. Önce her zaman giriş yapın - Her oturumun başında kimlik doğrulayın
2. Doğru şablon kimliklerini kullanın - DLT şablonlarının mesaj içeriğinizle eşleştiğinden emin olun
3. Telefon formatlarını doğrulayın - 10 haneli Hindistan numaraları veya ülke koduyla uluslararası format kullanın
4. Kampanya raporlarını kontrol edin - Teslimat durumunu düzenli olarak izleyin
5. Kişileri verimli yönetin - Telefon defteri gruplarını düzenli tutun
6. Toplu gönderimden önce test edin - Büyük kampanyalardan önce test mesajları gönderin

---

Örnek İş Akışı

Bir kampanya göndermek için eksiksiz bir iş akışı:

1. Kimlik Doğrulama

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

2. Kişi Grubu Oluşturma

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

3. Kampanya Planlama

   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. Sonuçları İzleme

   Show me the delivery report for the Spring Sale campaign
   

---

Gelişmiş Özellikler

Dinamik Değişken Değiştirme

Ölçekte kişiselleştirilmiş mesajlar göndermek için Excel dosyaları kullanın:

• Sütunlarla Excel yükleyin: Mobile, Name, OrderID, Amount
• Değişkenleri eşleyin: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount
• Şablon: "Hi {{1}}, your order {{2}} of Rs.{{3}} is confirmed"

Çok Yollu SMS

• Yol 0: Tanıtım mesajları
• Yol 1: İşlemsel mesajlar (OTP'ler, uyarılar)

Unicode Desteği

Unicode modunu etkinleştirerek bölgesel dillerde mesaj gönderin.

---

Başlangıç Kontrol Listesi

• Telinfy MCP sunucusunu AI asistanınıza bağlayın
• Telinfy kimlik bilgilerinizle kimlik doğrulayın
• Etkin gönderen adlarınızın ve DLT şablonlarınızın olduğunu doğrulayın
• Hesap bakiyenizi ve kredilerinizi kontrol edin
• Toplu kampanyalardan önce tek bir SMS ile test edin
• Düzenli telefon defteri grupları oluşturun
• Optimum zamanlama için planlanmış kampanyalar kurun
• Raporları düzenli olarak izleyin

---

Ayrıntılı API spesifikasyonları ve parametre referansları için Telinfy API dokümantasyonuna bakın veya hesap yöneticinizle iletişime geçin.