Giriş yapınÜcretsiz denemeyi başlatın
Meta Tech Provider

MCP araç referansı

Bağlayıcı, bir hesaptaki tüm bağlantılar için 30'dan fazla araç sunar. WhatsApp için list_numbers ilk sırada gelir ve araçları onun connection_id değerini kullanır; diğer kanallar için list_social_accounts gelir ve araçları account_id değerini kullanır. Faturalandırma aksadığında altı araç kısıtlanır: dış dünyada işlem yapan dört WhatsApp aracı, erişim belirtecini döndüren get_api_credentials ve create_connect_link. Geri kalanlar açık kalır.

30+

Bağlayıcının sunduğu araçlar.

6

Faturalandırma aksadığında kısıtlanan araçlar; erişim belirtecini döndüren get_api_credentials da dahil.

1

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.

Partner API, kendi müşterileri numara bağlayan yazılımlar veya ajanslar için: get_partner_setup faturalandırmayı, API anahtarını, olay URL'sini ve sonraki adımı gösterir. create_api_key Partner API anahtarını oluşturur ve yalnızca bir kez gösterir; açık onay olmadan mevcut anahtarı değiştirmez. revoke_api_key anahtarı iptal eder, bu da yalnızca onaydan sonra. set_partner_events_url durum olaylarının nereye gideceğini ayarlar ve imzalama sırrını bir kez döndürür. create_connect_link tek bir müşteri için 1 saat geçerli, barındırılan bir bağlantı linki oluşturur; POST /api/v1/connect-sessions ile aynıdı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?

Altı araç kısıtlanır: dış dünyada işlem yapan send_message, send_template, create_template ve set_webhook_destination; hesabın erişim belirtecini döndürdüğü için get_api_credentials, çünkü engellenen bir hesap bununla doğrudan Graph API üzerinden gönderim yapabilirdi; ve yeni bir numara bağlayan create_connect_link. Diğer tüm okuma işlemleri kullanılabilir kalır, Partner API kurulumu da öyle: get_partner_setup, create_api_key, revoke_api_key ve set_partner_events_url.

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; gönderim yapan erişim token'ını taşıyan kimlik bilgileri hariç.
Bunu EasyCoexistence'la yapmak

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, numara ekledikçe US$ 0,75'e iner; ilk 3 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ın

Doğrulama tarihi