Messenger Send API: Facebook Sayfasından mesaj gönderme
Bir Facebook Sayfası, Sayfa erişim token'ı ile POST /{page-id}/messages uç noktasına istek göndererek Messenger mesajı gönderir: alıcı alanı kişinin Sayfaya özel kimliğini (PSID) taşır, messaging_type standart mesajlaşma penceresi içinde RESPONSE ya da UPDATE, pencerenin dışında ise MESSAGE_TAG olur ve message alanı metin ya da resim, ses, video veya dosya gibi bir ek içerir. Meta, recipient_id ve bir message_id ile yanıt verir.
easyCoexistence, Claude, ChatGPT ya da kendi kodunuzdan send_social_dm ile Messenger'daki DM'lere 24 saatlik pencere içinde metin olarak yanıt verir; medya, hızlı yanıtlar ve şablonlar kapsanmaz.
Bir uygulamanın Sayfa başına yapabileceği Send API çağrısı: metin, bağlantı, tepki ve çıkartma içeren mesajlar için.
Bir uygulamanın Sayfa başına yapabileceği Send API çağrısı: ses veya video içeren mesajlar için.
Messenger Platform'un yeniden kullanmak için sakladığı en büyük varlık; URL'den yüklenen bir resim 8 MB ile sınırlıdır.
Bir mesajın attachments dizisinde taşıyabileceği en fazla resim sayısı; bu dizide yalnızca resimlere izin verilir.
Kaydedilmiş bir attachment_id'nin ne kadar süre geçerli kaldığı; bu süreden sonra medyanın yeniden yüklenmesi gerekir.
Send API isteği neleri içerir?
Meta, bir gönderimde bulunması gereken altı bileşeni sayar: mesajı gönderen Sayfanın kimliği, alıcı kişinin kimliği, o Sayfaya ait bir Sayfa erişim token'ı, kişiden alınan izin, mesaj türü ve içerik. İstek, /{page-id}/messages adresine JSON olarak gönderilen bir POST'tur ve az önce yazmış birine verilen bir yanıt şöyle görünür:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }Alıcı alanına hangi kimlik girer?
Genellikle Meta'nın bir kişiye, Sayfaya ilk mesaj attığı anda atadığı Sayfaya özel kimlik, yani PSID girilir; bu kimlik messages webhook'unda sender.id olarak gelir. Alıcı nesnesi belirli durumlar için başka kimlik türlerini de kabul eder:
- id: PSID, o kişiye ve o Sayfaya özgü kimlik.
user_ref: bir eklenti ya da postback düğmesi kullanarak Sayfaya mesaj yazmış kişi için.comment_idveyapost_id: bir yoruma ya da ziyaretçi gönderisine verilen özel yanıt için.- Facebook Login'den gelen kimlikler uygulamaya özgüdür ve Messenger Platform'da çalışmaz.
Bir mesaj hangi messaging_type değerini kullanmalı?
Tür, Meta'ya mesajın neden gönderildiğini bildirir ve gönderimin ne zaman izinli olacağını belirler. Meta'nın Sayfa mesajları referansı dört değer sıralar:
- RESPONSE: Sayfanın aldığı bir mesaja yanıt; tanıtım içerikli olsun ya da olmasın, standart mesajlaşma penceresi içinde.
- UPDATE: Sayfanın kendi inisiyatifiyle gönderdiği mesaj; tanıtım içerikli olsun ya da olmasın, yine pencere içinde.
MESSAGE_TAG: Pencerenin dışında gönderilen, tanıtım içermeyen mesaj; onaylı bir kullanım senaryosuna uyan bir etiketle.- UTILITY: Sipariş ya da randevu güncellemesi gibi, onaylı bir şablondan oluşturulan bilgilendirme mesajı.
Bir mesaj neleri taşıyabilir?
Bir mesaj metin ya da tek bir ek nesnesi taşıyabilir; bu nesne bir tür ve payload içerir: resim, ses, video ve dosya ekleri bir URL'ye ya da kaydedilmiş bir attachment_id'ye işaret eder, şablon ekleri ise düğmeli yapılandırılmış mesajlar taşır. Aynı uç nokta şunları da kabul eder:
- attachments: tek mesaj olarak gönderilen en fazla 30 resimden oluşan bir dizi.
reply_toile mid: kişinin ya da Sayfanın daha önceki belirli bir mesajına verilen yanıt.quick_replies: yazma alanının üstünde en fazla 13 düğme; her birinin başlığı en fazla 20 karakter.sender_action: yazıyor göstergesi, görüldü işareti ya da tepki; mesajın kendisinden ayrı bir istekte gönderilir.notification_type: varsayılan olarak REGULAR; ya daSILENT_PUSHveyaNO_PUSH.
Ekler ne kadar büyük olabilir?
Meta'nın varlıkları kaydetme rehberi, Messenger Platform'un çektiği ve sakladığı medya için sınırları belirler: en fazla 25 MB'lık varlıklar, URL'den yüklendiğinde en fazla 8 MB'lık resimler, audio Content-Type ile gönderilen ses ve 75 saniye içinde alınan video. is_reusable değeri true olarak ayarlanırsa, yalnızca bu ekleri gönderen Sayfanın yeniden kullanabileceği bir attachment_id döner; bu kimlik 90 gün boyunca geçerlidir ve POST /{page-id}/message_attachments medyayı önceden yüklemeyi sağlar.
Send API hız sınırları nedir?
Meta bunları Sayfa başına ve içeriğe göre sayar. Meta'nın Sayfa mesajları referansı, gönderim hatalarının arasında 613 kodunu listeler: 'Bu API'ye yapılan çağrılar hız sınırını aştı'. Bu hata göründüğünde hemen yeniden denemek yerine yavaşlayın:
- Metin, bağlantı, tepki ve çıkartma içeren mesajlar için Sayfa başına saniyede 300 çağrı.
- Ses veya video içeren mesajlar için Sayfa başına saniyede 10 çağrı.
- Tek bir konuşmaya çok fazla mesaj, bu konuşmanın kendi başına hız sınırına takılmasına yol açabilir.
- Messenger API çağrıları genel olarak: etkileşimde bulunan kullanıcı sayısının 200 katı, kayan 24 saat içinde.
- Saniyede 40 mesajın üzerinde, Sayfa gelen kutusu yeni mesajları göstermeyi durdurur ve hacim düşene kadar Sayfa gönderemez.
Send API hangi hataları döndürür?
Meta'nın Messenger hata tablosu her kodu, nedeni adlandıran bir alt kodla eşleştirir. Bunlar, bir Sayfanın gönderim yaparken en sık karşılaştığı hatalardır:
- 10, 2018278 veya 2534022 ile: Bu mesaj izin verilen pencere dışında gönderildi.
- 10, 2018300 ile: konuşmayı başka bir uygulama kontrol ediyor.
- 100: Geçersiz parametre, örneğin hatalı bir alıcı kimliği; 2018001 alt kodu 'Eşleşen kullanıcı bulunamadı' der.
- 551: Kişi kullanılamıyor; Sayfayı engellemiş ya da hesabını devre dışı bırakmış olabilir; 200 ile 1545041 ise 'Bu kişi şu anda kullanılamıyor' der.
- 200, 2018028 ile: uygulama,
pages_messagingincelenip uygulama canlıya alınana kadar rolleri dışındaki kişilere mesaj gönderemez. - 10904: Sayfanın ayarlarında mesajlar kapalı.
easyCoexistence bunun üzerinden nasıl gönderir?
send_social_dm, account_id alanını, kişinin recipient_id alanını (iletilen bir messages olayında sender.id) ve metni alır; mesajı messaging_type RESPONSE ile /{page-id}/messages adresine gönderir. Sonuç, Meta'nın message_id ile verdiği yanıttır; reddedilen bir gönderim Meta'nın hata kodu ve mesajıyla geri döner. Medya, hızlı yanıtlar, şablonlar ve yazıyor göstergeleri araçlar arasında yoktur: send_social_dm metin gönderir.
Yaygın hatalar
- Yazıyor göstergesini mesajla birlikte göndermek. Meta yalnızca alıcı ile birlikte sender_action alanını ister; metin ya da şablonlar ayrı bir istekte gönderilmelidir.
- Tek bir kişiye peş peşe yoğun gönderim. Meta, Sayfanın saniyede 300 çağrı sınırından bağımsız olarak tek bir konuşmayı kendi başına hız sınırına alabilir.
- Ses ya da videoyu metin hızında göndermek. Ses ya da video içeren mesajlar, Sayfa başına saniyede 10 çağrı ile sınırlıdır.
- 90 günden eski bir attachment_id değerini yeniden kullanmak. Kaydedilmiş ek kimlikleri sona erer; yeni bir kimlik için medyayı yeniden yükleyin.
Otomasyonlar yeni mesajlara sabit bir metinle ya da bir yapay zekâ yanıtıyla kendiliğinden karşılık verir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı sayısı arttıkça düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
Messenger Send API ücretsiz mi?
Evet, standart mesajlar için. Meta'nın genel bakışı Messenger Platform'un kullanımını ücretsiz sayar; bu yüzden kendisine yazan kişilere yanıt veren bir Sayfa mesaj başına hiçbir ücret ödemez; pazarlama mesajları ise mesaj başına ücretlendirilir.
Mesaj göndermek için hangi Sayfa görevi gerekir?
Meta'nın Messenger genel bakışı, MESSAGING ve MODERATE görevlerini yerine getirebilen birinden, pages_messaging izni verilmiş bir Sayfa token'ı ister.
easyCoexistence Messenger'da resimle yanıt verebilir mi?
Bugün değil. send_social_dm metin gönderir ve hiçbir araç ek göndermez.
Bir Facebook Sayfası için easyCoexistence ne kadar tutar?
Bağladığınız her Sayfa bir bağlantıdır ve sayınıza bağlı olarak bağlantı başına aylık US$ 9 ile US$ 0.75 arasında ücretlendirilir; 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