Pagbasa ng Instagram DM history: ang Conversations API
Binabasa ng Instagram Conversations API ang DM history ng isang professional account sa graph.instagram.com. Inililista ng GET /me/conversations?platform=instagram ang mga conversation kasama ang kanilang updated_time, inililista ng GET /<CONVERSATION_ID>?fields=messages ang mga mensahe ng isang conversation ayon sa ID at oras, at ibinabalik ng GET /<MESSAGE_ID>?fields=id,created_time,from,to,message ang isang mensahe. Available ang detalye para sa 20 pinakabagong mensahe sa bawat conversation.
Ipinapasa ng easyCoexistence ang mga bagong Instagram DM sa iyong endpoint habang dumarating, at sumasagot gamit ang send_social_dm sa loob ng 24-hour window, mula sa Claude, ChatGPT o sa sarili ninyong code, sa opisyal na API ng Meta; wala itong tool para sa kasaysayan ng Conversations API.
Pinakabagong mensahe sa bawat conversation na ibinabalik ng API ang detalye; ang mas luma ay sumasagot ng error na nagsasabing na-delete na ang mga ito.
Tagal ng kawalan ng aktibidad pagkatapos nito, hindi na ibinabalik ang mga conversation sa folder na Requests.
Bilang ng Conversations API call kada segundo na maaaring gawin ng app para sa bawat Instagram professional account.
instagram_business_basic at instagram_business_manage_messages, sa token ng taong may pahintulot na pamahalaan ang mensahe ng account.
Paano ililista ang mga conversation ng isang account?
Gamit ang GET /me/conversations, o /<IG_ID>/conversations, at platform=instagram, gamit ang Instagram User access token ng taong may pahintulot na mag-manage ng mensahe sa account. Bawat entry sa data array ay isang conversation, may kasamang id at updated_time.
GET https://graph.instagram.com/me/conversations
?platform=instagram
&access_token=<ACCESS_TOKEN>
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
]
}Paano hahanapin ang conversation ng isang tao?
Idagdag ang user_id kasama ang Instagram-scoped ID ng tao, ang IGSID na dumarating bilang sender.id kapag nag-message siya sa account, at ibinabalik ng response ang id ng conversation na iyon. Ginagawa nitong thread ang isang webhook event nang hindi kinakailangang i-page ang buong listahan.
GET https://graph.instagram.com/me/conversations
?user_id=<IGSID>
&access_token=<ACCESS_TOKEN>Paano binabasa ang mga mensahe?
Sa dalawang hakbang. Ang GET /<CONVERSATION_ID>?fields=messages ay naglilista ng mga mensahe ng conversation ayon sa id at created_time, ang default na fields. Ang GET /<MESSAGE_ID> na may fields=id,created_time,from,to,message ay nagbabalik ng isang mensahe: sino ang nagpadala at kanino, bawat isa may username at ID, at ang text nito.
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>Gaano kalayo ang maaaring basahin pabalik?
Apat na limitasyon ang itinakda ng gabay at pangkalahatang-ideya ng Meta sa ibabalik:
- Detalye ng mensahe: ang 20 pinakabagong mensahe sa bawat conversation; ang paghingi ng mas luma ay sumasagot ng error na nagsasabing na-delete na ito.
- Requests: ang mga conversation sa folder na Requests na walang aktibidad sa loob ng 30 araw ay hindi ibinabalik.
- Shares: ang shared na post o Reel ay ibinabalik lamang bilang URL ng image o video nito.
- Rate: 2 call kada segundo para sa bawat Instagram professional account.
Ano ang kailangan nito?
Sa Instagram Login, ang mga permission na instagram_business_basic at instagram_business_manage_messages, at token ng taong may pahintulot na mag-manage ng mensahe sa account. Sapat na ang Standard Access para sa mga account na pagmamay-ari o pinamamahalaan ninyo at idinagdag ninyo sa app; ang pag-serve ng ibang account ay nangangailangan ng Advanced Access. Kailangan ding naka-on ang Allow access to messages sa mga setting ng Instagram app ng account.
Bakit kailangang mag-imbak ng record mula sa webhook?
Dahil 20 pinakabagong mensahe lamang ng bawat conversation ang ibinabalik ng API, kailangang itabi ang buong history habang nangyayari ito. Ipinapadala ng messages webhook ang mga DM habang dumarating, kasama ang IGSID ng tao bilang sender.id, at dumarating din ang mga mensaheng ipinapadala ng account, na baligtad ang mga ID, kaya parehong panig ng conversation ay maitatala.
Paano binabasa ang DM history sa pamamagitan ng easyCoexistence?
Ipinapasa nito ang mga DM sa halip na magbasa ng kasaysayan. Ang mga bagong DM ay umaabot sa iyong endpoint habang dumarating, kapag itinakda ito gamit ang set_social_webhook_destination, at ipinapasa nang hindi nag-iiwan ng kopya. Sumasagot ang send_social_dm sa loob ng 24-hour window, mula sa Claude, ChatGPT o sa sarili ninyong code. Walang tool na tumatawag sa me/conversations, kaya ang mga naunang mensahe ay binabasa sa Instagram app, o iniingatan ng sarili ninyong system habang dumarating.
Mga karaniwang pagkakamali
- Pag-asang makuha ang buong thread mula sa API. Hanggang 20 pinakabagong mensahe lang ang detalye, kaya itabi ang mga DM mula sa messages webhook habang dumarating.
- Pag-poll ng conversations para sa mga bagong DM. Dalawang call kada segundo lang bawat account ang pinapayagan ng API, habang ipinapadala ng messages webhook ang bawat DM pagdating nito.
- Paghahanap ng lumang mensahe sa Requests. Ang mga conversation sa Requests na may 30 araw na walang aktibidad ay hindi na ibinabalik.
- Pagbasa sa deleted error bilang pagtanggal ng tao. Ganito sumagot ang Meta sa sinumang mensaheng mas luma sa 20 pinakabagong.
US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may 3 araw na free trial.
Mga madalas itanong
Maaari ko bang i-export ang buong DM history ng isang Instagram account?
Hindi nang buo sa pamamagitan ng API: inililista nito ang mga conversation pero nagbabalik ng detalye para sa 20 pinakabagong mensahe ng bawat isa. Ang kumpletong record ay nagmumula sa pag-iimbak ng mga DM habang ipinapadala ito ng webhook.
Minamarkahan ba ng pagbasa ng mensahe sa API bilang nabasa na?
Hindi. Sinasabi ng Meta na ang mga mensaheng naipadala sa pamamagitan ng API ay hindi minamarkahang nabasa sa Instagram app hanggang maipadala ang sagot.
Gumagana ba ang Conversations API sa Instagram Login?
Oo. Ang gabay ng Meta para dito ay isinulat para sa Instagram Login, na may mga tawag sa graph.instagram.com at mga permission na instagram_business_*.
Paano ko makukuha ang username ng isang tao mula sa conversation?
Kunin ang field na from sa isang mensahe, na nagbabalik ng username at ID ng nagpadala. Mas maraming detalye, gaya ng pangalan, ang ibinabalik ng User Profile API mula sa kanilang IGSID kapag nakapag-message na sila sa account.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong