Messenger-keskusteluhistorian lukeminen API:n kautta
Facebook-sivun Messenger-historia luetaan GET /{page-id}/conversations?platform=messenger -kutsulla, joka listaa keskustelujen ID:t ja niiden viimeisimmän päivityksen ajan. Sen jälkeen GET /{conversation-id}?fields=messages hakee viesti-ID:t ja GET /{message-id} jokaisen viestin lähettäjän, vastaanottajan, tekstin ja liitteet. Meta palauttaa tiedot keskustelun 20 uusimmasta viestistä, ja kutsut vaativat Page-tokenin, jolla on pages_messaging-oikeus.
easyCoexistence välittää sivun uudet Messenger-viestit päätepisteeseesi, kun ne saapuvat, ja send_social_dm vastaa 24 tunnin ikkunan sisällä, Claudesta, ChatGPT:stä tai omasta koodistasi.
Vain keskustelun 20 uusimmasta viestistä palautuu tiedot. Vanhemmat palauttavat virheen, jonka mukaan viesti on poistettu.
Conversations API -kutsujen määrä, jonka sovellus voi tehdä Facebook-sivua kohden.
Pyynnöt-kansion keskustelut, joita ei ole käytetty näin pitkään, jätetään API-tuloksista pois.
Sivutehtävä, jonka tokenin takana olevan henkilön on voitava suorittaa, jotta hän voi lukea keskusteluja.
Virhe liian monesta Messenger-API-kutsusta Facebook-sivun tilille. Meta suosittelee odottamaan hetken ja yrittämään uudelleen.
Miten Facebook-sivun keskustelut listataan?
GET /{page-id}/conversations -kutsulla, jossa platform on messenger. Tulos sisältää data-taulukon keskustelu-ID:istä, joista kukin sisältää updated_time-kentän (viimeisimmän viestin lisäysajan) ja paging-objektin. Metan viitteen mukaan aikaan perustuva sivutus ei ole käytettävissä tässä päätepisteessä, joten etene listalla paging-objektin avulla.
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}Miten yhden henkilön keskustelu löydetään?
Lisää samaan pyyntöön user_id, jonka arvo on henkilön Page-kohtainen ID. Meta vastaa Facebook-sivun ja kyseisen henkilön välisen keskustelun ID:llä. Tämä on lyhin reitti messages-webhookista, jossa PSID tulee kenttään sender.id, historiaan, joka sen takana on:
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }Miten keskustelun viestit luetaan?
Kahdessa vaiheessa. GET /{conversation-id} kentällä fields=messages palauttaa keskustelun viesti-ID:t, joista kukin sisältää created_time-ajan, uusin ensin. Sen jälkeen GET /{message-id} tarvitsemillasi kentillä, kuten id, created_time, from, to, message ja reply_to, palauttaa yhden viestin sisällön. Oletuskentät ovat id ja created_time, ja kenttä ilman tietoa jätetään vastauksesta pois.
Mitkä kentät voit lukea?
Keskustelulla ja viestillä on eri kentät. Nämä ovat ne, jotka Metan viitteet listaavat Page-viestinnälle:
- Keskustelu: id,
updated_time, participants (kullakin ID, nimi ja sähköposti), messages sekäis_owner, kun Conversation Routing on päällä. - Viesti: id,
created_time, from ja to (kummassakin ID, nimi ja sähköposti) sekä message eli teksti, joka on tyhjä, jos tekstiä ei ole. - attachments: tiedostot, kuvat ja videot CDN-osoitteineen sekä
is_unsupported, joka palautuu vain, jos viesti sisältää tukematonta sisältöä. - reactions,
reply_to, johon vastataan mid-tunnisteella, sekäis_self_reply, ja shares jaetuille julkaisuille ja reeleille. - tags: viestin kansio ja lähde, kuten inbox, read tai source:chat.
Kuinka pitkälle taaksepäin voit lukea?
Keskustelun tunnisteisiin asti, mutta sisältöön ei. Metan oppaan mukaan keskustelun päätepiste palauttaa kaikki keskustelun viesti-ID:t, mutta tiedot palautuvat vain 20 uusimmalle viestille. Vanhemmasta viestistä pyytäminen palauttaa virheen, jonka mukaan viesti on poistettu. Pyynnöt-kansion keskustelut, joita ei ole käytetty 30 päivään, eivät palaudu lainkaan.
Mitä käyttöoikeuksia ja tehtäviä se tarvitsee?
Page-käyttöoikeustunnus henkilöltä, joka voi suorittaa Page-tehtävän MESSAGING tai MODERATE, sekä oikeudet pages_manage_metadata, pages_read_engagement ja pages_messaging. Keskustelujen lukeminen ihmisten kanssa, joilla ei ole roolia sovelluksessa, Page-sivulla tai yrityksessä, vaatii Advanced Accessin, jonka Meta myöntää App Review -prosessissa.
Mitkä rajoitukset kutsuihin pätevät?
Metan nopeusrajat antavat Conversations API:lle 2 kutsua sekunnissa Page-sivua kohden. Rajan ylittävät kutsut palautuvat virhekoodeina 613 tai 80006, joiden viesti kertoo, että tälle Page-tilille on tehty liian monta Messenger-API-kutsua. Sivu, joka ylittää Metan suuren volyymin rajan, kuten lähettää yli 40 viestiä sekunnissa, ei voi listata keskustelujaan ennen kuin volyymi laskee. Yksittäisen keskustelun uusia viestejä voi silti lukea.
Milloin kannattaa käyttää API:a webhookien sijaan?
Menneen lukemiseen. Webhookit toimittavat uudet viestit heti, kun ne tapahtuvat, ja Meta huomauttaa, ettei menneitä ilmoituksia voi kysyä jälkikäteen. Conversations API on siis tapa, jolla integraatio lukee sen, mitä tuli ennen kuin se alkoi kuunnella, tai palautuu seisokin jälkeen. Kun Conversation Routing on päällä, is_owner-kenttä rajaa listan keskusteluihin, joista sovellus vastaa, mitä Meta suosittelee palautumiseen seisokin jälkeen.
Miten easyCoexistence lukee Messenger-historian?
Se ei lue historiaa. Sivu yhdistetään oikeuksilla pages_messaging, pages_manage_metadata ja pages_read_engagement, mutta mikään työkalu ei kutsu Conversations API:a, eikä sivun tokeneita luovuteta. Uudet viestit saapuvat päätepisteeseesi set_social_webhook_destination-työkalun kautta heti, kun ne tulevat, ja ne välitetään eteenpäin ilman kopiota, joten oma järjestelmäsi säilyttää tarvitsemansa historian.
Yleiset virheet
- Odotetaan viestien sisältöä listakutsusta. Keskustelun päätepiste palauttaa viesti-ID:t, joten lue kunkin viestin kentät polusta /{message-id}.
- Luotetaan koko historiaan. Tiedot loppuvat 20 uusimpaan viestiin, joten tallenna webhookeista se, mitä tarvitset, kun viestit saapuvat.
- Kyselyä uusista viesteistä. Kahdella kutsulla sekunnissa Page-sivua kohden kyselysilmukka osuu pian nopeusrajaan, kun messages-webhook toimittaa viestit heti, kun ne tapahtuvat.
- Keskustelujen sivuttaminen päivämäärän mukaan since- ja until-parametreilla. Aikaan perustuvaa sivutusta ei ole saatavilla keskustelun päätepisteessä, joten seuraa sen sijaan paging-objektia.
Sillä ei ole työkalua Conversations API:lle, joten aiempi historia luetaan sivun Inboxista. Hinta alkaa US$ 9:stä ja laskee US$ 0,75:een yhteyttä kohden kuukaudessa, kun yhteyksiä lisätään. Ensimmäiset 3 päivää ovat ilmaista kokeilua.
Usein kysytyt kysymykset
Sisältääkö Conversations API myös sivun omat viestit?
Kyllä. Viestin from- ja to-kentät nimeävät henkilön tai sivun, joten keskustelun viesteissä on molemmat osapuolet.
Voinko lukea Messenger-keskusteluja ilman App Reviewta?
Henkilöille, joilla on rooli sovelluksessa tai Page-sivulla, Standard Access riittää. Keskustelut muiden kanssa vaativat Advanced Accessin, jonka saa App Reviewn kautta.
Voiko Conversations API lähettää vastauksia?
Ei. Metan keskustelureferenssin mukaan päätepiste ei voi julkaista. Vastaukset kulkevat Send API:n kautta osoitteessa /{page-id}/messages.
Tallentaako easyCoexistence Messenger-keskusteluni?
Ei oletuksena. Välitetyt tapahtumat välitetään eteenpäin tallentamatta kopiota; kun automaatio on päällä, viestin teksti säilytetään 7 päivää ja automaatiokäynnin lokit 30 päivää.
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