WhatsApp-templates en Business API

WhatsApp eist dat zakelijke berichten met regels werken, vooraf goedgekeurde templates voor het eerste bericht, een 24-uurs venster voor vrije berichten, en limieten op bijlagen. Dit is hoe het werkt in Tesoro via Twilio.

WhatsApp-instellingen — Template-instellingen op het persoonlijke instellingenscherm.

Wanneer is dit relevant?

Eerste bericht naar een contact gaat de fout in, u zoekt de template-regel
Het 24-uurs venster is verlopen en u snapt niet waarom u niet meer mag sturen
U wilt weten wat het kost

Hoe de integratie werkt

Tesoro praat niet rechtstreeks met WhatsApp:

Tesoro → bericht naar Twilio API
Twilio → doorsturen naar WhatsApp Business API (whatsapp:-prefix)
WhatsApp → aflevering bij ontvanger
Statusupdates (delivered, read, failed) terug via Twilio-webhooks
Inkomende berichten → realtime naar alle teamleden

Wat u nodig heeft

Onderdeel	Wat
Twilio-account	Actief, met tegoed
WhatsApp Business-profiel	Goedgekeurd door Meta via Twilio
Geregistreerd WhatsApp-nummer	Specifiek voor WhatsApp Business API; ingesteld in Settings → My Company → Call Settings
Twilio SID + Token	API-credentials, door systeembeheerder geconfigureerd

Berichtentemplates: wat en waarom

Vooraf goedgekeurde berichtformaten. Verplicht voor het eerste bericht naar een contact.

In Tesoro heeft elke template:

Veld	Wat	Validatie
Title	Naam om te herkennen	3, 100 tekens
Description	De inhoud die verstuurd wordt	3, 100 tekens

Templates bekijken

Auto-geladen wanneer u WhatsApp-tab opent op een record. Beschikbaar voor Admin + Employee.

Een template versturen

WhatsApp-tab van contact/deal/lead/relatie.
Geen gespreksgeschiedenis? → systeem vraagt template-selectie.
Kies uit dropdown (titel zichtbaar).
Get Started → description wordt verstuurd als berichttekst.
Bericht geregistreerd met bezorgstatus, Twilio SID en richting.

Goedkeuringsproces (Meta)

Sjabloon aanmaken: in Twilio of Meta Business Manager. Tekst + categorie (marketing, transactioneel, authenticatie) + variabelen.
Beoordeling Meta: minuten tot dagen.
Goedkeuring/afwijzing: Twilio-dashboard of Meta Business Manager toont status.
Registratie in Tesoro: goedgekeurde templates verschijnen in dropdown.

Veelvoorkomende afwijsredenen

Reden	Toelichting
Misleidende inhoud	Onjuiste of misleidende info
Geen opt-out	Geen afmeldmogelijkheid voor ontvanger
Verboden inhoud	Gokken, alcohol, etc.
Onjuiste opmaak	Variabelen of opmaak voldoen niet aan tech-vereisten

Wanneer: eerste bericht of na verlopen 24-uurs venster
Hoe: selecteer template, systeem stuurt description
Bijlagen: niet ondersteund

Vergelijking:

Kenmerk	Sjabloon	Vrij
Eerste bericht	✅ verplicht	❌
Inhoud	Voorgedefinieerd	Vrij
Max lengte	100 tekens (templatelimiet)	1.600 tekens
Bestandsbijlagen	❌	✅ (tot 10)
Goedkeuring vereist	✅ (Meta)	❌

Het 24-uurs gespreksvenster

WhatsApp-regel om spam te voorkomen.

U stuurt sjabloonbericht → gesprek geopend.
Contact antwoordt → 24-uurs venster start.
24 uur lang → u kunt vrije berichten sturen zonder template.
Geen antwoord binnen 24u → venster sluit. Nieuwe template nodig om gesprek te heropenen.

Wat te doen bij verlopen venster

Probeert u vrij bericht na 24 uur? WhatsApp weigert.

Ga terug naar template-selectie.
Kies goedgekeurde template.
Verstuur, venster heropent.
Wacht op antwoord voor vrije berichten.

Mediaberichten: bestanden versturen

Alleen bij vrije berichten, niet bij templates.

Hoe Tesoro het verwerkt:

Elk bestand = apart WhatsApp-bericht via Twilio met mediaUrl
Tekst = apart bericht
Bestanden opgeslagen in Tesoro + gekoppeld aan berichtrecord

Ondersteunde types

Type	Voorbeelden
Documenten	PDF, Word, Excel
Afbeeldingen	JPEG, PNG, GIF, WebP
Audio	MP3, OGG
Video	MP4
Archieven	ZIP, RAR

Limieten: max 10 bestanden per bericht, 1,5 MB per stuk.

Bestanden ontvangen

Contact stuurt bestand → Tesoro:

Detecteert via Twilio NumMedia-webhook
Downloadt van Twilio media-URL
Slaat op in Tesoro met juiste extensie (uit MIME-type)
Koppelt aan berichtrecord + contact

Bezorgstatus en realtime updates

Statussen

Status	Wat
queued	Wachtrij bij Twilio
sent	Verstuurd naar WhatsApp
delivered	Op apparaat ontvanger
read	Ontvanger heeft gelezen
failed	Niet bezorgd

Realtime updates

Inkomend bericht → notificatie aan alle gebruikers
Status-wijziging → live update in chatweergave (geen pagina-vernieuwing)

Kosten

Component	Toelichting
Twilio-berichttarief	Per bericht (in + uit), per land verschillend
WhatsApp-gesprekstarief	Per 24-uurs venster, verschil tussen bedrijf-gestart (template) en gebruiker-gestart (antwoord)
Templatecategorie	Marketing > transactioneel > authenticatie
Mediaberichten	Extra kosten afhankelijk van type + grootte

Rechten

Actie	Wie
Berichten versturen (vrij)	Admin, Employee
Berichten versturen (template)	Admin, Employee
Berichten lezen	Admin, Employee
Templates bekijken	Admin, Employee

Veelgemaakte fouten

Template verschijnt niet: check titel + description (beide 3, 100 tekens). Mogelijk niet geregistreerd in Twilio.
“The selected template doesn’t match our records”: template-ID bestaat niet meer (verwijderd?).
Bericht geweigerd na 24 uur: venster verlopen. Nieuwe template versturen.
Bijlagen niet mogelijk bij template: gebruik vrij bericht (na contact-antwoord).
“Company with Twilio WhatsApp number attached not found”: nummer in Twilio-webhook matcht geen bedrijf. Check Settings → My Company → Call Settings.

Volgende stappen

WhatsApp en SMS basics Hoe u verstuurt + ontvangt en welke setup nodig is.

Telefoongesprekken Plannen + bellen via Twilio.