B Blengi docs

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.

Elk bericht is een vooraf goedgekeurd sjabloon
WhatsApp staat bedrijven alleen toe je buiten een antwoordvenster van 24 uur te berichten met een door Meta goedgekeurd sjabloon (nooit vrije tekst). Dus elke trigger is gekoppeld aan een UTILITY-sjabloon dat Meta één keer beoordeelt (≈24–48 uur). Totdat ze zijn goedgekeurd, blijft het kanaal stil.

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.
WhatsApp rekent per gesprek
WhatsApp rekent per gesprek van 24 uur. Nieuwe leads, overdrachten en widgetfouten zijn laag volume — geen probleem. Nieuw gesprek wordt geactiveerd bij elk eerste bericht, dus als je dit voor de hele werkruimte inschakelt, kan dat de Telnyx-rekening flink opdrijven. Het is gekoppeld aan dezelfde opt-in per gebruiker, dus het inschakelen is altijd een bewuste keuze.

Eenmalige instelling

  1. Telnyx API-sleutel — Telnyx Portal → Sleutels & Inloggegevens → API-sleutels. Kopieer de waarde van KEY….
  2. 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).
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. Inschakelen — zodra Meta het heeft goedgekeurd (het paneel ‘Sjablonen bekijken ’ toont goedgekeurd ), zet je WhatsApp-verzending inschakelen aan in Systeeminstellingen.
  8. 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.

Buiten het hotpath van de bezoeker
Elk WhatsApp-bericht wordt verzonden vanuit een taak in de wachtrij (de 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 number bij 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:
  1. Meta heeft de afzender goedgekeurd — de sjablonen zijn 'Goedgekeurd' (niet 'In behandeling'), de afzender heeft een goedgekeurde weergavenaam en het bedrijfsprofiel is geverifieerd.
  2. 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.
WhatsApp-afzenders staan op dat scherm Nummers beheren, niet onder ‘Mijn nummers’ (standaard telefooninventaris). Als de afzender ‘Verbonden’ is, maar het portaal geen optie biedt om het profiel te koppelen, vraag dan de Telnyx-helpdesk om het in hun backend te koppelen.
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.