Probleemoplossing en veelgestelde vragen

Bericht geaccepteerd maar niet bezorgd

Een 200-response van de endpoint voor uitgaande berichten betekent dat ElevenLabs de request heeft geaccepteerd en doorgestuurd — Meta is nog steeds verantwoordelijk voor de bezorging. Als het bericht nooit aankomt, controleer dan achtereenvolgens:

1. Templates goedkeuren — de template moet de status Approved hebben in WhatsApp Manager. Templates die in behandeling zijn of zijn afgewezen, worden niet bezorgd.
2. Betalingen — een ontbrekende betaalmethode of openstaande betalingen op je WhatsApp-bedrijfsaccount blokkeren de bezorging van templates (Meta-fout 131042). Voeg de betaalmethode toe of werk deze bij in WhatsApp Manager.
3. Parameterstructuur — vermeldingen in template_params moeten componentobjecten zijn ({"type": "body", "parameters": [...]}), elke placeholder in de template moet zijn ingevuld en benoemde templates hebben voor elke waarde een parameter_name nodig. Zie templateparameters.
4. Indeling van ontvanger — whatsapp_user_id bevat alleen cijfers met landcode, zonder +. Zie indeling van ontvangernummer.
5. Marketinglimieten — Meta beperkt het aantal marketingtemplates dat één gebruiker binnen een periode kan ontvangen (fout 131049). Utility-templates vallen niet onder deze limiet.

Problemen met importeren

• Het nummer kan niet worden geïmporteerd — het is geregistreerd bij een andere WhatsApp-provider of actief in de WhatsApp Business-app. Een nummer kan maar bij één provider worden geregistreerd; zie Beperkingen.
• Je WABA verschijnt niet in de importflow — controleer of je bent ingelogd op een Facebook-account met beheerderstoegang tot het bedrijfsportfolio dat eigenaar is van de WABA, en probeer de import daarna opnieuw.
• WABA’s die zijn gemaakt onder een Meta developer-app kunnen niet via de standaardflow worden geïmporteerd.

Controleren of een andere partner het nummer beheert

Een nummer dat niet in aanmerking lijkt te komen, ontbreekt in de importflow of een fout geeft bij het importeren, is vaak nog geregistreerd bij een vorige provider. Een partner die controle heeft over het nummer verklaart zowel een mislukte import als een ontbrekende WABA.

1. Ga naar business.facebook.com en selecteer het bedrijfsportfolio.
2. Open Bedrijfsinstellingen > WhatsApp-accounts.
3. Controleer Telefoonnummers bij elk WhatsApp-account tot je het account vindt dat je nummer bevat.
4. Open Partners.
5. Koppel het nummer los van die partner (of verwijder het volledige bedrijfsportfolio) en probeer de import enkele minuten later opnieuw.

De agent reageert niet op inkomende berichten

Het leesbewijs en de typindicator helpen de oorzaak te bepalen: ze worden verstuurd zodra een bericht is geaccepteerd voor verwerking, voordat de agent een antwoord produceert. Stuur met Typindicator inschakelen aan (de standaardinstelling) een testbericht en controleer of je bericht als gelezen wordt gemarkeerd en de typindicator verschijnt.

De typindicator verschijnt, maar er komt geen antwoord. Het bericht heeft ElevenLabs bereikt en de agent is begonnen met werken; de fout treedt op tijdens het produceren of bezorgen van het antwoord:

• De agent vereist een dynamische variabele zonder waarde. Inkomende WhatsApp-gesprekken beginnen zonder dynamische variabelen die door de gebruiker zijn opgegeven — alleen de systeemvariabelen zijn ingevuld. De oplossing is een webhook voor gespreksinitiatie die elke vereiste variabele voor de agent retourneert; zie initialisatiecontext. De waarden onder Dynamische variabelen in de agenteditor zijn placeholders voor tests en worden niet gebruikt in productie.
• Meta heeft het antwoord van de agent afgewezen — bijvoorbeeld vanwege een rate limit voor dit bedrijfs-gebruikerspaar of een betalingsprobleem op accountniveau. Zie hieronder de foutreferentie.

Het gesprek mislukt als deze vereiste dynamische variabelen ontbreken.

Er verschijnt geen typindicator. Het bericht is verwijderd voordat het de agent bereikte:

• Er is geen agent aan het nummer toegewezen of de schakelaar Berichten inschakelen staat uit — controleer de accountinstellingen op de WhatsApp-pagina.
• De autorisatie van het account is niet langer geldig — het toegangstoken is verlopen of door Meta ingetrokken. Importeer het account opnieuw op de WhatsApp-pagina.
• De agentworkspace staat in Zero-Retention Mode, waardoor inkomende WhatsApp-berichten volledig worden genegeerd.
• Het inkomende bericht heeft een niet-ondersteund type (bijvoorbeeld video of een antwoord op een WhatsApp Flow) — zie Beperkingen.

Het eerste antwoord na een template werkt niet goed

Als je agent de override Eerste bericht heeft ingeschakeld op het tabblad Beveiliging, kan dit conflicteren met gesprekken via uitgaande templates — de template diende al als eerste bericht. Als antwoorden op templates zich onverwacht gedragen, verwijder dan de override voor het eerste bericht voor agents die worden gebruikt met uitgaande WhatsApp-berichten.

Meta-foutreferentie

Fouten die Meta tijdens de bezorging retourneert, worden waar mogelijk weergegeven met advies voor herstel. De meest voorkomende:

Zie voor de volledige lijst de foutcodereferentie van Meta.

Veelgestelde vragen