Meta Muse ve Claude gibi yapay zekâ asistanlarından WhatsApp Business Platform sohbetlerini yönetmek için MCP sunucusu
Zaten kullandığınız yapay zekâ asistanında kalın. WhatsApp Business Platform sohbetlerinizi okumak, müşterilere yanıt vermek, onaylı şablonlar göndermek ve ekibiniz için sohbetleri atayıp etiketlemek üzere onu TimelinesAI’a bağlayın.
TimelinesAI MCP sunucusu, OAuth ile girişli uzak MCP sunucularını destekleyen tüm yapay zekâ asistanlarıyla çalışır. Kurulacak yazılım, yönetilecek sunucu veya paylaşılacak şifre yoktur. Asistan yalnızca TimelinesAI rolünüzün izin verdiklerini yapabilir.
Bağlayıcı neler yapabilir
- Tüm WhatsApp Business Platform numaralarınızda sohbetleri, mesaj geçmişini ve mesaj durumlarını okuma
- Müşterinin 24 saatlik penceresi açıkken serbest metinle yanıt verme
- Meta onaylı şablonlar gönderme ve şablonla yeni sohbet başlatma
- Sohbetleri atama ve atamayı kaldırma, açma ve kapatma, etiket ekleme veya kaldırma
- Mesajlara tepki verme, ekip üyelerinizi ve şablonlarınızı görme
Neye ihtiyacınız var
- Bir TimelinesAI hesabı. Yeni hesaplar kredi kartı gerektirmeyen 10 günlük ücretsiz deneme ile başlar.
- Çalışma alanınıza bağlı en az bir WhatsApp Business Platform (Cloud API) numarası. WhatsApp Business Platform’da yeni misiniz? Meta Business Portfolio’da bir WhatsApp Business numarasını bağlayın ve etkinleştirin.
- Asistanın yeni sohbet başlatmasını veya 24 saatlik pencerenin dışındaki müşterilere yazmasını istiyorsanız en az bir onaylı şablon.
Nasıl kurulur
Adım 1: Bağlayıcıyı ekleyin.
Yapay zekâ asistanınızda yeni bir bağlayıcı (veya özel MCP sunucusu) ekleyin ve
https://mcp.services.timelines.ai/mcp/wabaadresini yapıştırın.Adım 2: TimelinesAI ile giriş yapın.
Asistan TimelinesAI giriş sayfasını açar. Giriş yapın veya bir hesap oluşturun.
Adım 3: Erişimi onaylayın.
“Authorize timelines-mcp?” sayfasındaki izinleri inceleyin ve Authorize düğmesine tıklayın.
Adım 4: İlk sorunuzu sorun.
“WhatsApp Business numaralarımı listele” veya “Yanıt bekleyen sohbetleri göster” yazmayı deneyin.
Bağlantı bilgileri
| Ayar | Değer |
|---|---|
| MCP sunucu URL’si | https://mcp.services.timelines.ai/mcp/waba |
| Aktarım | Streamable HTTP |
| Giriş | PKCE (S256) ve dinamik istemci kaydı ile OAuth 2.1 |
| Yetkilendirme sunucusu | https://mcp.services.timelines.ai |
| Kapsamlar (scopes) | openidchats:readchats:writemessages:readmessages:writelabels:readlabels:writeaccounts:readworkspace:readtemplates:read |
Araçlar (18)
Okuma araçları yalnızca verilere bakar. Yazma araçları TimelinesAI içindeki bir sohbeti değiştirir. Hassas yazma araçları müşterinizin göreceği bir şey gönderir ve şablon gönderimleri Meta tarafından ücretlendirilir.
| Araç | Ne yapar | Erişim |
|---|---|---|
waba_accounts | Gönderim yapabileceğiniz WhatsApp Business Platform numaralarını listeler | Okuma |
waba_list_chats | Görebildiğiniz sohbetleri filtrelerle (örneğin telefon numarasına göre) listeler | Okuma |
waba_chat_details | Bir sohbeti gösterir: 24 saatlik pencerenin açık olup olmadığı, atanan kişi, etiketler ve gönderen numara | Okuma |
waba_chat_history | Bir sohbetteki mesajları en yeniden başlayarak gösterir | Okuma |
waba_message_details | Bir mesajı, başarısız olduysa nedeniyle birlikte gösterir | Okuma |
waba_templates | Kullanabileceğiniz mesaj şablonlarını listeler | Okuma |
waba_template_details | Bir şablonu gösterir: içeriği, değişkenleri, durumu ve hangi numaralardan gönderilebileceği | Okuma |
workspace_team | Ekip arkadaşlarını listeler, böylece bir sohbet bunlardan birine atanabilir | Okuma |
waba_chat_open | Kapatılmış bir sohbeti yeniden açar | Yazma |
waba_chat_close | Bir sohbeti kapatır | Yazma |
waba_chat_assign | Bir sohbeti bir ekip arkadaşına atar | Yazma |
waba_chat_unassign | Bir sohbetten atanan kişiyi kaldırır | Yazma |
waba_chat_set_label | Bir sohbete etiket ekler | Yazma |
waba_chat_remove_label | Bir sohbetten etiketi kaldırır | Yazma |
waba_chat_send_message | Mevcut bir sohbette serbest metinli yanıt gönderir; yalnızca 24 saatlik pencere açıkken | Hassas yazma |
waba_chat_send_template | Mevcut bir sohbette onaylı bir şablon gönderir | Hassas yazmaMeta şablonları ücretlendirir |
waba_start_chat | Onaylı bir şablonla bir telefon numarasıyla yeni sohbet başlatır | Hassas yazmaMeta şablonları ücretlendirir |
waba_message_react | Bir mesaja emoji tepkisi ekler veya kaldırır | Hassas yazmaMüşteri bunu görür |
Her araç salt okunur veya değişiklik yapan olarak işaretlenmiştir; böylece yapay zekâ asistanları bir yazma işleminden önce sizden onay isteyebilir.
Araç girdileri
Her araç, o işlem için TimelinesAI API’sinin JSON yanıtını döndürür. Zorunlu girdiler kalın yazılmıştır. Asistan kimlikleri önce listeleme araçlarından alır (örneğin bir sohbet kimliğini waba_list_chats ile).
| Araç | Girdiler |
|---|---|
waba_accounts | Yok |
waba_list_chats | Tümü isteğe bağlı: waba_account_id, responsible (ekip üyesinin e-postası), closed (true veya false), whatsapp_phone, with_msg (son mesajı dahil eder), page (sayfa başına 50 sohbet) |
waba_chat_details | chat_id |
waba_chat_history | chat_id. İsteğe bağlı: from_me, after ve before (ISO tarih veya tarih-saat), after_message ve before_message (mesaj kimliği), sorting_order (asc veya desc), page, size |
waba_message_details | message_uid |
waba_templates | İsteğe bağlı page |
waba_template_details | template_id |
workspace_team | Yok |
waba_chat_openwaba_chat_closewaba_chat_unassign | chat_id |
waba_chat_assign | chat_id, user_email (workspace_team listesindeki bir ekip üyesi) |
waba_chat_set_labelwaba_chat_remove_label | chat_id, label |
waba_chat_send_message | chat_id, text |
waba_chat_send_template | chat_id, onaylı bir şablonun name ve language değerleri. İsteğe bağlı variables: şablondaki sırayla header ve body listeleri |
waba_start_chat | waba_account_id, phone (başında + olan uluslararası biçim), onaylı bir şablonun name ve language değerleri. İsteğe bağlı variables, yukarıdaki gibi |
waba_message_react | message_uid, reaction (tek bir emoji veya kaldırmak için boş değer) |
Hatalar ve sınırlar
Bir çağrı başarısız olduğunda araç; HTTP durumunu, TimelinesAI API’sinin mesajını ve varsa bir hata kodunu içeren bir hata sonucu döndürür. Asistan böylece ne olduğunu ve sonra ne yapılacağını açıklayabilir.
| Durum | Anlamı | Ne yapmalı |
|---|---|---|
| 400, 409, 422 | İstek reddedildi; örneğin eksik bir girdi veya yanlış biçimde bir telefon numarası | Girdiyi düzeltip yeniden deneyin |
| 401 | Oturum artık geçerli değil | Bağlayıcıyı yeniden bağlayın ve TimelinesAI’a tekrar giriş yapın |
| 403 | Kullanıcının rolü veya planı bu işleme izin vermiyor | Çalışma alanının bir sahibine veya yöneticisine danışın |
| 404 | Sohbet, mesaj veya şablon bulunamadı | Doğru kimliği listeleme araçlarıyla bulun |
| 429 | Çok fazla istek | Biraz bekleyip yeniden deneyin |
| 5xx veya 15 saniye içinde yanıt yok | TimelinesAI tarafında geçici bir sorun | Daha sonra yeniden deneyin |
- 24 saatlik pencere: pencere kapalıysa serbest metinli yanıt reddedilir. Bunun yerine onaylı bir şablon gönderin. Pencerenin açık olup olmadığını
waba_chat_detailsvewaba_list_chatsgösterir. - Teslimat: başarılı bir gönderim, Meta’nın mesajı kabul ettiği anlamına gelir. Teslimat sonradan başarısız olursa nedenini
waba_message_detailsgösterir. - Yinelenen gönderim yok: gönderim araçları otomatik olarak yeniden denenmez. Bir gönderim zaman aşımına uğrarsa, müşterinin mesajı iki kez almaması için yeniden göndermeden önce
waba_chat_historyaracını kontrol edin. - Hız sınırları: bağlayıcı kendi sınırını eklemez. Meta’nın WhatsApp Business Platform numaranız için mesajlaşma sınırları şablon mesajlarına uygulanmaya devam eder.
Asistan neleri görebilir
Asistan, giriş yapan TimelinesAI kullanıcısı olarak, o kullanıcının izinleriyle hareket eder. O kullanıcının TimelinesAI’da görebileceğinden fazlasını asla görmez.
- Sahipler ve yöneticiler çalışma alanındaki tüm WhatsApp Business Platform numaralarını ve bunların tüm sohbetlerini görür.
- Ekip sorumluları ve ekip üyeleri ekibi kendi ekipleri olarak ayarlanmış numaraları ve bu numaraların sohbetlerini görür.
- Temsilciler kendilerine atanmış numaraları ve bu numaraların sohbetlerini görür.
- Ortak çalışanlar yalnızca kendilerine atanmış sohbetleri görür. Bu sohbetlerde yanıt verebilir ancak yeni sohbet başlatamazlar.
- Atanmış sohbetler: tek bir sohbete atanan herkes o sohbeti görebilir ve yanıtlayabilir. Bu, o numaranın geri kalanını açmaz.
Mesajlaşma kuralları
- 24 saatlik pencerenin içinde (müşteri son 24 saat içinde yazdıysa) asistan serbest metinli yanıtlar gönderebilir.
- Pencerenin dışında veya yeni bir sohbette yalnızca Meta onaylı şablonlar gönderilebilir. Şablon, pencereyi serbest metin için yeniden açmaz.
- Medya başlığı olan şablonlar (görsel, video veya belge) henüz bağlayıcı üzerinden gönderilemez. Metin değişkenli şablonlar kullanın.
- Teslimat: başarılı bir gönderim, Meta’nın mesajı kabul ettiği anlamına gelir. Teslimat sonradan yine başarısız olabilir ve asistan nedenini kontrol edebilir.
Fiyatlandırma
Bağlayıcıyı kullanmak, tüm TimelinesAI planlarına ek ücret olmadan dahildir. Meta, şablon mesajlarını standart WhatsApp Business Platform ücretleriyle ücretlendirir ve asistan bir şablon göndermeden önce sizi bilgilendirir.
Gizlilik ve güvenlik
- Giriş OAuth ile yapılır, bu yüzden yapay zekâ asistanınız TimelinesAI şifrenizi asla görmez.
- Asistan yalnızca giriş yapan kullanıcının erişebildiği verileri, yukarıdaki kapsamlar dahilinde kullanabilir.
- Bağlantıyı kesmek için bağlayıcıyı yapay zekâ asistanınızdan kaldırın.
- Bu bağlayıcının gizlilik bildirimine (İngilizce) ve Koşullarımıza göz atın. Yardım: support@timelines.ai.
WhatsApp Business Platform MCP sunucusu hakkında sık sorulan sorular
Son güncelleme: