Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Viestihistorian lukeminen Instagramista: Conversations API

Instagramin Conversations API lukee ammattitilin DM-historiaa osoitteessa graph.instagram.com. GET /me/conversations?platform=instagram listaa keskustelut updated_time-kentän kanssa, GET /<CONVERSATION_ID>?fields=messages listaa keskustelun viestit ID:n ja ajan mukaan, ja GET /<MESSAGE_ID>?fields=id,created_time,from,to,message palauttaa yhden viestin. Tiedot ovat saatavilla kunkin keskustelun 20 uusimmasta viestistä.

easyCoexistence välittää uudet Instagram-DM-viestit endpointisi kautta heti niiden saapuessa ja vastaa send_social_dm-komennolla 24 tunnin ikkunassa.

20

Viimeisimmät viestit keskustelua kohden, joiden tiedot API palauttaa. Vanhemmista pyynnöistä palautuu virhe, jonka mukaan viesti on poistettu.

30 days

Inaktiivisuusaika, jonka jälkeen Requests-kansion keskustelut eivät enää palaudu.

2/sec

Conversations API -kutsut, joita sovellus voi tehdä sekunnissa kutakin Instagram-ammattitiliä kohden.

2 permissions

instagram_business_basic ja instagram_business_manage_messages, tokenilla, joka on henkilöltä, joka voi hallita tilin viestejä.

Miten tilin keskustelut listataan?

GET /me/conversations tai /<IG_ID>/conversations ja platform=instagram, käyttäen Instagram User access -tokenia henkilöltä, joka voi hallita tilin viestejä. Data-taulukon jokainen kohde on yksi keskustelu, jolla on id ja updated_time.

Listing conversations
GET https://graph.instagram.com/me/conversations
  ?platform=instagram
  &access_token=<ACCESS_TOKEN>

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
  ]
}

Miten löytää keskustelu yhden henkilön kanssa?

Lisää user_id henkilön Instagram-kohtaisella tunnisteella, eli IGSID:llä, joka saapuu sender.id-kenttään, kun hän lähettää viestin tilille. Vastaus palauttaa kyseisen keskustelun id:n. Näin webhook-tapahtuma saadaan yhdistettyä omaan ketjuunsa, eikä koko listaa tarvitse selata sivu kerrallaan.

One person's conversation
GET https://graph.instagram.com/me/conversations
  ?user_id=<IGSID>
  &access_token=<ACCESS_TOKEN>

Miten viestejä luetaan?

Kahdessa vaiheessa. GET /<CONVERSATION_ID>?fields=messages listaa keskustelun viestit id:n ja created_time-kentän mukaan, oletuskenttinä. GET /<MESSAGE_ID>, jossa on fields=id,created_time,from,to,message, palauttaa sitten yhden viestin: kuka lähetti ja kenelle, kummatkin username- ja ID-tunnisteen kanssa, sekä sen teksti.

A conversation's messages, then one message
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>

Kuinka pitkälle taaksepäin voi lukea?

Metan ohje ja yleiskuvaus asettavat neljä rajoitusta sille, mitä palautuu:

  • Viestien tiedot: 20 uusinta viestiä kussakin keskustelussa. Vanhemman pyytäminen palauttaa virheen, jonka mukaan se on poistettu.
  • Requests: Requests-kansion keskustelut, joissa ei ole ollut toimintaa 30 päivään, eivät palaudu.
  • Jaot: jaettu julkaisu tai Reel palautuu vain kuvan tai videon URL-osoitteena.
  • Nopeus: 2 kutsua sekunnissa kutakin Instagram-ammattitiliä kohden.

Mitä se vaatii?

Instagram Loginilla oikeudet instagram_business_basic ja instagram_business_manage_messages sekä henkilöltä peräisin oleva token, jolla voi hallita tilin viestejä. Standard Access riittää tileille, jotka omistat tai hallinnoit ja olet lisännyt sovellukseen. Muiden tilien palvelemiseen tarvitaan Advanced Access. Tilillä täytyy lisäksi olla päällä Allow access to messages Instagram-sovelluksen asetuksissa.

Miksi tallentaa tiedot webhookin kautta?

Koska API palauttaa tiedot vain kunkin keskustelun 20 uusimmasta viestistä, koko historia on tallennettava samalla kun se syntyy. Messages-webhook toimittaa DM-viestit heti niiden saapuessa, ja henkilön IGSID:n ollessa sender.id. Tilin lähettämät viestit saapuvat myös, mutta tunnisteet kääntyvät toisin päin, joten keskustelun molemmat puolet voidaan tallentaa.

Miten luet DM-historiaa easyCoexistencen kautta?

Se välittää DM-viestit eikä lue historiaa. Uudet DM-viestit saapuvat endpointisi kautta heti, kun asetat sen set_social_webhook_destination-komennolla. Ne välitetään ilman kopion tallentamista. send_social_dm vastaa viesteihin 24 tunnin ikkunassa, Claudesta, ChatGPT:stä tai omasta koodistasi. Mikään työkalu ei kutsu me/conversations-polkua, joten aiemmat viestit luetaan Instagram-sovelluksessa tai oma järjestelmäsi tallentaa ne niiden saapuessa.

Yleiset virheet

  • Odotetaan koko ketjua API:sta. Tiedot loppuvat 20 uusimmasta viestistä, joten tallenna DM-viestit messages-webhookista heti niiden saapuessa.
  • Uusien DM-viestien kyselyä keskusteluista. API sallii 2 kutsua sekunnissa tiliä kohden, kun messages-webhook toimittaa jokaisen DM-viestin heti sen saapuessa.
  • Vanhan viestipyynnön etsiminen. Requests-kansion keskustelut, joissa on 30 päivän toimettomuus, eivät enää palaudu.
  • Virheen lukeminen henkilön poistona. Meta vastaa näin jokaiselle viestille, joka on vanhempi kuin 20 uusinta.
Näin teet tämän EasyCoexistencen avulla

Käytettävissä Claudesta, ChatGPT:stä tai omasta koodistasi, Metan virallisella API:lla. Conversations API:n historiaan sillä ei ole työkalua. US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, hinta laskee yhteyksiä lisättäessä. Ensimmäiset 3 päivää ovat ilmaista kokeilua.

Usein kysytyt kysymykset

Voinko viedä Instagram-tilin koko DM-historian?

Et kokonaan API:n kautta: se listaa keskustelut, mutta palauttaa tiedot vain kunkin 20 uusimmasta viestistä. Täydellinen tallenne syntyy tallentamalla DM-viestit sitä mukaa kuin webhook ne toimittaa.

Merkitseekö viestien lukeminen API:n kautta ne luetuiksi?

Ei. Meta kertoo, että API:n kautta toimitettuja viestejä ei merkitä luetuiksi Instagram-sovelluksessa ennen kuin vastaus lähetetään.

Toimiiko Conversations API Instagram Loginin kanssa?

Kyllä. Metan ohje on kirjoitettu Instagram Loginille, ja siinä kutsutaan graph.instagram.com-osoitetta ja instagram_business_*-oikeuksia.

Miten saan henkilön käyttäjänimen keskustelusta?

Pyydä viestiltä from-kenttä, joka palauttaa lähettäjän käyttäjänimen ja ID:n. User Profile API palauttaa enemmän, kuten nimen, IGSID:n perusteella, kun henkilö on lähettänyt viestin tilille.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu