Instagram DM geçmişini okumak: Conversations API
Instagram'ın Conversations API'si, bir profesyonel hesabın DM geçmişini graph.instagram.com üzerinden okur. GET /me/conversations?platform=instagram, her konuşmayı updated_time değeriyle listeler; GET /<CONVERSATION_ID>?fields=messages, bir konuşmanın mesajlarını ID ve zamana göre listeler; GET /<MESSAGE_ID>?fields=id,created_time,from,to,message ise tek bir mesajı döndürür. Ayrıntılar, her konuşmadaki en son 20 mesaj için kullanılabilir.
easyCoexistence, yeni Instagram DM'lerini geldikçe uç noktanıza iletir ve 24 saatlik pencere içinde send_social_dm ile yanıt verir; Claude, ChatGPT veya kendi kodunuzdan, Meta'nın resmi API'si üzerinden.
Her konuşmada, API'nin ayrıntılarını döndürdüğü en son mesajlar; daha eski olanlar silindiklerini belirten bir hatayla yanıtlanır.
Requests klasöründeki konuşmaların, hareketsiz kalındıktan sonra artık döndürülmediği süre.
Her Instagram profesyonel hesabı için bir uygulamanın saniyede yapabileceği Conversations API çağrısı sayısı.
instagram_business_basic ve instagram_business_manage_messages, hesabın mesajlarını yönetebilen birinin token'ı üzerinde.
Bir hesabın konuşmaları nasıl listelenir?
GET /me/conversations veya /<IG_ID>/conversations ile ve platform=instagram parametresiyle, hesapta mesajları yönetebilen birinin Instagram User access token'ı kullanılarak. data dizisindeki her girdi, kendi id ve updated_time değerleriyle bir konuşmadır.
GET https://graph.instagram.com/me/conversations
?platform=instagram
&access_token=<ACCESS_TOKEN>
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
]
}Bir kişiyle olan konuşma nasıl bulunur?
Kişinin Instagram kapsamlı ID'sini (IGSID) user_id parametresi olarak ekleyin; bu kimlik, hesaba mesaj gönderdiklerinde sender.id olarak gelir. Yanıt, o konuşmanın id'sini döndürür. Tüm listeyi sayfa sayfa gezmeden bir webhook olayını konuşmasına dönüştürür.
GET https://graph.instagram.com/me/conversations
?user_id=<IGSID>
&access_token=<ACCESS_TOKEN>Mesajlar nasıl okunur?
İki adımda. GET /<CONVERSATION_ID>?fields=messages, konuşmanın mesajlarını varsayılan alanlar olan id ve created_time ile listeler. Ardından GET /<MESSAGE_ID> isteğinde fields=id,created_time,from,to,message kullanıldığında tek bir mesaj döner: kimin kime gönderdiği (her biri kullanıcı adı ve ID ile) ve metni.
GET https://graph.instagram.com/<CONVERSATION_ID>
?fields=messages
&access_token=<ACCESS_TOKEN>
GET https://graph.instagram.com/<MESSAGE_ID>
?fields=id,created_time,from,to,message
&access_token=<ACCESS_TOKEN>Ne kadar geriye okunabilir?
Meta'nın kılavuzu ve genel bakış, geri dönenler üzerinde dört sınır belirler:
- Mesaj ayrıntıları: her konuşmadaki en son 20 mesaj; daha eskisi istenirse silindiğini belirten bir hata döner.
- İstekler: Requests klasöründe 30 gün boyunca etkinliği olmayan konuşmalar döndürülmez.
- Paylaşımlar: paylaşılan bir gönderi veya Reel, yalnızca görsel veya video URL'si olarak döner.
- Hız: her Instagram profesyonel hesabı için saniyede 2 çağrı.
Ne gerektirir?
Instagram Login ile birlikte, instagram_business_basic ve instagram_business_manage_messages izinleri ve hesapta mesajları yönetebilen birinin token'ı gerekir. Sahibi olduğunuz veya yönettiğiniz ve uygulamaya eklediğiniz hesaplar için Standard Access yeterlidir; diğer hesaplara hizmet vermek Advanced Access gerektirir. Hesabın Instagram uygulama ayarlarında 'Allow access to messages' seçeneğinin açık olması da gerekir.
Webhook'lardan neden kayıt tutulmalı?
API, her konuşmadaki yalnızca en son 20 mesajın ayrıntılarını döndürdüğü için tam geçmiş, oluştukça saklanmalıdır. messages webhook'u DM'leri geldikçe, kişinin IGSID'sini sender.id olarak iletir. Hesabın gönderdiği mesajlar da ters yönde ID'lerle gelir; böylece konuşmanın iki tarafı da kaydedilebilir.
easyCoexistence üzerinden DM geçmişi nasıl okunur?
Geçmişi okumaz, DM'leri iletir. Yeni DM'ler, set_social_webhook_destination ile bir adres ayarladığınızda, geldikçe uç noktanıza ulaşır ve bir kopyası tutulmadan iletilir. send_social_dm ise 24 saatlik pencere içinde yanıt gönderir; bunu Claude, ChatGPT veya kendi kodunuzdan yapabilirsiniz. Hiçbir araç me/conversations çağrısı yapmaz; bu yüzden eski mesajlar Instagram uygulamasında okunur ya da kendi sisteminiz tarafından, geldikçe saklanır.
Yaygın hatalar
- API'den tam konuşma beklemek. Ayrıntılar en son 20 mesajda durur; bu yüzden DM'leri messages webhook'undan geldikçe saklayın.
- Yeni DM'ler için konuşmaları yoklamak. API hesap başına saniyede 2 çağrıya izin verir, messages webhook'u ise her DM'yi geldiği anda iletir.
- Eski bir mesaj isteğini aramak. Requests içinde 30 gün hareketsiz kalan konuşmalar artık döndürülmez.
- Silindi hatasını kişinin silmesi sanmak. Meta, en son 20 mesaj dışındaki her mesaj için bu yanıtı verir.
Conversations API'nin geçmişi için bir aracı yoktur. Bağlantı başına aylık US$ 9'dan US$ 0.75'e, bağlantı ekledikçe düşen fiyatla; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
Instagram hesabının tüm DM geçmişini dışa aktarabilir miyim?
API üzerinden tam olarak hayır: konuşmaları listeler, ancak her birindeki en son 20 mesajın ayrıntılarını döndürür. Tam bir kayıt, DM'leri webhook'un ilettiği gibi saklayarak elde edilir.
API ile mesaj okumak, mesajları okundu olarak işaretler mi?
Hayır. Meta, API üzerinden iletilen mesajların, bir yanıt gönderilene kadar Instagram uygulamasında okundu olarak işaretlenmediğini belirtir.
Conversations API, Instagram Login ile çalışır mı?
Evet. Bunun için Meta'nın kılavuzu Instagram Login için yazılmıştır; graph.instagram.com çağrıları ve instagram_business_* izinleri kullanılır.
Bir konuşmadan kişinin kullanıcı adını nasıl alırım?
Bir mesajda from isteyin; bu, gönderenin kullanıcı adını ve ID'sini döndürür. User Profile API ise, hesaba mesaj gönderdikten sonra IGSID'lerinden ad gibi daha fazla bilgi döndürü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