B Blengi docs

Je AI-medewerker bouwen

WhatsApp-kanaal

Je AI-medewerker kan klanten op WhatsApp beantwoorden met dezelfde kennis, instellingen en controles als op je website: één brein, één toegang per kanaal. WhatsApp-chats komen in dezelfde inbox terecht als website-chats, een teamlid kan er op elk moment een overnemen, en elke WhatsApp-chat is een lead (het nummer van de klant is bekend). WhatsApp draait op Meta’s WhatsApp Cloud API; je bedrijf betaalt Meta rechtstreeks voor de berichten.

Abonnement
WhatsApp maakt deel uit van de abonnementen waarin het is inbegrepen. Een abonnement kan ook een limiet instellen voor het aantal WhatsApp-antwoorden van de AI per maand; als die limiet is bereikt, wachten nieuwe WhatsApp-chats op je team in de inbox in plaats van dat ze een antwoord van de AI krijgen.

Een nummer koppelen

Open de AI-medewerker en ga naar het WhatsApp-tabblad (/app/agents/{id}/whatsapp). Een werkruimte kan meerdere nummers koppelen; elk nummer beantwoordt als één AI-medewerker, te kiezen onder Antwoorden als (kies Niemand om alleen je team te laten beantwoorden).

  • Koppel via Facebook — log in met Facebook in het pop-upvenster en kies je WhatsApp-nummer (Meta’s Embedded Signup). Kies 'De WhatsApp Business-app behouden' om de app op je telefoon met hetzelfde nummer te blijven gebruiken (Coexistence), of 'Een nieuw nummer gebruiken' voor een nummer dat niet in de WhatsApp-app staat. Deze knop verschijnt zodra de Meta-app van Blengi is goedgekeurd (Meta Tech Provider). Het maakt gebruik van Meta’s Embedded Signup v5 (Meta heeft v2 en v3 op 15 oktober 2026 buiten gebruik gesteld). Welk soort nummer er is gekoppeld, wordt aan Meta zelf gevraagd, en niet afgeleid van de knop waarop je hebt geklikt: een nummer dat volgens Meta in gebruik is met de WhatsApp Business-app wordt nooit geregistreerd voor de Cloud API, omdat dat de app zou blokkeren. Als Meta alleen het WhatsApp Business-account noemt, wordt het enige nummer van dat account gekoppeld; bij meerdere nummers wordt je gevraagd het nog eens te proberen en er één te kiezen.
  • Handmatig koppelen — voor een nummer dat je zelf hebt ingesteld in Meta’s WhatsApp Manager: plak het toegangstoken, het telefoonnummer-ID en het WhatsApp Business-account-ID. Meta controleert het token voordat er iets wordt opgeslagen, en Blengi abonneert zich op de berichten van het nummer. Een nummer dat Meta heeft geverifieerd maar nog niet heeft geregistreerd voor de Cloud API (bijvoorbeeld Meta’s eigen testnummer) wordt meteen geregistreerd; zonder dat zou elk bericht mislukken met de melding ‘Account niet geregistreerd’. Een nummer in de WhatsApp Business-app wordt nooit geregistreerd.

Een nummer kan maar aan één Blengi-account worden gekoppeld. Als je de koppeling met een nummer verbreekt, stopt de AI daarop; de chats blijven in de inbox staan.

De verbinding van 60 dagen

Een nummer dat is gekoppeld aan Facebook krijgt van Meta een token dat 60 dagen geldig is: de configuratie van Blengi’s Embedded Signup kon alleen worden gemaakt met Meta’s 60-dagen-sjabloon. Elke ochtend (07:10) vernieuwt het geplande commando pitchbar:renew-whatsapp-tokens elk token dat binnen 14 dagen afloopt, met nog eens 60 dagen, via Meta’s fb_exchange_token -vernieuwing. Niemand hoeft iets te doen zolang dat werkt. Als Meta weigert, krijgen de eigenaren en beheerders van de werkruimte en de platformbeheerders een e-mail 14 dagen voor het einde, 3 dagen ervoor en nog een keer op de dag dat het nummer stopt, en op de kaart van het nummer op het WhatsApp-tabblad staat dat ook aangegeven (oranje zolang het nog werkt, rood zodra het is gestopt). De oplossing is om opnieuw op ‘Verbinden met Facebook’ te klikken en hetzelfde nummer te kiezen: dan krijg je een nieuw token en blijven je instellingen en chats behouden. Nummers die handmatig zijn gekoppeld, hebben geen einddatum en blijven ongewijzigd. Voer de opdracht uit met --dry-run om de nummers weer te geven waarvan de geldigheidsduur afloopt, zonder Meta te bellen of een e-mail te sturen.

Hoe de AI reageert op WhatsApp

  • Eén antwoord op meerdere berichten. Klanten sturen vaak een paar korte berichten achter elkaar. De AI wacht een paar seconden na het laatste bericht (Wachten op meer berichten, 2–15 seconden, standaard 4) en beantwoordt ze allemaal tegelijk.
  • Lezen en typen. De klant ziet zijn bericht gemarkeerd als gelezen en ‘aan het typen…’ terwijl het antwoord wordt opgesteld.
  • WhatsApp-opmaak. Korte alinea’s, *bold*, gewone webadressen; productsuggesties komen binnen als foto’s met naam, prijs en link (maximaal drie); antwoordsuggesties worden antwoordknoppen (maximaal drie, anders een lijst). Een antwoordknop toont 20 tekens, dus de AI houdt zijn suggesties zo kort; als een suggestie toch langer is, verschijnen de keuzes als een lijst die de hele vraag laat zien in plaats van een afgekorte knop. Alleen echte webadressen worden als links verstuurd.
  • Er staat dat het een AI is. Het eerste antwoord in een chat begint met een regel waarin staat dat de klant met een AI-medewerker praat, dat hij om een mens kan vragen, en dat STOP de AI stopt. Je kunt die regel zelf per nummer opstellen.
  • STOP en START. Een klant die STOP (of STOPPEN, AFMELDEN, ABMELDEN, ARRÊT…) stuurt, krijgt geen AI-antwoorden meer; met START zet je het weer aan. Je team kan nog steeds antwoorden.
  • Met een medewerker praten. De knop ‘medewerker’, of vragen om een medewerker, werkt net als op de website: de chat wordt gemarkeerd voor het team.
  • Foto’s en spraakberichten. De AI leest alleen tekst. Bij een foto met bijschrift wordt er op basis van het bijschrift gereageerd; zonder bijschrift wordt de klant gevraagd de vraag in te typen.
  • Je startpagina telt als de pagina. Op je website leest de AI ook de pagina voor waar de bezoeker zich bevindt. Een WhatsApp-chat heeft geen pagina, dus leest de AI in plaats daarvan je startpagina voor: die in de taal van de chat als je site er een heeft (/nl), anders je algemene startpagina, anders je ‘Over ons’-pagina. Als de strikte modus is ingeschakeld, krijgt een vraag die niet in je kennisbestand staat een eerlijk antwoord — "Nee, we verkopen geen Coolmax; we …" — in plaats van de standaardzin, die blijft staan voor vragen die noch je kennisbestand, noch die pagina kan beantwoorden. Voorheen gaven strikte AI-medewerkers de standaardzin bij 57% van de WhatsApp-berichten en bij 3% op websites. Welke pagina’s de kenniszoekfunctie vindt, verandert niet.

Als de AI niets zegt

  • nam een teamlid de chat over, of vroeg de klant om een medewerker.
  • Je hebt de chat zelf beantwoord in de WhatsApp Business-app (Co-existentie): de AI laat die chat een tijdje aan jou over (de AI trekt zich terug na je eigen antwoord, standaard 12 uur).
  • De klant stuurde STOP.
  • Het 24-uursvenster is gesloten (zie hieronder), of de maandelijkse WhatsApp-limiet van het abonnement is opgebruikt. De chat wacht dan op je team.

De 24-uursregel

WhatsApp staat alleen gratis antwoorden toe binnen 24 uur na het laatste bericht van de klant. Daarna mogen alleen betaalde, vooraf goedgekeurde sjabloonberichten worden verstuurd. In de inbox zie je tot wanneer een antwoord mogelijk is; een antwoord dat WhatsApp weigert, wordt bewaard en gemarkeerd als niet bezorgd. De knop Test verzenden volgt dezelfde regel: het bericht komt alleen aan bij een telefoon die het nummer in de afgelopen 24 uur heeft gebeld.

In de inbox

tonen WhatsApp-chats een WhatsApp-badge met de naam en het nummer van de klant; het kanaalfilter toont alleen website- of alleen WhatsApp-chats. Binnen een chat zie je het nummer waar het bericht vandaan kwam, het 24-uursvenster en per bericht of het is verzonden, bezorgd, gelezen of niet bezorgd. Antwoorden die je in de inbox typt, worden meteen via WhatsApp verstuurd. Met Coexistence verschijnen antwoorden die je vanuit de WhatsApp Business-app verstuurt ook in de inbox, en worden eerdere chats uit de app geïmporteerd, zodat de AI weet wat er eerder is gezegd.

Geheugen

WhatsApp-chats duren dagenlang. De AI onthoudt de laatste twaalf berichten woord voor woord en een korte samenvatting van alles wat eraan voorafging; zie Geheugen . Een chat die na een pauze weer wordt opgepakt, wordt gelezen zoals hij was: het bericht dat net is verzonden is de vraag, niet ook het bericht ervoor („Minder dan 5“ na een pauze werd doorzocht als „Minder dan 5 Minder dan 5“ en het antwoord ging verloren).

Privacy

WhatsApp-berichten gaan via Meta. Meta mag de inhoud van berichten maximaal 30 dagen bewaren om ze te bezorgen en voor de veiligheid. Jouw bedrijf is de verwerkingsverantwoordelijke van de chats; Blengi verwerkt ze voor je. Het nummer van de klant wordt gebruikt om te reageren en wordt opgeslagen als lead. Vermeld dit in je eigen privacybeleid.

Nachtelijke tests

Voor een AI-medewerker met een gekoppeld nummer loopt elke testcase ook via WhatsApp — 's nachts en met Nu uitvoeren — en wordt beoordeeld op de tekst die de klant op WhatsApp zou krijgen. De uitvoeringen worden gemarkeerd met nightly-whatsapp / manual-whatsapp.