IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Kusoma historia ya mazungumzo ya Messenger kupitia API

Historia ya Messenger ya Page ya Facebook husomwa kwa GET /{page-id}/conversations?platform=messenger, ambayo huorodhesha vitambulisho vya mazungumzo pamoja na muda wa sasisho la mwisho. Kisha GET /{conversation-id}?fields=messages hutoa vitambulisho vya ujumbe, na GET /{message-id} hutoa mtumaji, mpokeaji, maandishi na viambatisho vya kila ujumbe. Meta hurudisha maelezo ya ujumbe 20 wa hivi karibuni wa mazungumzo, na simu hizi zinahitaji token ya Page yenye pages_messaging.

easyCoexistence husambaza ujumbe mpya wa Messenger wa Page kwenye endpoint yako unapowasili, na send_social_dm hujibu ndani ya dirisha la huduma kwa wateja la saa 24, kutoka kwa Claude, ChatGPT au msimbo wako mwenyewe.

20 messages

Ujumbe 20 wa hivi karibuni tu ndio hurudisha maelezo katika mazungumzo; ujumbe wa zamani hurudisha hitilafu inayosema ujumbe umefutwa.

2 per second

Idadi ya simu za Conversations API ambazo programu inaweza kufanya kwa kila Page ya Facebook.

30 days

Mazungumzo yaliyo kwenye folda ya Requests ambayo hayajatumika kwa muda huu hayajumuishwi kwenye matokeo ya API.

MESSAGING or MODERATE

Kazi ya Page ambayo mtu aliye nyuma ya token lazima aweze kuitekeleza ili kusoma mazungumzo.

80006

Hitilafu ya simu nyingi mno za Messenger API kwa akaunti ya Page; Meta inasema subiri kidogo kisha ujaribu tena.

Unaorodheshaje mazungumzo ya Page?

Kwa GET /{page-id}/conversations, ukiweka platform kuwa messenger. Matokeo yana safu ya data ya vitambulisho vya mazungumzo, kila moja likiwa na updated_time, yaani muda ujumbe wa mwisho uliongezwa, pamoja na kitu cha paging. Marejeleo ya Meta yanaeleza kwamba upangaji kwa muda haupatikani kwenye endpoint hii, kwa hiyo fuata kitu cha paging kusogea kwenye orodha.

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": { ... }
}

Unapataje mazungumzo ya mtu mmoja?

Ongeza user_id, ukiweka kuwa kitambulisho cha mtu huyo kilichoambatanishwa na Page, kwenye ombi lilelile. Meta hujibu kwa kitambulisho cha mazungumzo kati ya Page na mtu huyo, ambayo ndiyo njia fupi zaidi kutoka kwenye webhook ya ujumbe, ambako PSID hufika kama sender.id, hadi historia iliyo nyuma yake:

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

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

Unasomaje ujumbe kwenye mazungumzo?

Kwa hatua mbili. GET /{conversation-id} yenye fields=messages hurudisha vitambulisho vya ujumbe wa mazungumzo, kila moja na created_time, la hivi karibuni likitangulia; kisha GET /{message-id} yenye sehemu unazohitaji, kama id, created_time, from, to, message na reply_to, hurudisha maudhui ya ujumbe mmoja. Sehemu chaguo-msingi ni id na created_time, na sehemu isiyo na data haijumuishwi kwenye jibu.

Ni sehemu zipi unazoweza kusoma?

Mazungumzo na ujumbe vina sehemu tofauti. Hizi ndizo ambazo marejeleo ya Meta ya ujumbe wa Page yanaorodhesha:

  • Mazungumzo: id, updated_time, participants pamoja na kitambulisho, jina na barua pepe yao, messages, na is_owner mara tu Conversation Routing inapowashwa.
  • Ujumbe: id, created_time, from na to, kila moja likiwa na kitambulisho, jina na barua pepe, na message, maandishi yenyewe, tupu pale yasipokuwepo.
  • attachments: faili, picha na video pamoja na URL zao za CDN, na is_unsupported, inayorudishwa tu ujumbe unapokuwa na maudhui yasiyoungwa mkono.
  • reactions, reply_to yenye mid inayojibu na is_self_reply, na shares kwa machapisho na reels yaliyoshirikiwa.
  • tags: folda na chanzo cha ujumbe, kama inbox, read au source:chat.

Unaweza kusoma nyuma kwa kiasi gani?

Hadi mwanzo wa mazungumzo kwa vitambulisho, lakini si kwa maudhui. Mwongozo wa Meta unasema endpoint ya mazungumzo hurudisha vitambulisho vyote vya ujumbe katika mazungumzo, huku maelezo yakirudishwa kwa ujumbe 20 wa hivi karibuni pekee; kuomba ujumbe wa zamani kunarudisha hitilafu kwamba ujumbe umefutwa. Mazungumzo yaliyo kwenye folda ya Requests ambayo hayajatumika kwa siku 30 hayarudishwi kabisa.

