MCP araç referansı
Bağlayıcı, bir hesaptaki tüm numaralar için on bir araç sunar. list_numbers ilk sırada gelir, çünkü diğer tüm araçlar buradan alınan connection_id değerini kullanır. Dördü dış dünyada işlem yapar ve faturalandırma aksadığında kısıtlanır; diğer yedisi yalnızca okur ve açık kalır.
Bağlayıcının sunduğu araçlar.
Faturalandırma aksadığında kısıtlanan araçlar. Tüm okuma işlemleri kullanılabilir.
Hesaptaki tüm numaraları kapsayan OAuth oturum açma.
Her araç ne yapar?
Okuma: list_numbers, bağlı numaraları durum, kalite puanı ve mesajlaşma katmanıyla birlikte döndürür ve diğer tüm çağrıların başlangıç noktasıdır. get_number_health, canlı bir Meta görünümünü; son izleme zaman çizelgesi, webhook olayları ve yoklayıcı kontrolleriyle birlikte döndürür. get_api_credentials, Graph API temel URL'sini, WABA id, phone number id ve mevcutsa hesabın kendi erişim token'ını döndürür.
Gönderme: send_message, yanıtların ücretsiz olduğu 24 saatlik pencere içinde serbest metin gönderir. send_template, onaylanmış bir şablon gönderir; size yazmamış biriyle konuşma başlatmanın yolu budur. list_templates, create_template ve get_template_status, şablon yaşam döngüsünü kapsar.
Bağlama: set_webhook_destination, gelen mesajları ve uygulama yankılarını sisteminize yönlendirir; null göndermek hedefi sıfırlar. get_connect_link, yeni bir numarayı bağlamak için panel bağlantısını ve adımları döndürür. get_docs, ürün belgelerini markdown olarak döndürür.
connection_id neden önemlidir?
Çünkü bir talimatı belirli bir numaraya bağlayan değer budur ve bir asistan bunu tahmin edemez.
Bir numara üzerinde işlem yapan her araç connection_id alır ve bu değerin geldiği tek yer list_numbers'dır. Uygulamada bu, mesaj göndermesi istenen bir asistanın önce list_numbers çağrısını yapacağı anlamına gelir. Bu nedenle oturumdaki ilk istek çoğu zaman diğerlerinden daha yavaştır.
Bu yapı, birden fazla numarası olan hesabın da belirsiz olmamasını sağlar. Varsayılan numara veya örtük seçim yoktur; hangi numaranın sorulduğunu belirtmeyen bir talimat tahmin edilmez, sorulur.
Faturalandırma aksadığında ne olur?
Dış dünyada işlem yapan dört araç kısıtlanır: send_message, send_template, create_template ve set_webhook_destination. Okuma yapan her şey kullanılabilir kalır.
Bu bir gözden kaçırma değil, bilinçli bir tercihtir. Neden engellendiğini göremeyen veya numaralarının sağlığını kontrol edemeyen bir hesabın destek talebi dışında geri dönüş yolu kalmaz. Aynı okuma işlemleri bağlantı sağlığı izlemesinin de temelidir; bu nedenle onları kısıtlamak, birinin en çok ihtiyaç duyduğu anda izlemeyi kapatır.
Pratikte, faturalandırması aksayan hesap kendi durumu hakkında soruları yanıtlamaya ve izlenmeye devam eder. Durdurulan şey, müşteriye ulaşan işlemlerdir.
Yaygın hatalar
- Bağlayıcının mesaj almasını beklemek. MCP istek ve yanıttan oluşur; gelen trafik için webhook gerekir.
- connection_id değerini sabit kodlamak. Bu değer list_numbers'dan gelir ve not edilecek bir değer değildir.
- Faturalandırması aksayan hesabın tamamen çevrimdışı olduğunu varsaymak. Okuma ve izleme bilerek devam eder.
Tek bağlayıcı, bir hesaptaki tüm numaraları kapsar ve yapıştırılacak anahtar olmadan OAuth üzerinden yetkilendirilir. Numara başına aylık US$ 9'dan başlayan fiyat, yüksek hacimde US$ 2'ye iner; ilk 7 gün ücretsizdir.
Sık sorulan sorular
Hangi aracı çağıracağımı ben mi seçerim?
Hayır. Siz isteğinizi doğal dille söylersiniz, asistan seçimi yapar. Araç açıklamaları bunun için yazılmıştır.
Konuşmalarımı okuyabilir mi?
Hayır. Gelen mesajlar, belirlediğiniz webhook hedefine yönlendirilir. Bağlayıcı hesap ve numara durumunu okur.
get_docs kullanışlı mı?
Düşündüğünüzden daha fazla. Asistana belgelerimizi markdown olarak verir; böylece Coexistence kuralları hakkındaki yanıtlar hatırlamaya değil, belgelerimize dayanır.
Tek bağlayıcı birden fazla istemciyi kapsar mı?
Evet. Bir hesap ihtiyacınız olan kadar numara barındırabilir ve list_numbers bunların tümünü döndürür.
Okumaya devam edin
Başlamaya hazır mısınız?
WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.
Ücretsiz denemeyi başlatınDoğrulama tarihi