Messenger Send API: slanje poruka s Facebook stranice
Facebook stranica šalje Messenger poruke putem POST /{page-id}/messages i tokena pristupa za stranicu. Polje recipient sadrži ID osobe vezan uz stranicu (PSID), messaging_type je RESPONSE ili UPDATE unutar standardnog prozora za razmjenu poruka, odnosno MESSAGE_TAG nakon njega, a polje message sadrži tekst ili privitak, poput slike, zvuka, videa ili datoteke. Meta odgovara s recipient_id i message_id.
easyCoexistence odgovara na izravne poruke (DM) u Messengeru pomoću send_social_dm iz Claudea, ChatGPT-ja ili vašeg koda unutar 24-satnog prozora, kao tekst; mediji, brzi odgovori i predlošci nisu obuhvaćeni.
Broj poziva Send API-ju koje aplikacija može uputiti po stranici za poruke s tekstom, poveznicama, reakcijama i naljepnicama.
Broj poziva Send API-ju koje aplikacija može uputiti po stranici za poruke koje sadrže zvuk ili video.
Najveći sadržaj koji Messenger Platform sprema za ponovnu uporabu; slika učitana s URL-a ograničena je na 8 MB.
Najviše slika koje jedna poruka može sadržavati u polju attachments, jedina vrsta medija koja je tamo dopuštena.
Koliko dugo vrijedi spremljeni attachment_id prije nego što se medij mora ponovno učitati.
Što sadrži zahtjev Send API-ja?
Meta navodi šest komponenti koje slanje mora sadržavati: ID stranice koja šalje, ID osobe koja prima, token pristupa te stranice, dopuštenje osobe, vrstu poruke i sadržaj. Zahtjev je POST u JSON formatu na /{page-id}/messages, a odgovor nekome tko je upravo napisao izgleda ovako:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }Koji ID ide u recipient?
Obično PSID, odnosno ID vezan uz stranicu, koji Meta dodjeljuje osobi pri prvoj poruci stranici; u webhooku poruka stiže kao sender.id. Objekt recipient prihvaća i druge vrste ID-a za posebne slučajeve:
- id: PSID, jedinstven za tu osobu i tu stranicu.
user_ref: za osobu koja je stranici poslala poruku preko dodatka ili postback gumba.comment_idilipost_id: za privatni odgovor na komentar ili objavu posjetitelja.- ID-jevi iz Facebook Logina vezani su uz aplikaciju i ne vrijede za Messenger Platform.
Koji messaging_type treba koristiti za poruku?
Tip govori Meti zašto se poruka šalje i određuje kada je slanje dopušteno. Meta u referenci za poruke stranice navodi četiri vrijednosti:
- RESPONSE: odgovor na poruku koju je stranica primila, promotivnu ili ne, unutar standardnog prozora za razmjenu poruka.
- UPDATE: poruka koju stranica šalje samoinicijativno, promotivna ili ne, također unutar prozora.
MESSAGE_TAG: nepromotivna poruka poslana nakon prozora, s oznakom koja odgovara odobrenom slučaju uporabe.- UTILITY: uslužna poruka izrađena od odobrenog predloška, poput obavijesti o narudžbi ili terminu.
Što poruka može sadržavati?
Tekst ili jedan objekt privitka s vrstom i payloadom: privici slike, zvuka, videa i datoteke upućuju na URL ili spremljeni attachment_id, a privici tipa predložak nose strukturirane poruke s gumbima. Isti endpoint prima i ove parametre:
- attachments: polje s do 30 slika poslanih kao jedna poruka.
reply_tos mid: odgovor na određenu prethodnu poruku, osobe ili stranice.quick_replies: do 13 gumba iznad polja za unos, svaki naslov do 20 znakova.sender_action: indikator tipkanja, oznaka pročitano ili reakcija, poslan u zasebnom zahtjevu, odvojeno od same poruke.notification_type: REGULAR je zadano, a moguće su iSILENT_PUSHiliNO_PUSH.
Koliko veliki mogu biti privici?
Metin vodič za spremanje sadržaja postavlja ograničenja za medije koje Messenger Platform preuzima i čuva: sadržaj do 25 MB, slike do 8 MB kada se učitavaju s URL-a, zvuk poslan s audio Content-Type, a video preuzet unutar 75 sekundi. Postavljanje is_reusable na true vraća attachment_id koji može ponovno koristiti samo stranica koja ga je poslala, 90 dana, a POST /{page-id}/message_attachments učitava medije unaprijed.
Koja su ograničenja učestalosti Send API-ja?
Meta ih broji po stranici i prema sadržaju. U Metinoj referenci za poruke stranice navodi se 613, „Calls to this api have exceeded the rate limit“, među pogreškama slanja, pa kada se pojavi, usporite, a ne odmah ponavljajte pokušaj:
- 300 poziva u sekundi po stranici za poruke s tekstom, poveznicama, reakcijama i naljepnicama.
- 10 poziva u sekundi po stranici za poruke sa zvukom ili videom.
- Previše poruka u jednoj niti može samo po sebi biti ograničeno brzinom.
- Ukupni pozivi Messenger API-ju: 200 puta broj angažiranih korisnika, u kliznih 24 sata.
- Iznad 40 poruka u sekundi ulazni sandučić stranice prestaje prikazivati nove poruke, a stranica ne može slati dok se obujam ne smanji.
Koje pogreške vraća Send API?
Metina tablica pogrešaka za Messenger uparuje svaki kôd s podkôdom koji navodi uzrok. Ovo su pogreške koje stranica najčešće dobiva pri slanju:
- 10 s 2018278 ili 2534022: Ova poruka poslana je izvan dopuštenog prozora.
- 10 s 2018300: druga aplikacija upravlja razgovorom.
- 100: Neispravan parametar, na primjer pogrešan ID primatelja; podkôd 2018001 glasi „No matching user found“.
- 551: osoba nije dostupna, možda zato što je blokirala stranicu ili deaktivirala račun; 200 s 1545041 glasi „This person isn't available right now“.
- 200 s 2018028: aplikacija ne može slati poruke osobama izvan svojih uloga dok se
pages_messagingne pregleda i aplikacija ne bude objavljena. - 10904: Stranica ima isključene poruke u postavkama.
Kako easyCoexistence šalje preko Send API-ja?
send_social_dm uzima account_id, recipient_id osobe, koji je sender.id u proslijeđenom događaju messages, i tekst te ih šalje na /{page-id}/messages s messaging_type RESPONSE. Rezultat je Metin odgovor s message_id, a odbijeno slanje vraća Metin kôd pogreške i poruku. Mediji, brzi odgovori, predlošci i sender_action nisu među alatima: send_social_dm šalje tekst.
Uobičajene pogreške
- Slanje indikatora tipkanja uz poruku. Meta želi da sender_action bude sam s primateljem, a tekst ili predlošci idu u zasebnom zahtjevu.
- Slanje rafala jednoj osobi. Meta može samostalno ograničiti jednu nit, osim 300 poziva u sekundi za stranicu.
- Slanje zvuka ili videa brzinom za tekst. Poruke sa zvukom ili videom ograničene su na 10 poziva u sekundi po stranici.
- Ponovna uporaba attachment_id-a starijeg od 90 dana. Spremljeni ID-jevi privitaka istječu, pa medij učitajte ponovno za novi.
Automatizacije same odgovaraju na nove poruke fiksnim tekstom ili AI odgovorom. US$ 9 do US$ 0,75 po vezi mjesečno, uz pad kako dodajete veze, a prva 3 dana su besplatna.
Često postavljana pitanja
Je li Messenger Send API besplatan?
Da, za standardne poruke. Metin pregled kaže da je Messenger Platform besplatan za korištenje, pa stranica koja odgovara ljudima koji su joj pisali ne plaća ništa po poruci; marketinške poruke naplaćuju se po poruci.
Koji je zadatak stranice potreban za slanje poruke?
Metin pregled Messengera traži token stranice od nekoga tko može izvršavati zadatke MESSAGING i MODERATE, uz odobreno dopuštenje pages_messaging.
Može li easyCoexistence odgovoriti slikama na Messengeru?
Danas ne. send_social_dm šalje tekst, a nijedan alat ne šalje privitak.
Koliko košta easyCoexistence za Facebook stranicu?
Svaka stranica koju povežete jedna je veza, naplaćena od US$ 9 do US$ 0,75 po vezi mjesečno, ovisno o tome koliko ih imate, a prva 3 dana su besplatna.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na