Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

Messenger konuşma geçmişini API ile okumak

Facebook Sayfasının Messenger geçmişi, son güncellenme zamanlarıyla konuşma kimliklerini listeleyen GET /{page-id}/conversations?platform=messenger çağrısıyla okunur. Ardından GET /{conversation-id}?fields=messages ile mesaj kimlikleri alınır ve her mesajın gönderenini, alıcısını, metnini ve eklerini GET /{message-id} ile okursunuz. Meta bir konuşmanın en yeni 20 mesajının ayrıntılarını döndürür; çağrılar pages_messaging izni olan bir Page token'ı gerektirir.

easyCoexistence, bir Sayfanın yeni Messenger mesajlarını geldikleri anda uç noktanıza iletir ve send_social_dm, Claude, ChatGPT veya kendi kodunuzdan 24 saatlik pencere içinde yanıt gönderir.

20 messages

Yalnızca bir konuşmadaki en yeni 20 mesajın ayrıntıları döner; daha eskileri mesajın silindiğini belirten bir hata döndürür.

2 per second

Bir uygulamanın her Facebook Sayfası için yapabileceği Conversations API çağrı sayısı.

30 days

Requests klasöründe, belirtilen süre boyunca etkin olmayan konuşmalar API sonuçlarından çıkarılır.

MESSAGING or MODERATE

Konuşmaları okumak için token'ın sahibi kişinin yerine getirebilmesi gereken Sayfa görevi.

80006

Bir Sayfa hesabına çok fazla Messenger API çağrısı yapıldığında dönen hata; Meta kısa bir süre bekleyip yeniden denemenizi söyler.

Bir Sayfanın konuşmalarını nasıl listelersiniz?

platform değerini messenger olarak ayarlayarak GET /{page-id}/conversations çağrısını yaparsınız. Sonuç, konuşma kimliklerinden oluşan bir data dizisi döndürür; her kimlikle birlikte son mesajın eklendiği zamanı gösteren updated_time ve bir paging nesnesi gelir. Meta'nın referansı bu uç noktada zamana dayalı sayfalamanın kullanılamadığını belirtir, bu yüzden listede ilerlemek için paging nesnesini izleyin.

Listing a Page's Messenger conversations
GET /{page-id}/conversations?platform=messenger

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
  ],
  "paging": { ... }
}

Tek bir kişinin konuşmasını nasıl bulursunuz?

Aynı isteğe user_id ekleyin ve değerine kişinin Sayfaya özgü ID'sini yazın. Meta, Sayfa ile o kişi arasındaki konuşmanın ID'sini döndürür. Bu, PSID'nin sender.id olarak geldiği messages webhook'undan geçmişe giden en kısa yoldur:

One person's conversation
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>

{ "data": [ { "id": "<CONVERSATION_ID>" } ] }

Bir konuşmadaki mesajları nasıl okursunuz?

İki adımda. fields=messages ile GET /{conversation-id} çağrısı, konuşmanın mesaj kimliklerini döndürür; her biriyle created_time bilgisi gelir ve en yeni mesaj en başta yer alır. Ardından ihtiyacınız olan alanlarla, örneğin id, created_time, from, to, message ve reply_to ile GET /{message-id} çağrısı tek bir mesajın içeriğini döndürür. Varsayılan alanlar id ve created_time'dir; verisi olmayan bir alan yanıta dahil edilmez.

Hangi alanları okuyabilirsiniz?

Konuşma ve mesaj farklı alanları açığa çıkarır. Bunlar Meta'nın Sayfa mesajlaşması için listelediği alanlardır:

  • Konuşma: id, updated_time, ID, ad ve e-posta ile katılımcılar (participants), messages ve Conversation Routing açık olduğunda is_owner.
  • Mesaj: id, created_time, ID, ad ve e-posta içeren from ve to, metin olan message (metin yoksa boş).
  • attachments: CDN URL'leriyle dosyalar, görseller ve videolar; is_unsupported ise yalnızca mesaj desteklenmeyen içerik taşıdığında döner.
  • reactions, yanıtladığı mid ile reply_to ve is_self_reply, ayrıca paylaşılan gönderiler ve reel'ler için shares.
  • tags: mesajın klasörü ve kaynağı, örneğin inbox, read veya source:chat.

Geriye doğru ne kadar okuyabilirsiniz?

Kimlikler için konuşmanın tamamına, içerik için ise yalnızca son mesajlara kadar. Meta'nın kılavuzu, konuşma uç noktasının bir konuşmadaki tüm mesaj kimliklerini döndürdüğünü, ayrıntıların ise yalnızca en yeni 20 mesaj için geldiğini söyler; daha eski birini istemek, mesajın silindiğini belirten bir hata döndürür. Requests klasöründe 30 gündür etkin olmayan konuşmalar hiç döndürülmez.