Inahitaji ruhusa na kazi gani?

Token ya ufikiaji ya Page kutoka kwa mtu anayeweza kutekeleza kazi ya MESSAGING au MODERATE kwenye Page, pamoja na ruhusa za pages_manage_metadata, pages_read_engagement na pages_messaging. Kusoma mazungumzo na watu wasio na jukumu lolote kwenye programu, Page au biashara kunahitaji Advanced Access, ambayo Meta huitoa kupitia App Review.

Simu zinakabiliwa na vikwazo gani?

Vikomo vya kasi vya Meta vinaipa Conversations API simu 2 kwa sekunde kwa kila Page, na simu zinazopita kikomo hurudi kama 613 au 80006, There have been too many messenger api calls to this Page account. Page inayofikia kikomo cha kiwango cha juu cha Meta, kama kutuma ujumbe zaidi ya 40 kwa sekunde, haiwezi kuorodhesha mazungumzo yake hadi kiasi kipungue, ingawa mazungumzo moja bado yanaweza kusomwa kwa ujumbe mpya.

Ni lini utumie API badala ya webhooks?

Kwa yaliyopita. Webhook hutuma ujumbe mpya unapotokea, na Meta inaeleza kwamba arifa zilizopita haziwezi kuulizwa baadaye, kwa hiyo Conversations API ndiyo njia ambayo muunganisho husoma yaliyotokea kabla haujaanza kusikiliza, au kupata yaliyokosekana baada ya hitilafu ya huduma. Conversation Routing ikiwa imewashwa, sehemu ya is_owner hupunguza orodha hadi mazungumzo ambayo programu inawajibika kujibu, jambo ambalo Meta inapendekeza kwa urejeshaji baada ya huduma kusimama.

easyCoexistence inasomaje historia ya Messenger?

Haisomi historia. Page inaunganishwa na ruhusa za pages_messaging, pages_manage_metadata na pages_read_engagement, lakini hakuna zana inayoita Conversations API, na token za Page hazitolewi. Ujumbe mpya hufika kwenye endpoint yako kupitia set_social_webhook_destination unapowasili, ukipitishwa bila nakala, ili mfumo wako mwenyewe uhifadhi historia unayohitaji.

Makosa ya kawaida

  • Kutarajia maudhui ya ujumbe kwenye simu ya orodha. Endpoint ya mazungumzo hurudisha vitambulisho vya ujumbe; soma sehemu za kila ujumbe kutoka /{message-id}.
  • Kutegemea historia nzima. Maelezo yanaishia kwenye ujumbe 20 wa hivi karibuni, kwa hiyo hifadhi unachohitaji kutoka kwenye webhook ujumbe unapowasili.
  • Kuuliza ujumbe mpya mara kwa mara. Kwa simu 2 kwa sekunde kwa kila Page, kitanzi cha kuuliza kitafikia kikomo cha kasi haraka, wakati webhook ya ujumbe huyatuma yanapotokea.
  • Kupanga kurasa kwa tarehe kwa since na until. Upangaji kwa muda haupatikani kwenye endpoint ya mazungumzo; fuata kitu cha paging badala yake.
Kufanya hili ukitumia EasyCoexistence

Haina zana ya Conversations API, kwa hiyo historia ya awali inasomwa kwenye kikasha cha Page. US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inapungua unapoongeza miunganisho, pamoja na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Je, Conversations API inajumuisha ujumbe wa Page yenyewe?

Ndiyo. Sehemu za from na to hutaja mtu au Page, kwa hiyo ujumbe wa mazungumzo hujumuisha pande zote mbili.

Naweza kusoma mazungumzo ya Messenger bila App Review?

Kwa watu wenye jukumu kwenye programu au Page, Standard Access inatosha. Mazungumzo na mtu mwingine yeyote yanahitaji Advanced Access, yanayotolewa kupitia App Review.

Je, Conversations API inaweza kutuma majibu?

Hapana. Marejeleo ya Meta ya mazungumzo yanasema endpoint hiyo haiwezi kuchapisha; majibu hupitia Send API kwenye /{page-id}/messages.

Je, easyCoexistence huhifadhi mazungumzo yangu ya Messenger?

Si kwa chaguo-msingi. Matukio yaliyosambazwa hupitishwa bila kuweka nakala; ukiwasha otomatiki, maandishi ya ujumbe huhifadhiwa kwa siku 7 na kumbukumbu za uendeshaji wa otomatiki kwa siku 30.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye