Support › Dashboard › Formulierrecepten › Hoe u een WhatsApp-bericht kunt activeren

Hoe u een WhatsApp-bericht kunt activeren

Bijgewerkt op 14 juni 2026  ·  7 min leestijd

Met WhatsApp als ’s werelds populairste instant messaging platform, is het niet verwonderlijk dat je wilt weten hoe je WhatsApp-berichten kunt gaan verzenden op basis van verschillende systeem- of workflowtriggers.

Ons platform biedt twee verschillende manieren om WhatsApp-functionaliteit in je aangepaste mobiele app te integreren:

  1. Door gebruiker geïnitieerde berichten (actieknop): Genereer een dynamische WhatsApp “click-to-chat” HTML-link die de WhatsApp-app van de gebruiker opent met een voorgevuld bericht wanneer deze op een actieknop tikt.
  2. De REST Connector/Field gebruiken (WhatsApp REST API): Verzend automatisch een gesjabloneerd WhatsApp-bericht naar een vooraf ingesteld nummer op de achtergrond wanneer een gebruiker een formulier indient. Dit maakt gebruik van onze REST-formulierconnector en de WhatsApp Cloud API.

Deze handleiding helpt je bij het instellen van beide methoden.

Methode 1: Een bericht via een actieknop verzenden (WhatsApp-link)

Als je de voorkeur geeft aan het initiatief van de gebruiker voor het WhatsApp-bericht vanaf hun eigen apparaat, hoef je de Meta API niet in te stellen. In plaats daarvan kun je ons platform gebruiken om een dynamische WhatsApp “click-to-chat” HTML-link te genereren en deze aan een actieknop toe te wijzen.

Wanneer de gebruiker op de knop tikt, opent dit hun WhatsApp-toepassing met een voorgevuld bericht dat klaar is om naar je aangewezen nummer te worden verzonden.

1. Inzicht in de WhatsApp-linkindeling WhatsApp gebruikt een specifieke URL-structuur om een chat te openen en tekst voorin te vullen.

Basis URL-indeling

Copy to clipboard
https://wa.me/<number>?text=<urlencodedtext>
  • <number>: Het volledige telefoonnummer van de ontvanger in internationaal formaat. Laat haakjes, streepjes, plustekens of voorloopnullen weg. (gebruik bijvoorbeeld 15551234567, niet +1-(555)-123-4567).
  • <urlencodedtext>: Het voorgevulde bericht. Omdat het deel van een URL is, moeten spaties en speciale tekens URL-gecodeerd zijn (bijvoorbeeld een spatie wordt %20).

2. De dynamische link genereren Op ons platform kun je deze URL dynamisch samenstellen door statische tekst met variabele gegevens uit je app te combineren.

Als je bijvoorbeeld wilt dat het bericht zegt: “Hoi, ik heb inspectiereferentiecode ABC123 voltooid”, zou je basis-URL er als volgt uit zien:

Basis URL-gecodeerde indeling

Copy to clipboard
https://wa.me/15551234567?text=Hi,%20I%20have%20completed%20inspection%20reference%20code%20

Vervolgens voeg je de dynamische Handlebar-variabele voor de eigendom-ID aan het einde van die string toe (bijvoorbeeld {{property_id}}).

3. De actieknop configureren

  • Voeg een actieknop toe aan je scherm of formulier.
  • Stel het actietype van de knop in op het openen van een URL/weblink.
  • Bind de dynamisch gegenereerde https://wa.me/... URL die je in de vorige stap hebt gemaakt, aan het doel van de knop.

Wanneer de gebruiker op de knop klikt, zal het native OS van het apparaat de wa.me link onderscheppen en de gebruiker naadloos naar hun WhatsApp-app brengen met je aangepaste bericht klaar om te verzenden!

Methode 2: De REST Connector/Field gebruiken (WhatsApp REST API)

WhatsApp integreren met je aangepaste mobiele app laat je automatisch directe meldingen naar een vooraf ingesteld nummer verzenden wanneer een gebruiker een formulier indient. Deze handleiding helpt je bij het instellen van de WhatsApp Cloud API en het configureren van de REST-formulierconnector op ons platform.

Vereisten

Voordat je begint, zorg ervoor dat je het volgende hebt:

  • Een Meta Developer-account (registreer op developers.facebook.com).
  • Een WhatsApp Business Account (WABA).
  • Een speciaal telefoonnummer voor WhatsApp dat momenteel niet is geregistreerd bij de consumer of standaard WhatsApp-apps voor bedrijven.

Stap 1: De WhatsApp Cloud API instellen

Om berichten te verzenden, moet je API-inloggegevens genereren via Meta.

  1. Een Meta-app maken: * Log in op je Meta Developer-dashboard en klik App maken.
    • Selecteer Overige voor het gebruiksscenario en kies vervolgens Bedrijf als het app-type.
    • Vul je appdetails in en klik App maken.
  2. WhatsApp toevoegen aan je app:
    • Scroll in het App Dashboard omlaag naar “Producten toevoegen aan je app” en zoek WhatsApp. Klik Instellen.
    • Selecteer je bestaande Meta Business Account of laat het systeem een account voor je maken.
  3. Je telefoonnummer configureren:
    • Navigeer in het menu aan de linkerkant naar WhatsApp > API Setup.
    • Volg de aanwijzingen om je speciaal telefoonnummer toe te voegen. Meta stuurt een SMS of voicecode om eigendom te verifiëren.
  4. Een toegangstoken genereren:
    • Voor testen levert Meta een tijdelijk toegangstoken (geldig voor 24 uur).
    • Voor productie moet je een permanent toegangstoken genereren door een systeemgebruiker in je Meta Business Settings aan te maken en deze whatsapp_business_messaging machtigingen te geven.

