Messenger Send API: berichten sturen vanaf een Facebook-pagina
Een Facebook-pagina stuurt Messenger-berichten met POST /{page-id}/messages en een Page-toegangstoken. Het veld recipient bevat de Page-scoped ID (PSID) van de persoon. messaging_type is RESPONSE of UPDATE binnen het standaard berichtvenster, of MESSAGE_TAG daarna. Het veld message bevat tekst of een bijlage, zoals een afbeelding, audio, video of bestand. Meta antwoordt met de recipient_id en een message_id.
easyCoexistence beantwoordt DM's op Messenger met send_social_dm vanuit Claude, ChatGPT of je eigen code, binnen het venster van 24 uur, als tekst; media, quick replies en templates vallen er niet onder.
Send API-aanroepen die een app per pagina mag doen voor berichten met tekst, links, reacties en stickers.
Send API-aanroepen die een app per pagina mag doen voor berichten met audio of video.
Grootste bestand dat het Messenger Platform opslaat voor hergebruik; een afbeelding die vanaf een URL wordt geüpload, is beperkt tot 8 MB.
Meeste afbeeldingen die één bericht in zijn attachments-array kan bevatten, het enige mediatype dat daar is toegestaan.
Hoe lang een opgeslagen attachment_id geldig blijft voordat de media opnieuw moet worden geüpload.
Wat bevat een Send API-verzoek?
Meta noemt zes onderdelen die een verzending moet bevatten: het ID van de verzendende pagina, het ID van de ontvanger, een Page-toegangstoken van die pagina, toestemming van de persoon, het berichttype en de inhoud. Het verzoek is een POST van JSON naar /{page-id}/messages. Een antwoord op iemand die net een bericht heeft gestuurd, ziet er zo uit:
POST /{page-id}/messages
{
"recipient": { "id": "<PSID>" },
"messaging_type": "RESPONSE",
"message": { "text": "Your order ships tomorrow." }
}
{ "recipient_id": "<PSID>", "message_id": "<MESSAGE_ID>" }Welk ID hoort in recipient?
Meestal de Page-scoped ID, of PSID, die Meta een persoon toekent de eerste keer dat die de pagina een bericht stuurt. Het komt binnen als sender.id in de messages-webhook. Het recipient-object accepteert andere soorten ID voor bijzondere gevallen:
- id: de PSID, uniek voor die persoon en die pagina.
user_ref: voor iemand die een plugin of een postbackknop gebruikte om de pagina een bericht te sturen.comment_idofpost_id: voor een privé-antwoord op een reactie of op een bezoekerspost.- IDs uit Facebook Login zijn app-gebonden en werken niet op het Messenger Platform.
Welk messaging_type moet een bericht gebruiken?
Het type vertelt Meta waarom het bericht wordt verstuurd, en bepaalt wanneer de verzending is toegestaan. De referentie voor Page-berichten van Meta noemt vier waarden:
- RESPONSE: een antwoord op een bericht dat de pagina ontving, promotioneel of niet, binnen het standaard berichtvenster.
- UPDATE: een bericht dat de pagina uit eigen beweging stuurt, promotioneel of niet, ook binnen het venster.
MESSAGE_TAG: een niet-promotioneel bericht na het venster, met een tag die past bij een goedgekeurd gebruik.- UTILITY: een utility-bericht op basis van een goedgekeurd template, zoals een update over een bestelling of afspraak.
Wat kan een bericht bevatten?
Tekst, of één bijlageobject met een type en een payload: afbeeldings-, audio-, video- en bestandsbijlagen verwijzen naar een URL of een opgeslagen attachment_id, en template-bijlagen bevatten gestructureerde berichten met knoppen. Hetzelfde endpoint accepteert ook deze velden:
- attachments: een array van maximaal 30 afbeeldingen die als één bericht worden verstuurd.
reply_tomet een mid: een antwoord op een specifiek eerder bericht, van de persoon of van de pagina.quick_replies: maximaal 13 knoppen boven het invoerveld, elk met een titel van maximaal 20 tekens.sender_action: een typindicator, een gelezen-markering of een reactie, verstuurd in een apart verzoek los van het bericht zelf.notification_type: standaard REGULAR, ofSILENT_PUSHofNO_PUSH.
Hoe groot mogen bijlagen zijn?
De gids van Meta voor het opslaan van assets stelt de limieten vast voor media die het Messenger Platform ophaalt en bewaart: assets tot 25 MB, afbeeldingen tot 8 MB wanneer ze vanaf een URL worden geüpload, audio die met een audio-Content-Type wordt verstuurd, en video die binnen 75 seconden wordt opgehaald. Als is_reusable op true staat, geeft dat een attachment_id terug dat alleen de pagina die het verstuurde opnieuw kan gebruiken, gedurende 90 dagen. Met POST /{page-id}/message_attachments upload je media vooraf.
Wat zijn de limieten van de Send API?
Meta telt ze per pagina en per soort inhoud. De referentie voor Page-berichten van Meta noemt 613, Aanroepen naar deze api hebben de limiet overschreden, als een van de verzendfouten. Vertraag dan in plaats van meteen opnieuw te proberen wanneer die verschijnt:
- 300 aanroepen per seconde per pagina voor berichten met tekst, links, reacties en stickers.
- 10 aanroepen per seconde per pagina voor berichten met audio of video.
- Te veel berichten naar één gesprek kan op zichzelf worden beperkt.
- Messenger API-aanroepen in totaal: 200 keer het aantal betrokken gebruikers, binnen een voortschrijdende periode van 24 uur.
- Boven 40 berichten per seconde stopt de Page-inbox met het tonen van nieuwe berichten en kan de pagina niet verzenden totdat het volume daalt.
Welke fouten geeft de Send API terug?
De foutentabel van Messenger van Meta koppelt elke code aan een subcode die de oorzaak aangeeft. Dit zijn de fouten die een pagina bij het verzenden het vaakst tegenkomt:
- 10 met 2018278 of 2534022: Dit bericht is buiten het toegestane venster verstuurd.
- 10 met 2018300: een andere app beheert het gesprek.
- 100: Ongeldige parameter, zoals een verkeerd ontvanger-ID; subcode 2018001 luidt: Geen overeenkomende gebruiker gevonden.
- 551: de persoon is niet beschikbaar, misschien omdat die de pagina heeft geblokkeerd of het account heeft gedeactiveerd; 200 met 1545041 luidt: Deze persoon is op dit moment niet beschikbaar.
- 200 met 2018028: de app kan geen mensen buiten haar rollen berichten sturen totdat
pages_messagingis beoordeeld en de app live is. - 10904: De pagina heeft berichten uitgeschakeld in de instellingen.
Hoe verstuurt easyCoexistence via de Send API?
send_social_dm neemt het account_id, de recipient_id van de persoon (dat is sender.id in een doorgestuurde messages-gebeurtenis) en de tekst, en stuurt ze naar /{page-id}/messages met messaging_type RESPONSE. Het resultaat is het antwoord van Meta met de message_id; een geweigerde verzending komt terug met de foutcode en het foutbericht van Meta. Media, quick replies, templates en sender actions zitten niet bij de tools: send_social_dm verstuurt tekst.
Veelgemaakte fouten
- Een typindicator meesturen met het bericht. Meta wil sender_action alleen met de ontvanger, en tekst of templates in een apart verzoek.
- Een salvo op één persoon afvuren. Meta kan één gesprek op zichzelf beperken, los van de 300 aanroepen per seconde van de pagina.
- Audio of video met het tekstritme versturen. Berichten met audio of video zijn gebonden aan 10 aanroepen per seconde per pagina.
- Een attachment_id ouder dan 90 dagen hergebruiken. Opgeslagen attachment_id's verlopen, dus upload de media opnieuw voor een nieuwe.
Automatiseringen antwoorden zelf op nieuwe berichten met een vaste tekst of een AI-antwoord. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Is de Messenger Send API gratis?
Ja, voor standaardberichten. De overzichtspagina van Meta noemt het Messenger Platform gratis te gebruiken, dus een pagina die mensen antwoordt die haar een bericht stuurden, betaalt niets per bericht; marketingberichten worden per bericht in rekening gebracht.
Welke taak op de pagina is nodig om een bericht te versturen?
De Messenger-overzichtspagina van Meta vraagt om een Page-token van iemand die de taken MESSAGING en MODERATE kan uitvoeren, met het recht pages_messaging toegekend.
Kan easyCoexistence met afbeeldingen antwoorden op Messenger?
Vandaag niet. send_social_dm verstuurt tekst, en geen enkele tool verstuurt een bijlage.
Wat kost easyCoexistence voor een Facebook-pagina?
Elke pagina die je verbindt is één verbinding, die US$ 9 tot US$ 0,75 per verbinding per maand kost, afhankelijk van hoeveel je er hebt. De eerste 3 dagen zijn gratis.
Lees verder
Koppel je eerste kanaal in twee minuten.
Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.
- 3 dagen gratis
- Op elk moment opzegbaar
- Alleen officiële API's
- 24/7 bewaakt
Geverifieerd op