Messenger Send API: viestien lähettäminen Facebook-sivulta
Facebook-sivu lähettää Messenger-viestejä POST /{page-id}/messages -pyynnöllä ja sivun käyttöoikeustunnuksella: vastaanottaja on henkilön sivukohtainen tunnus (PSID), messaging_type on RESPONSE tai UPDATE standardin viestiikkunan sisällä tai MESSAGE_TAG sen jälkeen, ja message sisältää tekstin tai liitteen, kuten kuvan, äänen, videon tai tiedoston. Meta vastaa recipient_id:llä ja message_id:llä.
easyCoexistence vastaa Messenger-yksityisviesteihin send_social_dm-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi 24 tunnin ikkunan sisällä, tekstinä; mediat, pikavastaukset ja viestipohjat eivät kuulu mukaan.
Send API -kutsut, joita sovellus voi tehdä sivua kohden viesteille, joissa on teksti, linkit, reaktiot ja tarrat.
Send API -kutsut, joita sovellus voi tehdä sivua kohden viesteille, joissa on ääntä tai videota.
Suurin Messenger-alustan uudelleenkäyttöön tallentama tiedosto; URL-osoitteesta ladattu kuva on rajattu 8 MB:iin.
Suurin määrä kuvia, jotka yksi viesti voi sisältää attachments-taulukossa, ainoa sallittu mediatyyppi siellä.
Kuinka kauan tallennettu attachment_id on voimassa, ennen kuin media on ladattava uudelleen.
Mitä Send API -pyyntö sisältää?
Meta luettelee kuusi osaa, jotka lähetyksen on sisällettävä: lähettävän sivun tunnus, vastaanottajan tunnus, sivun käyttöoikeustunnus kyseiseltä sivulta, henkilön lupa, viestityyppi ja sisältö. Pyyntö on JSON-sisältöinen POST osoitteeseen /{page-id}/messages, ja henkilölle, joka kirjoitti juuri, vastaava pyyntö näyttää tältä:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }Mikä tunnus menee kohtaan recipient?
Yleensä sivukohtainen tunnus eli PSID, jonka Meta antaa henkilölle ensimmäisen kerran, kun hän kirjoittaa sivulle. Se saapuu messages-webhookissa kenttänä sender.id. Objekti recipient hyväksyy myös muita tunnuksia tiettyihin tilanteisiin:
- id: PSID, joka on yksilöllinen kyseiselle henkilölle ja kyseiselle sivulle.
user_ref: henkilölle, joka lähetti viestin sivulle laajennuksen tai postback-painikkeen kautta.comment_idtaipost_id: yksityiseen vastaukseen kommenttiin tai vierailijan julkaisuun.- Facebook Loginin tunnukset ovat sovelluskohtaisia eivätkä toimi Messenger-alustalla.
Mitä messaging_type-arvoa viestin pitäisi käyttää?
Tyyppi kertoo Metalle, miksi viesti lähetetään, ja se määrää, milloin lähetys on sallittua. Metan sivuviestien viiteasiakirja luettelee neljä arvoa:
- RESPONSE: vastaus sivun vastaanottamaan viestiin, mainonnallinen tai ei, standardin viestiikkunan sisällä.
- UPDATE: sivun omasta aloitteesta lähettämä viesti, mainonnallinen tai ei, myös ikkunan sisällä.
MESSAGE_TAG: ei-mainonnallinen viesti ikkunan jälkeen, merkinnällä, joka vastaa hyväksyttyä käyttötapausta.- UTILITY: hyväksytystä viestipohjasta rakennettu palveluviesti, kuten tilaus- tai ajanvarauspäivitys.
Mitä viesti voi sisältää?
Teksti tai yksi liitemääritys, jossa on tyyppi ja sisältö: kuva-, ääni-, video- ja tiedostoliitteet osoittavat URL-osoitteeseen tai tallennettuun attachment_id:hen, ja viestipohjaliitteet kuljettavat jäsennellyistä viesteistä, joissa on painikkeita. Sama päätepiste hyväksyy myös nämä:
- attachments: enintään 30 kuvaa sisältävä taulukko, joka lähetetään yhtenä viestinä.
reply_toja mid: vastaus tiettyyn aiempaan viestiin, joko henkilön tai sivun viestiin.quick_replies: enintään 13 painiketta kirjoituskentän yläpuolella, kukin enintään 20 merkin otsikolla.sender_action: kirjoitusilmaisin, luettu-merkintä tai reaktio, lähetettynä erillisessä pyynnössä itse viestistä.notification_type: oletuksena REGULAR, taiSILENT_PUSHtaiNO_PUSH.
Kuinka suuria liitteet voivat olla?
Metan opas tallennettavista resursseista asettaa rajat median osalta, jonka Messenger-alusta hakee ja säilyttää: resurssit enintään 25 MB, URL-osoitteesta ladatut kuvat enintään 8 MB, ääni lähetettynä audio-Content-Type-tyypillä ja video haettuna 75 sekunnin kuluessa. Kun is_reusable asetetaan arvoon true, saadaan attachment_id, jonka vain sitä lähettänyt sivu voi käyttää uudelleen 90 päivän ajan, ja POST /{page-id}/message_attachments lataa median etukäteen.
Mitkä ovat Send API:n nopeusrajat?
Meta laskee ne sivukohtaisesti ja sisällön mukaan. Metan sivuviestien viiteasiakirjan lähetysvirheiden joukossa on koodi 613, Calls to this api have exceeded the rate limit, joka ilmetessään tarkoittaa hidastamista eikä heti uudelleen yrittämistä:
- 300 kutsua sekunnissa sivua kohden viesteille, joissa on teksti, linkit, reaktiot ja tarrat.
- 10 kutsua sekunnissa sivua kohden viesteille, joissa on ääntä tai videota.
- Liian monet viestit yhteen keskusteluun voivat saada rajoituksen jo itsessään.
- Messenger API -kutsut yhteensä: 200 kertaa sitoutuneiden käyttäjien määrä liukuvana 24 tunnin jaksona.
- Yli 40 viestiä sekunnissa: sivun postilaatikko lakkaa näyttämästä uusia viestejä, eikä sivu voi lähettää ennen kuin määrä laskee.
Mitä virheitä Send API palauttaa?
Metan Messenger-virhetaulukko yhdistää jokaisen koodin alikoodiin, joka nimeää syyn. Nämä ovat ne, joita sivu kohtaa useimmin lähettäessään:
- 10 alikoodilla 2018278 tai 2534022: This message is sent outside of allowed window.
- 10 alikoodilla 2018300: toinen sovellus hallitsee keskustelua.
- 100: virheellinen parametri, esimerkiksi väärä vastaanottajan tunnus; alikoodi 2018001 kertoo: No matching user found.
- 551: henkilö ei ole tavoitettavissa, ehkä koska hän on estänyt sivun tai poistanut tilinsä; 200 alikoodilla 1545041: This person isn't available right now.
- 200 alikoodilla 2018028: sovellus ei voi lähettää viestejä ihmisille roolien ulkopuolella ennen kuin
pages_messagingon tarkistettu ja sovellus on julkaistu. - 10904: The page has messages disabled in the settings.
Miten easyCoexistence lähettää sen kautta?
send_social_dm ottaa account_id:n, henkilön recipient_id:n, joka on sender.id välitetyssä messages-tapahtumassa, ja tekstin, ja lähettää ne osoitteeseen /{page-id}/messages messaging_type-arvolla RESPONSE. Tuloksena on Metan vastaus message_id:llä, ja hylätty lähetys palautuu Metan virhekoodilla ja viestillä. Media, pikavastaukset, viestipohjat ja lähettäjätoiminnot eivät kuulu työkaluihin: send_social_dm lähettää tekstiä.
Yleiset virheet
- Kirjoitusilmaisimen lähettäminen viestin mukana. Meta haluaa sender_actionin yksin vastaanottajan kanssa, ja teksti tai viestipohjat erillisessä pyynnössä.
- Purskeen lähettäminen yhdelle henkilölle. Meta voi rajoittaa yhtä keskustelua jo itsessään, sivun 300 kutsun sekuntinopeuden lisäksi.
- Äänen tai videon lähettäminen tekstin nopeudella. Ääntä tai videota sisältävät viestit ovat rajoitettu 10 kutsuun sekunnissa sivua kohden.
- Yli 90 päivää vanhan attachment_id:n uudelleenkäyttö. Tallennetut attachment_id:t vanhenevat, joten lataa media uudelleen uuden saamiseksi.
Automaatiot vastaavat uusiin viesteihin itsenäisesti kiinteällä tekstillä tai tekoälyvastauksella. US$ 9–US$ 0.75 per yhteys kuukaudessa, joka laskee yhteyksiä lisätessä, ensimmäiset 3 päivää ilmaiseksi.
Usein kysytyt kysymykset
Onko Messenger Send API ilmainen?
Kyllä, tavallisille viesteille. Metan yleiskatsauksen mukaan Messenger-alusta on ilmainen käyttää, joten Facebook-sivu, joka vastaa ihmisille, jotka kirjoittivat sille, ei maksa viestikohtaisesti mitään; markkinointiviestit laskutetaan viestikohtaisesti.
Mitä sivutehtävää viestin lähettäminen vaatii?
Metan Messenger-yleiskatsaus vaatii Facebook-sivun käyttöoikeustunnuksen henkilöltä, jolla on oikeus suorittaa MESSAGING- ja MODERATE-tehtävät, ja pages_messaging-oikeus myönnettynä.
Voiko easyCoexistence vastata kuvilla Messengerissä?
Ei tänään. send_social_dm lähettää tekstiä, eikä mikään työkalu lähetä liitettä.
Mitä easyCoexistence maksaa Facebook-sivulle?
Jokainen yhdistämäsi sivu on yksi yhteys, ja se maksaa US$ 9–US$ 0.75 yhteydeltä kuukaudessa riippuen siitä, kuinka monta sinulla on. Ensimmäiset 3 päivää ovat ilmaisia.
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