Partner API-limieten en -regels: het beleid van Meta, 20 berichten per seconde en de 14-dagenregel
Een Coexistence-nummer dat via de Partner API van easyCoexistence is verbonden, verstuurt maximaal 20 berichten per seconde, een snelheid die Meta vastlegt. Meta koppelt een nummer los waarvan de telefoon ongeveer 14 dagen inactief blijft. Een platform dat de accounts van zijn klanten koppelt, handelt namens hen en houdt daarom de regels van elk netwerk aan: op WhatsApp antwoorden binnen het klantenservicevenster van 24 uur, goedgekeurde templates daarbuiten, geen spam en geen algemene AI-chatbots.
Vaste doorvoer die Meta instelt voor een nummer dat zowel in de WhatsApp Business-app als in de Cloud API wordt gebruikt.
Standaarddoorvoer van de Cloud API voor een nummer dat alleen via de API draait, die automatisch kan stijgen tot 1.000.
Inactiviteit van de telefoon met de WhatsApp Business-app, waarna Meta het nummer loskoppelt; reden PRIMARY_INACTIVITY.
Het klantenservicevenster dat het bericht van een gebruiker opent; daarbuiten mag een bedrijf alleen goedgekeurde templates sturen.
Berichtenlimiet van een nieuw Business Portfolio: aantal bereikte personen buiten het servicevenster per voortschrijdende 24 uur.
Wiens regels houdt een platform aan?
Die van elk netwerk, voor elke klant die het koppelt. De accounts draaien via de officiële API van elk netwerk, en de regels daarvan gelden voor wat je software er via verstuurt en plaatst. Op WhatsApp landt de handhaving van Meta op het WhatsApp Business-account van de klant en op de app waarmee het nummer is verbonden. Daarom beëindigt misbruik van Meta's regels de API-sleutel van een platform.
Welke Meta-regels gelden op WhatsApp?
Meta's berichtenregels, nageleefd door de software die voor het bedrijf verstuurt:
- Vrije tekst alleen binnen 24 uur na het laatste bericht van de persoon; elk nieuw bericht van die persoon start het venster opnieuw.
- Buiten het venster alleen templates die Meta heeft goedgekeurd.
- Berichten alleen naar mensen die toestemming hebben gegeven om van het bedrijf te horen.
- Geen spam, en geen algemene AI-chatbots op het nummer.
- Bereik buiten het venster wordt per Business Portfolio geteld: een nieuw portfolio begint op 250 personen per voortschrijdende 24 uur.
Hoe snel kan een Coexistence-nummer versturen?
Met 20 berichten per seconde, een vaste snelheid die Meta instelt zodat het nummer compatibel blijft met de WhatsApp Business-app. Een nummer alleen op de Cloud API begint op 80 en kan automatisch tot 1.000 worden verhoogd, maar een Coexistence-nummer blijft op 20. De berichtenlimiet van het portfolio geldt daarbovenop en telt de personen die buiten het klantenservicevenster zijn bereikt.
Wat is de 14-dagenregel?
Meta koppelt een Coexistence-nummer los wanneer de telefoon met de WhatsApp Business-app ongeveer 14 dagen inactief is geweest, met de reden PRIMARY_INACTIVITY. easyCoexistence bewaakt elk nummer en stuurt je events-URL de melding connection.disconnected met die reden. De oplossing is een nieuwe koppelingslink voor die klant: die doorloopt de stroom opnieuw met hetzelfde nummer, en het keert terug.
Welke andere ontkoppelingen meldt Meta?
Wanneer Meta de verbinding van een nummer beëindigt, bevat connection.disconnected de redencode van Meta als die bekend is. Naast PRIMARY_INACTIVITY somt Meta deze op:
ACCOUNT_DISCONNECTED: handhaving door Meta, of de klant heeft zijn WhatsApp-account verwijderd; gestart door de gebruiker of door het systeem.CHANGE_NUMBER: de klant heeft het telefoonnummer gewijzigd.BUSINESS_DOWNGRADE: het nummer was geregistreerd in de consumenten-WhatsApp-app.USER_RE_REGISTERED: de klant heeft WhatsApp opnieuw geregistreerd op een nieuw apparaat.COMPANION_INACTIVITY: een gekoppeld apparaat is ongeveer 30 dagen niet gebruikt.
Wat beëindigt een Partner API-sleutel?
Drie dingen. Je roteert hem, waarmee hij direct door een nieuwe sleutel wordt vervangen; je trekt hem in, waardoor het account er geen meer heeft; of easyCoexistence beëindigt hem omdat het account Meta's regels heeft misbruikt. Een sleutel heeft geen eigen vervaldatum, en eenmaal beëindigd geeft hij bij elk verzoek 401 unauthorized.
Welke limieten gelden voor koppelsessies?
Een account kan tegelijk 50 open koppelsessies hebben en er per uur 100 aanmaken. Meta telt elke eerste onboarding mee in een limiet voor de hele app, die alle accounts van easyCoexistence delen, dus de plafonds voorkomen dat de bulkimport van één platform die voor iedereen opmaakt. Een plafond antwoordt met 429 cap_reached of rate_limited.
Welke regels stellen de sociale netwerken?
Die van elk netwerk, toegepast op de accounts die je klanten koppelen. Ze verschillen op een paar vaste punten:
- Berichtvensters: Instagram- en Facebook-DM's kunnen binnen een standaardvenster worden beantwoord, meestal 24 uur na het laatste bericht van de persoon.
- Plaatsingsplafonds en API-quota per account, die per netwerk verschillen.
- Levensduur van tokens: sommige netwerken geven tokens uit die één uur of één dag geldig zijn, en die easyCoexistence vernieuwt.
- Toestemming: de accounthouder kan de toegang op elk moment intrekken in de instellingen van het netwerk; dat komt aan als channel.disconnected.
- Functies: TikTok, YouTube en LinkedIn bieden hier geen DM's, en easyCoexistence ontvangt geen commentaar-events van YouTube of LinkedIn.
Veelgemaakte fouten
- Vanaf één Coexistence-nummer in stoten versturen. Meta houdt het op 20 berichten per seconde, dus zet de verzendingen van elk nummer in een wachtrij met die snelheid in plaats van ze allemaal tegelijk te sturen.
- Rekenen op de WhatsApp Business-app om templates te versturen. Bij Coexistence verstuurt alleen de API ze, dus alles buiten het venster van 24 uur moet via je backend lopen.
- Een toegangstoken van een sociaal netwerk voor later opslaan. Sommige zijn één uur of één dag geldig, dus haal de inloggegevens telkens vers op bij easyCoexistence wanneer een taak start.
easyCoexistence houdt de WhatsApp-nummers van je klanten en hun Instagram-, Facebook-, TikTok-, YouTube- en LinkedIn-accounts bij, en meer kanalen, verbonden via de officiële API van elk netwerk. Wanneer er één wegvalt, meldt het dat aan je platform met een ondertekend event, met de reden als die bekend is. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.
Veelgestelde vragen
Wat betekent COMPANION_INACTIVITY?
Een gekoppeld apparaat is ongeveer 30 dagen niet gebruikt, een van de redenen die Meta geeft om een nummer los te koppelen.
Wat gebeurt er met mijn klanten als mijn platform Meta's regels breekt?
De handhaving van Meta landt op hun WhatsApp Business-accounts en op de app waarmee hun nummers zijn verbonden, en easyCoexistence beëindigt de API-sleutel van een account dat de regels misbruikt.
Geldt de 14-dagenregel ook voor sociale accounts?
Nee. Het is Meta's regel voor nummers die worden gedeeld tussen de WhatsApp Business-app en de API. Een sociaal account valt weg wanneer het netwerk zijn token weigert of de eigenaar de toegang intrekt; dat komt aan als channel.disconnected.
Verschillen de limieten per netwerk?
Ja. Elk netwerk stelt eigen berichtvensters, plaatsingsplafonds, API-quota en tokenlevensduur vast, en ze gelden voor de accounts die je koppelt, net zoals ze voor je eigen accounts zouden gelden.
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