Messenger Send API: kutuma ujumbe kutoka ukurasa wa Facebook
Ukurasa wa Facebook hutuma ujumbe wa Messenger kwa POST /{page-id}/messages na Page access token. Mpokeaji ana PSID ya mtu husika, yaani kitambulisho kinachohusu ukurasa huo pekee. messaging_type ni RESPONSE au UPDATE ndani ya dirisha la kawaida la ujumbe, au MESSAGE_TAG baada yake. message hubeba maandishi au kiambatisho kama picha, sauti, video au faili. Meta hujibu kwa recipient_id na message_id.
easyCoexistence hujibu DM kwenye Messenger kwa send_social_dm kutoka Claude, ChatGPT au msimbo wako mwenyewe ndani ya dirisha la saa 24, kama maandishi; midia, quick_replies na violezo havihusiki.
Maombi ya Send API ambayo programu inaweza kufanya kwa kila ukurasa kwa ujumbe wenye maandishi, viungo, miitikio na stika.
Maombi ya Send API ambayo programu inaweza kufanya kwa kila ukurasa kwa ujumbe wenye sauti au video.
Rasilimali kubwa zaidi ambayo Messenger Platform huhifadhi kwa matumizi upya; picha iliyopakiwa kutoka URL ina kikomo cha 8 MB.
Picha nyingi zaidi ambazo ujumbe mmoja unaweza kubeba katika safu ya attachments, aina pekee ya midia inayoruhusiwa hapo.
Muda ambao attachment_id iliyohifadhiwa hudumu kabla midia kulazimika kupakiwa tena.
Ombi la Send API lina nini?
Meta inataja vipengele sita ambavyo utumaji lazima uwe navyo: kitambulisho cha Ukurasa unaotuma, kitambulisho cha mtu anayepokea, Page access token kutoka Ukurasa huo, ruhusa ya mtu huyo, aina ya ujumbe na maudhui. Ombi ni POST ya JSON kwenda /{page-id}/messages, na jibu kwa mtu aliyeandika hivi punde linaonekana hivi:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }Ni kitambulisho gani kiwekwe kwenye recipient?
Kwa kawaida ni Page-scoped ID, au PSID, ambayo Meta humpa mtu mara ya kwanza anapoandika kwenye Ukurasa; hufika kama sender.id kwenye messages webhook. Kitu cha recipient kinakubali aina nyingine za vitambulisho kwa matukio maalum:
- id: PSID, ya kipekee kwa mtu huyo na Ukurasa huo.
user_ref: kwa mtu aliyetumia plugin au kitufe cha postback kuandika kwa Ukurasa.comment_idaupost_id: kwa jibu la faragha kwa maoni au chapisho la mgeni.- Vitambulisho kutoka Facebook Login vimefungwa kwa programu na havifanyi kazi kwenye Messenger Platform.
Ujumbe unapaswa kutumia messaging_type ipi?
Aina hiyo inaiambia Meta kwa nini ujumbe unatumwa, na inaamua ni lini utumaji unaruhusiwa. Ukurasa wa marejeo wa Meta wa ujumbe wa Page unaorodhesha thamani nne:
- RESPONSE: jibu kwa ujumbe ambao Ukurasa umepokea, wa kutangaza au la, ndani ya dirisha la kawaida la ujumbe.
- UPDATE: ujumbe ambao Ukurasa unatuma kwa hiari yake, wa kutangaza au la, pia ndani ya dirisha.
MESSAGE_TAG: ujumbe usio wa matangazo unaotumwa baada ya dirisha, wenye lebo inayolingana na matumizi yaliyoidhinishwa.- UTILITY: ujumbe wa huduma uliojengwa kutoka kiolezo kilichoidhinishwa, kama taarifa ya oda au miadi.
Ujumbe unaweza kubeba nini?
Maandishi, au kitu kimoja cha kiambatisho chenye type na payload: viambatisho vya picha, sauti, video na faili vinaelekeza kwenye URL au attachment_id iliyohifadhiwa, na viambatisho vya template hubeba ujumbe ulioundwa wenye vitufe. Endpoint hii hiyo pia inapokea vipengele hivi:
- attachments: safu ya hadi picha 30 zinazotumwa kama ujumbe mmoja.
reply_toyenye mid: jibu kwa ujumbe fulani uliotangulia, wa mtu au wa Ukurasa.quick_replies: hadi vitufe 13 juu ya kisanduku cha kuandika, kila title ikiwa hadi herufi 20.sender_action: kiashiria cha kuandika, alama ya kuona au miitikio, kinachotumwa kwa ombi tofauti na ujumbe wenyewe.notification_type: REGULAR kwa chaguo-msingi, auSILENT_PUSHauNO_PUSH.
Viambatisho vinaweza kuwa vikubwa kiasi gani?
Mwongozo wa Meta wa kuhifadhi rasilimali unaweka mipaka ya midia ambayo Messenger Platform huchukua na kuhifadhi: rasilimali za hadi MB 25, picha za hadi MB 8 zinapopakiwa kutoka URL, sauti inayotumwa na Content-Type ya sauti, na video inayochukuliwa ndani ya sekunde 75. Kuweka is_reusable kuwa true hurudisha attachment_id ambayo Ukurasa uliyoituma pekee unaweza kuitumia tena, kwa siku 90, na POST /{page-id}/message_attachments hupakia midia mapema.
Vikomo vya kasi vya Send API ni vipi?
Meta vinahesabu kwa kila Ukurasa na kulingana na aina ya maudhui. Ukurasa wa marejeo wa ujumbe wa Page unaorodhesha 613, Calls to this api have exceeded the rate limit, miongoni mwa hitilafu za utumaji, kwa hiyo punguza kasi badala ya kujaribu tena mara moja hilo likitokea:
- maombi 300 kwa sekunde kwa kila Ukurasa kwa ujumbe wenye maandishi, viungo, miitikio na stika.
- maombi 10 kwa sekunde kwa kila Ukurasa kwa ujumbe wenye sauti au video.
- Ujumbe mwingi sana kwenye mazungumzo moja unaweza kupunguzwa kasi wenyewe.
- Maombi yote ya Messenger API: mara 200 ya idadi ya watumiaji walioshiriki, katika kipindi cha saa 24 zinazosonga.
- Zaidi ya ujumbe 40 kwa sekunde, kikasha cha Ukurasa kinaacha kuonyesha ujumbe mpya na Ukurasa hauwezi kutuma hadi kiasi kipungue.
Send API inarudisha hitilafu gani?
Jedwali la hitilafu la Messenger la Meta linaoanisha kila msimbo na subcode inayotaja chanzo. Hizi ndizo ambazo Ukurasa hukutana nazo mara nyingi unapotuma:
- 10 yenye 2018278 au 2534022: Ujumbe huu umetumwa nje ya dirisha lililoruhusiwa.
- 10 yenye 2018300: programu nyingine inadhibiti mazungumzo.
- 100: Parameta batili, kama kitambulisho kibaya cha mpokeaji; subcode 2018001 inasema hakuna mtumiaji anayelingana aliyepatikana.
- 551: mtu hapatikani, labda ameizuia Ukurasa au amezima akaunti yake; 200 yenye 1545041 inasema mtu huyu hapatikani kwa sasa.
- 200 yenye 2018028: programu haiwezi kutuma ujumbe kwa watu nje ya majukumu yake hadi
pages_messagingikaguliwe na programu iwe hai. - 10904: Ukurasa umezima ujumbe kwenye mipangilio.
easyCoexistence inatuma vipi kupitia hiyo?
send_social_dm inapokea account_id, recipient_id ya mtu, ambayo ni sender.id katika tukio la messages linalosambazwa, na maandishi, kisha inatuma kwenda /{page-id}/messages ikiwa na messaging_type RESPONSE. Matokeo ni jibu la Meta lenye message_id, na utumaji uliokataliwa unarudi na msimbo wa hitilafu wa Meta pamoja na ujumbe wake. Midia, quick_replies, violezo na vitendo vya mtumaji havimo miongoni mwa tools: send_social_dm hutuma maandishi.
Makosa ya kawaida
- Kutuma kiashiria cha kuandika pamoja na ujumbe. Meta inataka sender_action peke yake pamoja na mpokeaji, na maandishi au violezo kwenye ombi tofauti.
- Kutuma mfululizo wa ujumbe kwa mtu mmoja. Meta inaweza kupunguza kasi ya mazungumzo moja peke yake, mbali na maombi 300 kwa sekunde za Ukurasa.
- Kutuma sauti au video kwa kasi ya maandishi. Ujumbe wenye sauti au video umewekewa maombi 10 kwa sekunde kwa kila Ukurasa.
- Kutumia tena attachment_id iliyo zaidi ya siku 90. attachment_id zilizohifadhiwa huisha muda, kwa hiyo pakia midia tena upate mpya.
Automations hujibu ujumbe mpya zenyewe kwa maandishi yasiyobadilika au jibu la AI. Kuanzia US$ 9 hadi US$ 0.75 kwa muunganisho kwa mwezi, bei inashuka unavyoongeza muunganisho, na siku 3 za kwanza ni za majaribio bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, Messenger Send API ni bure?
Ndiyo, kwa ujumbe wa kawaida. Muhtasari wa Meta unaeleza Messenger Platform kuwa bure kutumia, kwa hiyo Ukurasa unaojibu watu walioandika kwake hailipi chochote kwa kila ujumbe; ujumbe wa matangazo hutozwa kwa kila ujumbe.
Kutuma ujumbe kunahitaji ruhusa gani ya Ukurasa?
Muhtasari wa Messenger wa Meta unaomba Page token kutoka kwa mtu anayeweza kutekeleza kazi za MESSAGING na MODERATE, ukiwa na ruhusa ya pages_messaging imetolewa.
Je, easyCoexistence inaweza kujibu kwa picha kwenye Messenger?
Si leo. send_social_dm hutuma maandishi, na hakuna tool inayotuma kiambatisho.
easyCoexistence inagharimu kiasi gani kwa Ukurasa wa Facebook?
Kila Ukurasa unaounganisha ni muunganisho mmoja, unaotozwa kuanzia US$ 9 hadi US$ 0.75 kwa muunganisho kwa mwezi kulingana na idadi uliyonayo, na siku 3 za kwanza ni za majaribio bila malipo.
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