Messenger Send API: trimiterea mesajelor dintr-o pagină de Facebook
O pagină de Facebook trimite mesaje Messenger prin POST /{page-id}/messages cu un token de acces al paginii: destinatarul are ID-ul limitat la pagină (PSID), messaging_type este RESPONSE sau UPDATE în fereastra standard de mesagerie ori MESSAGE_TAG după aceasta, iar câmpul message conține text sau un atașament, precum o imagine, un audio, un video sau un fișier. Meta răspunde cu recipient_id și message_id.
easyCoexistence răspunde la mesajele directe pe Messenger cu send_social_dm din Claude, ChatGPT sau din propriul cod, în fereastra de 24 de ore, ca text; materialele media, răspunsurile rapide și șabloanele nu sunt acoperite.
Apeluri Send API pe care o aplicație le poate face pentru fiecare pagină, pentru mesaje cu text, linkuri, reacții și stickere.
Apeluri Send API pe care o aplicație le poate face pentru fiecare pagină, pentru mesaje cu audio sau video.
Cel mai mare activ pe care Messenger Platform îl salvează pentru reutilizare; o imagine încărcată dintr-un URL este limitată la 8 MB.
Cele mai multe imagini pe care le poate avea un mesaj în tabloul attachments, singurul tip de media permis acolo.
Cât timp rămâne valabil un attachment_id salvat, înainte ca fișierul media să fie încărcat din nou.
Ce conține o cerere Send API?
Meta enumeră șase componente pe care trebuie să le includă o trimitere: ID-ul paginii care trimite, ID-ul persoanei care primește, un token de acces al paginii, permisiunea persoanei, tipul mesajului și conținutul. Cererea este un POST de JSON către /{page-id}/messages, iar un răspuns către cineva care tocmai a scris arată așa:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }Ce ID se pune în recipient?
De obicei ID-ul limitat la pagină, sau PSID, pe care Meta îl atribuie unei persoane prima dată când scrie paginii; ajunge în webhook-ul de mesaje ca sender.id. Obiectul recipient acceptă și alte tipuri de ID pentru cazuri particulare:
- id: PSID-ul, unic pentru acea persoană și acea pagină.
user_ref: pentru cineva care a folosit un plugin sau un buton postback ca să scrie paginii.comment_idsaupost_id: pentru un răspuns privat la un comentariu sau la o postare a unui vizitator.- ID-urile din Facebook Login sunt limitate la aplicație și nu funcționează pe Messenger Platform.
Ce messaging_type ar trebui să aibă un mesaj?
Tipul îi spune Meta de ce este trimis mesajul și decide când este permisă trimiterea. Documentația de referință Meta pentru mesajele paginii listează patru valori:
- RESPONSE: un răspuns la un mesaj primit de pagină, promoțional sau nu, în fereastra standard de mesagerie.
- UPDATE: un mesaj pe care pagina îl trimite din proprie inițiativă, promoțional sau nu, tot în fereastră.
MESSAGE_TAG: un mesaj nepromoțional trimis după fereastră, cu un tag care corespunde unui caz de utilizare aprobat.- UTILITY: un mesaj utilitar construit dintr-un șablon aprobat, cum ar fi o actualizare a unei comenzi sau a unei programări.
Ce poate conține un mesaj?
Text sau un obiect attachment cu un tip și un payload: atașamentele de imagine, audio, video și fișier indică un URL sau un attachment_id salvat, iar atașamentele de tip șablon transportă mesaje structurate cu butoane. Acest endpoint acceptă și acestea:
- attachments: un tablou de până la 30 de imagini trimise într-un singur mesaj.
reply_tocu un mid: un răspuns la un mesaj anume anterior, al persoanei sau al paginii.quick_replies: până la 13 butoane deasupra câmpului de scriere, fiecare cu un titlu de până la 20 de caractere.sender_action: indicatorul de scriere, marcajul de citit sau o reacție, trimis într-o cerere separată de mesaj.notification_type: REGULAR implicit, sauSILENT_PUSHoriNO_PUSH.
Cât de mari pot fi atașamentele?
Ghidul Meta pentru salvarea activelor stabilește limitele pentru materialele media pe care Messenger Platform le preia și le păstrează: active de până la 25 MB, imagini de până la 8 MB când sunt încărcate dintr-un URL, audio trimis cu un Content-Type audio și video preluat în 75 de secunde. Dacă is_reusable este setat la true, se returnează un attachment_id pe care îl poate reutiliza doar pagina care l-a trimis, timp de 90 de zile, iar POST /{page-id}/message_attachments încarcă materialele media în avans.
Care sunt limitele de rată ale Send API?
Meta le numără pe pagină și după conținut. Documentația de referință pentru mesajele paginii listează 613, Calls to this api have exceeded the rate limit, printre erorile de trimitere, deci încetiniți în loc să reîncercați imediat când apare:
- 300 de apeluri pe secundă pentru fiecare pagină, pentru mesaje cu text, linkuri, reacții și stickere.
- 10 apeluri pe secundă pentru fiecare pagină, pentru mesaje cu audio sau video.
- Prea multe mesaje către un singur fir de conversație pot fi limitate separat.
- Apelurile Messenger API în total: de 200 de ori numărul utilizatorilor implicați, în 24 de ore glisante.
- Peste 40 de mesaje pe secundă, căsuța de intrare a paginii nu mai afișează mesaje noi, iar pagina nu poate trimite până când volumul scade.
Ce erori returnează Send API?
Tabelul de erori Messenger al Meta asociază fiecărui cod un subcod care numește cauza. Acestea sunt cele pe care o pagină le întâlnește cel mai des la trimitere:
- 10 cu 2018278 sau 2534022: Mesajul este trimis în afara ferestrei permise.
- 10 cu 2018300: o altă aplicație controlează conversația.
- 100: Parametru invalid, de exemplu un ID de destinatar greșit; subcodul 2018001 spune No matching user found.
- 551: persoana nu este disponibilă, fiind posibil blocat pagina sau dezactivat contul; 200 cu 1545041 spune This person isn't available right now.
- 200 cu 2018028: aplicația nu poate scrie persoanelor din afara rolurilor sale până când
pages_messagingnu este verificat și aplicația nu este live. - 10904: Pagina are mesajele dezactivate în setări.
Cum trimite easyCoexistence prin ea?
send_social_dm primește account_id, recipient_id al persoanei, care este sender.id dintr-un eveniment de mesaje redirecționat, și textul, apoi le trimite către /{page-id}/messages cu messaging_type RESPONSE. Rezultatul este răspunsul Meta cu message_id, iar o trimitere refuzată revine cu codul de eroare și mesajul de la Meta. Materialele media, răspunsurile rapide, șabloanele și acțiunile expeditorului nu se numără printre tool-uri: send_social_dm trimite text.
Greșeli frecvente
- Trimiterea unui indicator de scriere împreună cu mesajul. Meta vrea sender_action singur, cu destinatarul, iar textul sau șabloanele într-o cerere separată.
- Trimiterea unei rafale către o singură persoană. Meta poate limita un singur fir de conversație separat, pe lângă cele 300 de apeluri pe secundă ale paginii.
- Trimiterea audio sau video cu ritmul textului. Mesajele cu audio sau video sunt limitate la 10 apeluri pe secundă pentru fiecare pagină.
- Refolosirea unui attachment_id mai vechi de 90 de zile. ID-urile atașamentelor salvate expiră, deci încărcați din nou materialul media pentru unul nou.
Automatizările răspund singure la mesajele noi, cu un text fix sau cu un răspuns AI. De la US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Este gratuit Send API de Messenger?
Da, pentru mesajele standard. Prezentarea generală Meta spune că Messenger Platform este gratuită, așa că o pagină care răspunde persoanelor care i-au scris nu plătește nimic pe mesaj; mesajele de marketing se taxează pe mesaj.
Ce sarcină de pagină are nevoie trimiterea unui mesaj?
Prezentarea generală Messenger a Meta cere un token de pagină de la cineva care poate îndeplini sarcinile MESSAGING și MODERATE, cu permisiunea pages_messaging acordată.
Poate easyCoexistence să răspundă cu imagini pe Messenger?
Nu astăzi. send_social_dm trimite text, iar niciun tool nu trimite un atașament.
Cât costă easyCoexistence pentru o pagină de Facebook?
Fiecare pagină conectată este o conexiune, facturată de la US$ 9 până la US$ 0.75 pe conexiune pe lună, în funcție de câte aveți, iar primele 3 zile sunt gratuite.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la