Hangi izinler ve görevler gerekir?

Sayfa üzerinde MESSAGING veya MODERATE görevini yerine getirebilen biri tarafından alınmış bir Page erişim token'ı, ayrıca pages_manage_metadata, pages_read_engagement ve pages_messaging izinleri gerekir. Uygulamada, Sayfada veya işletmede bir rolü olmayan kişilerle konuşmaları okumak için Advanced Access gerekir; bu erişimi Meta, App Review süreciyle verir.

Çağrılara hangi sınırlar uygulanır?

Meta'nın hız sınırları, Conversations API'ye Sayfa başına saniyede 2 çağrı verir; sınırı aşan çağrılar 613 veya 80006 kodu ile döner: There have been too many messenger api calls to this Page account. Saniyede 40 mesajdan fazla göndermek gibi Meta'nın yüksek hacim sınırına ulaşan bir Sayfa, hacim düşene kadar konuşmalarını listeleyemez; yine de tek bir konuşmanın yeni mesajları okunabilir.

API yerine webhook'ları ne zaman kullanmalısınız?

Geçmiş için. Webhook'lar yeni mesajları oluştukça iletir ve Meta, geçmiş bildirimlerin sonradan sorgulanamayacağını belirtir; bu nedenle Conversations API, bir entegrasyonun dinlemeye başlamadan önceki mesajları okuduğu ya da kesintiden sonra geri kalanı yakaladığı yoldur. Conversation Routing açıkken is_owner alanı listeyi, uygulamanın yanıtlamakla sorumlu olduğu konuşmalara indirir; Meta bunu kesinti sonrası kurtarma için önerir.

easyCoexistence Messenger geçmişini nasıl okur?

Geçmişi okumaz. Sayfa, pages_messaging, pages_manage_metadata ve pages_read_engagement izinleriyle bağlanır, ancak hiçbir araç Conversations API'yi çağırmaz ve Sayfa token'ları verilmez. Yeni mesajlar, geldikleri anda set_social_webhook_destination ile uç noktanıza iletilir; bir kopya tutulmadan aktarılır, böylece ihtiyaç duyduğu geçmişi kendi sisteminiz tutar.

Yaygın hatalar

  • Liste çağrısında mesaj içeriği beklemek. Konuşma uç noktası mesaj kimliklerini döndürür; her mesajın alanlarını /{message-id} üzerinden okuyun.
  • Tüm geçmişe güvenmek. Ayrıntılar en yeni 20 mesajda durur; bu nedenle ihtiyacınız olanı mesajlar geldikçe webhook'lardan kaydedin.
  • Yeni mesajlar için sürekli sorgulama yapmak. Sayfa başına saniyede 2 çağrıda bir sorgu döngüsü kısa sürede hız sınırına takılır; oysa messages webhook'u mesajları oluştukça iletir.
  • since ve until ile tarihe göre sayfalamak. Zamana dayalı sayfalama konuşmalar uç noktasında kullanılamaz; bunun yerine paging nesnesini izleyin.
Bunu EasyCoexistence'la yapmak

Conversations API için bir aracı yoktur; bu yüzden önceki geçmiş Sayfa gelen kutusunda okunur. Bağlantı başına aylık US$ 9 ile US$ 0,75 arasında; bağlantı ekledikçe fiyat düşer. İlk 3 gün ücretsiz deneme.

Sık sorulan sorular

Conversations API, Sayfanın kendi mesajlarını da içerir mi?

Evet. Bir mesajın from ve to alanları kişiyi ya da Sayfayı belirtir; bu nedenle bir konuşmanın mesajları iki tarafı da kapsar.

Messenger konuşmalarını App Review olmadan okuyabilir miyim?

Uygulamada ya da Sayfada rolü olan kişiler için Standard Access yeterlidir. Diğer herkesle olan konuşmalar, App Review ile verilen Advanced Access gerektirir.

Conversations API yanıt gönderebilir mi?

Hayır. Meta'nın konuşma referansı bu uç noktanın yayımlayamadığını söyler; yanıtlar /{page-id}/messages adresindeki Send API üzerinden gönderilir.

easyCoexistence Messenger konuşmalarımı saklar mı?

Varsayılan olarak hayır. İletilen olaylar bir kopya tutulmadan geçirilir; bir otomasyon açıksa mesaj metni 7 gün, otomasyon çalıştırma kayıtları ise 30 gün saklanır.

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