Je workspace beheren
WhatsApp-meldingen
WhatsApp-meldingen brengen de momenten die ertoe doen — een nieuwe lead, een bezoeker die om iemand van het team vraagt, een nieuw gesprek of een widget- fout — rechtstreeks naar de telefoons van je team via WhatsApp, mogelijk gemaakt door Telnyx of Twilio (jij kiest, aanpasbaar in Systeem ). Ze staan naast e-mail en webpush : elke medewerker meldt zich aan met zijn of haar eigen nummer.
Een provider kiezen
De WhatsApp-meldingenkaart onder Instellingen → Systeem → E-mail (alleen voor platformmedewerkers) heeft een keuzemenu voor provider: Telnyx (standaard) of Twilio. Beide sets inloggegevens worden naast elkaar opgeslagen, dus als je wisselt, wordt de instelling van de andere nooit gewist. De actieve provider regelt elke verzending, het indienen van sjablonen en de testknoppen — de rest van de app maakt het niet uit welke je hebt gekozen.
- Telnyx heeft een API-sleutel, een WhatsApp-compatibel afzendernummer en je WABA-ID nodig.
- Twilio heeft de Account SID + Auth Token nodig (Twilio Console → Accountinfo) en je WhatsApp-compatibele Twilio-nummer — of het sandbox-nummer tijdens het testen. Al het andere, inclusief het maken van de bericht-sjablonen en het indienen ervan bij Meta voor beoordeling, gebeurt vanuit dit paneel via de API: je hoeft nooit iets te configureren in de Twilio-console.
Nadat je de inloggegevens hebt opgeslagen, klik je op Verbinding testen — hiermee wordt één geauthenticeerde API-aanroep gedaan en krijg je terug welk account is bereikt (of de exacte foutmelding van de provider), zodat je weet dat de inloggegevens werken voordat je aan de sjablonen begint.
Wat zorgt ervoor dat er een WhatsApp-bericht wordt verstuurd
- Nieuwe lead vastgelegd — naar elke werkruimte-eigenaar/beheerder. Laag volume, hoge waarde.
- Verzoek om doorverwijzing naar een medewerker — naar operators die beschikbaar zijn voor live chat. Tijdgevoelig.
- Nieuw gesprek — het eerste bericht van een nieuw gesprek. Hoog volume — zie de opmerking over de kosten hieronder.
- Widget-/systeemfout — naar super_admins wanneer de Widget Monitor een ernstige fout registreert.
Eenmalige instelling
- Telnyx API-sleutel — Telnyx Portal → Sleutels &
Inloggegevens → API-sleutels. Kopieer de waarde van
KEY…. - Koppel WhatsApp — Telnyx-portaal → Berichten → WhatsApp → Ingebouwde aanmelding. Koppel je Meta Business-account, verifieer het afzendernummer en vul het bedrijfsprofiel + de weergavenaam in (vereist voordat je sjablonen kunt gebruiken).
- Koppel de afzender aan een berichtenprofiel — Telnyx-portaal
→ Messaging Suite → WhatsApp-berichten → Nummers beheren. Wijs
je WhatsApp-afzender toe aan een berichtenprofiel. Dit is nodig
voor het versturen via de API: een afzender die „Verbonden“ is maar niet gekoppeld, wordt
afgewezen met
[10004] Invalid source number. - Sla de inloggegevens op — ga in Blengi naar Instellingen → Systeem → WhatsApp (Telnyx) en plak de API-sleutel, het afzender- nummer (E.164) en de WABA-ID. De sleutel is versleuteld wanneer deze niet in gebruik is; er wordt alleen een "set"-indicator teruggestuurd naar de browser.
- Sjablonen indienen — klik op Sjablonen indienen ter beoordeling in het WhatsApp-gedeelte (geen shell nodig). Hiermee wordt één sjabloon per trigger × het aantal talen dat je medewerkers gebruiken ingediend, waarna die talen worden geregistreerd. Ontwikkelaars kunnen ook het onderstaande commando uitvoeren.
- Sjablonen bekijken — klik op Sjablonen bekijken naast ‘Indienen’ om de exacte inhoud te lezen die wordt ingediend (de tekst + knop van elke trigger, per taal) en de actuele goedkeuringsstatus van Meta (goedgekeurd / in behandeling / afgewezen) zonder de pagina te verlaten. Als de inloggegevens Telnyx niet kunnen bereiken, toont het paneel nog steeds de inhoud van de sjabloon en geeft het aan dat de status 'niet beschikbaar' is.
- Inschakelen — zodra Meta het heeft goedgekeurd (het paneel ‘Sjablonen bekijken ’ toont goedgekeurd ), zet je WhatsApp-verzending inschakelen aan in Systeeminstellingen.
- Operators melden zich aan — elk teamlid voegt zijn nummer toe en schakelt de verzending in via Instellingen › Meldingen. Dit staat standaard uit — niemand wordt automatisch aangemeld.
php artisan pitchbar:whatsapp-templates # discover staff locales + submit
php artisan pitchbar:whatsapp-templates --locales=nl,en
php artisan pitchbar:whatsapp-templates --list # check Meta approval status
php artisan pitchbar:whatsapp-test --email=ops@acme.com
Talen
Elke medewerker ontvangt het sjabloon in de taal van zijn of haar eigen interface
als er een is ingediend; anders wordt de
standaardtaal van de installatie gebruikt. Het sjablooncommando detecteert de
verschillende taalinstellingen van je medewerkers (of gebruikt een expliciete --locales
-lijst) en dient precies die in — zodat je geen aparte Meta-beoordeling hoeft in te dienen
voor talen die niemand gebruikt.
analytics
-wachtrij), nooit vanuit de live SSE-stream — een
melding vertraagt nooit het antwoord van een bezoeker.
Testen
Gebruik de knop ‘Test verzenden’ in de WhatsApp-sectie van de Systeeminstellingen
(elk nummer) of in Instellingen › Meldingen (je eigen opgeslagen
nummer). Beide geven het echte resultaat van de provider weer — een geaccepteerde verzending, of een
afwijzing met de reden — in plaats van een misleidende ‘verzonden’. Het
commando pitchbar:whatsapp-test doet hetzelfde vanuit de CLI.
De reden bevat de foutcode van de provider en het exacte
veld dat is afgewezen (bijv. [10004] Invalid source
number (field: from)), en een mislukte sjabloonzoekopdracht meldt de
echte fout in plaats van een misleidend ‘geen sjablonen gevonden’.
Bij een geaccepteerde verzending wordt bovendien gecontroleerd of deze is
afgeleverd (een paar seconden): het paneel geeft dan
Afgeleverd ✓ weer, of NIET afgeleverd met de foutcode en
reden van Meta (bijv. [63016] — de sjabloon is nog niet goedgekeurd voor
door bedrijven geïnitieerde verzendingen), of dat de bezorging nog in behandeling is als de
provider nog geen uitslag heeft gegeven binnen het polling-venster. ‘Geaccepteerd’ alleen is nooit
een garantie voor bezorging — Meta kan het verderop weigeren zonder dat de API-aanroep
mislukt, wat je vroeger alleen kon ontdekken door naar de console van de provider te gaan
om dit te controleren.
Problemen oplossen
[10004] Invalid source numberbij verzending- De WhatsApp-afzender (E.164) wordt afgewezen als geldige berichtbron,
ook al geeft het portaal aan dat hij Verbonden is. Twee verschillende
voorwaarden moeten allebei gelden, en ‘Verbonden’ dekt alleen de eerste:
- Meta heeft de afzender goedgekeurd — de sjablonen zijn 'Goedgekeurd' (niet 'In behandeling'), de afzender heeft een goedgekeurde weergavenaam en het bedrijfsprofiel is geverifieerd.
- De WhatsApp-afzender is gekoppeld aan een Telnyx-berichtenprofiel
.
In tegenstelling tot wat je misschien zou verwachten, moet een WhatsApp-
afzender die wordt gebruikt voor het versturen via de API,
worden toegewezen aan een
berichtenprofiel, zodat Telnyx deze kan herkennen aan de hand van het
veld
from. Doe dit in het Telnyx-portaal onder Messaging Suite → WhatsApp-berichten → Nummers beheren (portal.telnyx.com/#/messaging/whatsapp/manage-numbers): controleer of je afzender in de lijst staat en expliciet is toegewezen aan je WhatsApp-berichtenprofiel, en test het daarna opnieuw.
- Sjablonen afgewezen bij verzending
- Open Sjablonen bekijken en het scherm ‘Berichtsjablonen’ van het Telnyx-portaal — daar zie je de specifieke afwijzingsreden van Meta per sjabloon (categorie, opmaak of plaatsing van variabelen). Corrigeer het en dien het opnieuw in.