Stap 2: Een berichtsjabloon maken

WhatsApp vereist dat bedrijven vooraf goedgekeurde sjablonen gebruiken wanneer ze een bericht naar een gebruiker sturen. Standaard tekstberichten zijn alleen toegestaan als de gebruiker de afgelopen 24 uur met het bedrijf heeft gecommuniceerd.

  1. Ga naar je WhatsApp Manager (toegankelijk via je Meta Business Suite).
  2. Navigeer naar Accounttools > Berichtsjablonen en klik Sjabloon maken.
  3. Kies een categorie (bijvoorbeeld Utility voor formulierwaarschuwingen) en geef je sjabloon een naam (bijvoorbeeld new_form_submission).
  4. Schrijf je bericht. Je kunt variabelen gebruiken om later dynamische gegevens uit je formulier in te voegen.

Belangrijke opmerking over Handlebars (onze vs. Meta): Ons SaaS-platform gebruikt naamde variabelen (bijvoorbeeld {{firstname}}), wat betekent dat het gegevens identificeert op basis van de specifieke veldnaam. Meta’s WhatsApp API gebruikt echter positionele variabelen (bijvoorbeeld {{1}}, {{2}}). Meta weet niet wat een “firstname” is; het kijkt alleen naar de geordende lijst die je het stuurt en wijst het eerste item toe aan {{1}}, het tweede item aan {{2}}, enzovoort.

  • Voorbeeldbody in Meta: “Hallo, een nieuwe formulierindiening voor {{1}} is ontvangen van {{2}}.”
  1. Dien de sjabloon in voor goedkeuring door Meta (dit duurt meestal slechts enkele minuten tot enkele uren).

Stap 3: De REST Connector in je app configureren

Zodra je WhatsApp-berichtsjabloon is goedgekeurd en je API-inloggegevens hebt, kun je de REST-connectoroproep instellen in de formulierconnectorsectie van”>

Pro Tip

Voeg je permanente token key toe als Organization Metadata in je Org Setup op ons beveiligde webportaal. Op deze manier kun je de token-waarde op elk formulier ophalen door deze eenvoudig te refereren via de ORGMETA()-functie (bijvoorbeeld ORGMETA('Whatsapp_Token')).

3. Format de JSON Payload Construeer de JSON body om je goedgekeurde template te versturen. Omdat Meta positievariabelen gebruikt, is de volgorde van de items in de parameters array strikt verbonden met de {{1}} en {{2}} variabelen in je template.

Map de benoemde formuliervelden van ons platform (zoals {{field_name}} en {{firstname}}) rechtstreeks in de text velden. Wanneer het formulier wordt ingediend, zal ons platform dynamisch de echte gegevens op die plekken invoegen voordat de payload naar Meta wordt verzonden.

JSON

JSON Body for Whatsapp API

Copy to clipboard
{
  "messaging_product": "whatsapp",
  "to": "RECIPIENT_PHONE_NUMBER_WITH_COUNTRY_CODE",
  "type": "template",
  "template": {
    "name": "new_form_submission",
    "language": {
      "code": "en_US"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "{{form_name}}" 
            // 👆 Dit is het EERSTE object in de array. Meta wijst dit automatisch toe aan {{1}}.
          },
          {
            "type": "text",
            "text": "{{firstname}}" 
            // 👆 Dit is het TWEEDE object in de array. Meta wijst dit automatisch toe aan {{2}}.
          }
        ]
      }
    ]
  }
}

Verwijder Opmerkingen uit JSON Sample Code

Standaard JSON ondersteunt technisch gezien geen // opmerkingen. Deze zijn in het bovenstaande voorbeeld opgenomen om uitsluitend te illustreren hoe de mapping werkt. Zorg ervoor dat je de opmerkingen uit je daadwerkelijke API-aanroep verwijdert om opmaakfouten te voorkomen.

Belangrijke JSON Payload Opmerkingen:

  • to: Het telefoonnummer van de ontvanger moet de landcode bevatten zonder het + voorvoegsel of voorloopnullen (bijvoorbeeld 15551234567).
  • name: Dit moet exact overeenkomen met de naam van de template die je in Stap 2 hebt gemaakt.
  • parameters: De objecten in deze array worden direct toegewezen aan de {{1}}, {{2}} variabelen in je template op basis van hun volgorde van boven naar beneden. Als je template geen variabelen heeft, kun je de components array helemaal weglaten.

4. Test de Integratie Stel een geschikt formulier in voor testen en configureer je REST formulier connector. Dien een testformulier in via je mobiele app. Indien correct geconfigureerd, ontvangt je voorgeconfigureerde nummer onmiddellijk het geformatteerde WhatsApp-bericht (bijvoorbeeld “Hallo, een nieuwe formulierindiening voor Contact Inquiry is ontvangen van Jeremy.”). Als het bericht niet wordt verzonden, controleer je de API response logs op ons platform om eventuele Meta autorisatie- of opmaakfouten op te sporen.

Antwoord niet gevonden?

Staat jouw vraag er niet bij? Neem dan direct contact met ons op.

Contact opnemen

Meer in Formulierrecepten