Messenger profil API'si: karşılama, Get Started düğmesi, buz kırıcılar ve kalıcı menü
Facebook Sayfasının Messenger profili, pages_messaging izni olan bir Sayfa erişim token'ı ile /{page-id}/messenger_profile üzerinden ayarlanır. POST get_started, greeting, ice_breakers, persistent_menu ve commands gibi özellikleri yazar, GET fields ile okur, DELETE ise fields dizisinde adı geçenleri siler. Meta her Sayfa için 10 dakikada 10 çağrıya izin verir ve yalnızca gönderilen özellikler üzerine yazılır.
easyCoexistence, bir Sayfanın Messenger konuşmalarını Claude, ChatGPT veya kendi kodunuzdan 24 saatlik pencere içinde send_social_dm ile yanıtlar ve gelen yeni mesajları, geldikçe uç noktanıza iletir.
Her 10 dakikalık aralıkta Sayfa başına izin verilen Messenger Profil API çağrısı sayısı.
API'nin ayarlayabildiği en fazla buz kırıcı sayısı; ikisi birlikte ayarlandığında API buz kırıcıları, Get Started düğmesine göre öncelik kazanır.
Kalıcı menünün en üst düzeydeki en fazla öğesi; her öğenin başlığı 30 karakterle sınırlıdır.
Sayfa düzeyinde kalıcı menü güncellemesinin ne kadar sürebileceği; tek bir kişi için ayarlanan menü gerçek zamanlı güncellenir.
Karşılama metni; Meta'nın karşılama referansına göre artık Android ve iOS'ta Messenger'da çalışmıyor.
Messenger profili neleri içerir?
Bir Sayfanın Messenger deneyiminin başladığı ayarlar. Meta'nın Messenger Profile API'si bu özellikleri listeler; her biri aynı uç noktada ayarlanır ve okunur. Geliştirme Modu'ndaki bir uygulama için bu ayarlar yalnızca uygulamada bir rolü olan kişilere görünür:
Özellikler nasıl okunur, ayarlanır ve silinir?
Tek bir uç noktada üç yöntemle, Sayfanın token'ı ile çağrılır. POST, özelliklerden oluşan bir JSON gövdesi alır ve yalnızca adını verdiklerinin üzerine yazar; GET, fields değerini virgülle ayrılmış bir liste olarak alır; DELETE ise fields dizisinde kaldırılacak öğeleri adlandıran bir JSON gövdesi alır. POST ve DELETE, result success ile yanıt verir. Tek bir çağrıda Get Started düğmesi ve menü ayarlamak:
POST /{page-id}/messenger_profile
{
"get_started": { "payload": "GET_STARTED" },
"persistent_menu": [
{
"locale": "default",
"composer_input_disabled": false,
"call_to_actions": [
{ "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
{ "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
]
}
]
}
{ "result": "success" }Get Started düğmesi nasıl çalışır?
Karşılama ekranında yer alır; bu ekranda Sayfanın adı, profil fotoğrafı ve kapak fotoğrafı ile işletmenin genelde yanıt verme süresi gösterilir. Dokunuş, Get Started metnini sohbete gönderir, get_started.payload değerini messaging_postbacks olayı olarak uygulamaya iletir ve standart mesajlaşma penceresini açar. Meta, Messenger'ın Facebook uygulamasının uygulama içi tarayıcısında çalışması durumunda düğmenin desteklenmediğini belirtir; kalıcı menü ise önce bu düğmenin ayarlanmasını gerektirir.
Karşılama metni hâlâ çalışıyor mu?
Telefonlarda hayır. Meta'nın referans sayfasının başlığı artık [Deprecated] Greeting Text; özellik Messenger'da Android ve iOS için çalışmıyor. API greeting özelliğini hâlâ kabul edebilir, ama müşteriler bunu görmez; bu yüzden Meta geliştiricilerin bundan kaçınmasını istiyor. Belgelendiği gibi greeting her yerel ayar için bir metin içerir; default zorunludur, en fazla 160 karakter olabilir, {{user_first_name}}, {{user_last_name}} veya {{user_full_name}} ile kişiselleştirilebilir ve ayarlamak için Sayfada Yönetici rolü gerekir.
Buz kırıcılar nasıl çalışır?
Kişinin bir sohbeti başlatmak için dokunabileceği en fazla 4 soru listelerler; soru, kişi sormuş gibi sohbete eklenir ve payload'u bir postback olayı olarak geri döner. Nisan 2022'den beri yerelleştirilmişlerdir: ice_breakers içindeki her nesne call_to_actions ve locale içerir, bir default yerel ayar zorunludur ve ice_breakers için DELETE, hepsini kaldırır. Meta, yeni bir sohbet için yarışan öğeleri şu sırayla değerlendirir:
- Her ikisi de ayarlandığında API buz kırıcıları, Get Started düğmesinden önce gelir.
- Her ikisi de, Sayfa gelen kutusunda ayarlanan özel sorulardan önce gelir; API buz kırıcıları ayarlıyken bu sorular düzenlenemez.
Kalıcı menü nasıl oluşturulur?
Her yerel ayar için bir tane olacak şekilde, default zorunlu olmak üzere menülerden oluşan bir dizi olarak; her biri web_url veya postback türünde en fazla 20 call_to_actions içerir. Başlık en fazla 30 karakter, bir postback payload'u en fazla 1.000 karakter alabilir; composer_input_disabled değeri true ayarlandığında menü, düğmeler ve web görünümleri etkileşimin tek yolu olarak kalır. Meta'nın göründükten önceki gereksinimleri:
- Zaten ayarlanmış bir Get Started düğmesi ve
pages_messagingizni. - Yayımlanmış bir Sayfa ve uygulamanın herkese açık olarak ayarlanmış olması.
- Ayarlayan kişi için Sayfada Yönetici rolü.
- iOS veya Android'de Messenger v106 ya da üstü, Facebook uygulamasının uygulama içi tarayıcısı dışında.
- Sayfa düzeyindeki değişiklikler 24 saate kadar sürebilir; PSID ile
custom_user_settingsüzerinden ayarlanan tek bir kişiye yönelik menü gerçek zamanlı güncellenir.
Komutlar nedir?
Kişinin her zaman çağırabileceği anahtar kelimeler; yazma alanının yanındaki komut menüsünden, bir eğik çizgi ya da at işareti yazarak veya eşleşen bir kelime yazdığında açılan pencereden çağrılır. Her yerel ayar 1 ila 100 komut içerir; ad 1 ila 32 karakter olup başında eğik çizgi olmaz, açıklama 1 ila 64 karakterdir. Komutlar ayarlandığında kalıcı menüye göre önceliklidir. Çağrılan komutlar, messages olayının içinde message.commands alanıyla uygulamaya ulaşır.
whitelisted_domains ve account_linking_url ne işe yarar?
İkisi de sohbetin dışındaki deneyimlere hizmet eder. whitelisted_domains, Messenger Extensions SDK ve onay kutusu eklentisi için Messenger web görünümünün açabileceği en fazla 50 alan adını listeler; her biri HTTPS üzerinden, tam nitelikli bir adla sunulmalıdır, asla bir IP adresi ya da localhost olamaz ve bunu ayarlamak için Sayfada Yönetici rolü gerekir. account_linking_url, kişinin Messenger hesabını işletmedeki hesabına bağlayan HTTPS geri çağırma adresidir.
easyCoexistence bir Sayfanın Messenger profilini nasıl ayarlar?
Hayır: {page-id}/messenger_profile uç noktasını çağıran bir araç yoktur ve Sayfa token'ları verilmez, bu yüzden profili ayarlamak bu bağlantının dışındadır. Kişilerin çağırdığı komutlar, easyCoexistence'ın ilettiği ve otomasyonların okuduğu messages olayında gelir. Meta'nın messaging_postbacks olayları olarak bildirdiği dokunuşlar (Get Started, postback menü öğeleri ve buz kırıcılar) iletilmez, çünkü Sayfalar feed, messages ve mention olaylarına abonedir.
Yaygın hatalar
- Kalıcı menüyü Get Started düğmesinden önce ayarlamak. Meta'nın gereksinimleri arasında bir Get Started düğmesi vardır, bu yüzden önce get_started ayarlayın.
- Varsayılan yerel ayarı atlamak. Buz kırıcılar, menüler ve komutların her biri, yedek olarak locale değeri default olan bir nesneye ihtiyaç duyar.
- Profil API'sini bir döngüde çağırmak. Meta her Sayfa için 10 dakikada 10 çağrıya izin verir; bu yüzden birden çok özelliği tek bir POST içinde gönderin.
- Menü değişikliğinin hemen görünmesini beklemek. Sayfa düzeyindeki bir menü güncellemesinin insanlara ulaşması 24 saate kadar sürebilir.
Messenger profilini ayarlamak araçları arasında yer almaz. Bağlantı başına aylık US$ 9 ile US$ 0,75 arası; bağlantı ekledikçe fiyat düşer. İlk 3 gün ücretsiz.
Sık sorulan sorular
Kalıcı menü kişiye göre farklı olabilir mi?
Evet. Kişinin PSID değeriyle custom_user_settings, o kişi için Sayfanın menüsünün üzerine yazar, gerçek zamanlı güncellenir ve kişi başına 10 dakikada 10 çağrıya izin verir.
Messenger profili hangi yerel ayarları destekler?
Meta'nın desteklenen yerel ayarlar listesindekileri, örneğin en_GB, pt_BR ve ja_JP gibi; buna ek olarak, kişinin yerel ayarına uyan bir değer bulunmadığında kullanılan yedek default.
Bir Sayfanın Messenger profilini kim değiştirebilir?
pages_messaging izni taşıyan bir Sayfa token'ına sahip uygulama. Kalıcı menü, karşılama metni ve alan adı listesi için ayrıca Sayfada Yönetici rolü gerekir.
easyCoexistence bir Facebook Sayfası için ne kadar tutar?
Her Sayfa bir bağlantıdır: bağlantı başına aylık US$ 9 ile US$ 0,75 arası, fiyat bağlantı sayınız arttıkça düşer ve ilk 3 gün ücretsizdir.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi