Telinfy MCP server

resmi

SMS, WhatsApp ve RCS mesajlarını DLT uyumlu olarak programatik şekilde gönderin. Kişileri yönetin, kampanyaları planlayın ve teslimat raporlarını takip edin.

GitHub

Dokümantasyon

Telinfy MCP Entegrasyon Kılavuzu

Telinfy MCP sunucusunu yapay zeka asistanlarıyla bağlama ve kullanma

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

MCP Nedir?

Model Bağlam Protokolü (MCP), yapay zeka 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 yapay zeka uygulamaları için bir USB-C bağlantı noktası gibi düşünün - yapay zeka uygulamalarını farklı servislere bağlamanın standartlaştırılmış bir yolu.

Telinfy MCP Sunucusu

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

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

Kimlik Doğrulama Gerekli

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

  • Telinfy kullanıcı adı
  • Telinfy şifresi
  • API kimlik bilgileri (oturum açtıktan sonra otomatik olarak alınır)

Mevcut Araçlar

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

SMS İşlemleri

  1. send_sms - DLT uyumluluğu ile SMS mesajları gönderin
  2. schedule_sms - Gelecekte teslim edilmek üzere SMS kampanyaları zamanlayın
  3. scheduleDynamicCampaign - Excel dosyaları ve şablon değişkenleri kullanarak dinamik SMS kampanyaları zamanlayın
  4. get_sms_schedule - Tüm zamanlanmış SMS kampanyalarını görüntüleyin
  5. fetch_sms_campaign_report - SMS kampanyaları için ayrıntılı raporlar alın

WhatsApp İşlemleri

  1. send_whatsapp_campaign - Önceden oluşturulmuş şablonları kullanarak WhatsApp mesajları gönderin
  2. whatsapp_campaign - Tüm WhatsApp kampanyalarını listeleyin
  3. fetch_whatsapp_smart_report - Tarih filtrelemesi ile WhatsApp kampanya raporlarını alın

RCS İşlemleri

  1. fetch_rcs_report - Tarih filtrelemesi ile RCS mesaj raporlarını alın

Kişi Yönetimi

  1. create_phonebook - Kişilerle birlikte yeni telefon defteri grupları oluşturun
  2. get_phonebook_groups - Tüm telefon defteri gruplarını listeleyin
  3. get_group_contacts - Belirli bir grup içindeki kişileri görüntüleyin
  4. edit_contact - Kişi bilgilerini güncelleyin
  5. toggle_contact_status - Bir gruptaki kişileri etkinleştirin/devre dışı bırakın
  6. delete_contact_group - Telefon defteri gruplarını kaldırın

Mesaj Raporlama

  1. getMessageReport - Gönderilen mesajlar için mesaj teslim raporlarını ve durumunu alın

Kimlik Doğrulama

  1. login_to_telinfy - Telinfy platformu ile kimlik doğrulayın ve bir oturum oluşturun

İletişim 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 şartname sürümü
  • Claude, Windsurf, Cursor ve diğer MCP istemcileri tarafından desteklenir
  • Tüm entegrasyonlar için önerilir

Kurulum Talimatları

Claude Masaüstü/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:

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

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

Telinfy MCP Kullanımı

İlk Kurulum

MCP sunucusuna bağlandıktan sonra, Telinfy kimlik bilgilerinizle kimlik doğrulamanız gerekecek:

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

Yapay zeka asistanı, güvenli bir oturum oluşturmak için login_to_telinfy aracını kullanacaktır.

Örnek Kullanım Durumları

SMS Kampanyası Gönderme

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

Pazarlama Kampanyası Zamanlama

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şturma

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

WhatsApp Mesajları Gönderme

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

Kampanya Raporları Alma

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

Mesaj Teslim Durumunu Alma

Get the delivery status for all messages sent today

Temel Özellikler

DLT Uyumluluğu

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

Dinamik Kampanyalar

Değişken ikamesi ile Excel dosyalarını kullanarak kişiselleştirilmiş SMS kampanyaları zamanlayın, toplu kişiselleştirilmiş mesajlaşma için mükemmeldir.

Çok Kanallı Mesajlaşma

  • SMS - Promosyon ve işlemsel rotalar
  • WhatsApp - Şablon tabanlı iş mesajlaşması
  • RCS - Zengin İletişim Hizmetleri

Kapsamlı Raporlama

Mesaj teslimatını, kampanya performansını izleyin ve tarih filtrelemesi ile ayrıntılı raporlar oluşturun.

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 oturum açmadan sonra güvenli belirteç tabanlı kimlik doğrulama
  • Oturumlar, görüşmenizin süresi boyunca korunur
  • Yapay zeka asistanı tarafından hiçbir kimlik bilgisi saklanmaz

Destek ve Kaynaklar

Sorun Giderme

Kimlik Doğrulama Sorunları

Oturum açma 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ğlanmazsa:

  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. Yapay zeka istemci ayarlarınızda MCP sunucusunu yeniden bağlamayı deneyin

Mesaj Teslim Sorunları

Mesajlar gönderilmiyorsa:

  1. Telinfy hesabınızda yeterli krediniz olduğundan emin olun
  2. DLT şablon kimliklerinin doğru şekilde kaydedildiğini doğrulayın
  3. Gönderici 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. Her zaman önce oturum açı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ğrula
Log me into Telinfy with username "myuser" and password "mypass"
  1. Kişi Grubu Oluştur
Create a phonebook group "Spring Sale 2024" with my customer list
  1. Kampanya Zamanla
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. Sonuçları İzle
Show me the delivery report for the Spring Sale campaign

Gelişmiş Özellikler

Dinamik Değişken İkamesi

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

  • Sütunlarla Excel yükleyin: Mobil, Ad, SiparişID, Tutar
  • Değişkenleri eşleyin: {{1}} = Ad, {{2}} = SiparişID, {{3}} = Tutar
  • Şablon: "Merhaba {{1}}, {{2}} numaralı siparişiniz {{3}} TL tutarında onaylandı"

Çok Rotalı SMS

  • Rota 0: Promosyon mesajları
  • Rota 1: İşlemsel mesajlar (OTP'ler, uyarılar)

Unicode Desteği

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

Başlangıç Kontrol Listesi

  • Telinfy MCP sunucusunu yapay zeka asistanınıza bağlayın
  • Telinfy kimlik bilgilerinizle kimlik doğrulayın
  • Aktif gönderici adlarınız ve DLT şablonlarınız 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 zamanlanmış kampanyalar ayarlayın
  • Raporları düzenli olarak izleyin

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