Your AI Connector Docs

SMS-provider (Bring Your Own Twilio)

Deze pagina beheert het Twilio-account dat wordt gebruikt voor WhatsApp Business API. Standaard draait de WhatsApp Business API op het beheerde Twilio-account van het platform — je ziet Twilio nooit en je hoeft je niet zelf aan te melden bij Twilio. Als je je eigen Anthropic-sleutel (BYOK) hebt gekoppeld, kosten beheerde Twilio WhatsApp-berichten 0,05 credits per stuk, zowel inkomend als uitgaand. Bij elk ander account zijn die bezorgkosten al gedekt door je AI-credittarief, dus er is geen aparte toeslag per bericht. (De eigen berichtprijzen van WhatsApp veranderen op 1 oktober 2026 — zie WhatsApp-kosten & de wijziging van oktober 2026.) Dit is alleen relevant als je specifiek wilt dat de WhatsApp Business API op je eigen Twilio-account draait.

Voor SMS geldt altijd ‘Bring Your Own Twilio’. SMS-regelgeving (A2P 10DLC, merkregistratie, goedkeuring van afzender-ID) moet op naam van je eigen bedrijf worden ingediend, dus het platform biedt geen beheerde SMS-nummers aan. Koppel SMS afzonderlijk via de kaart SMS via Twilio in Instellingen → Kanalen (er is ook een optie voor een Android-telefoon SMS-gateway). Deze pagina — de kaart Twilio-account — beheert het WhatsApp Business API-account en wijzigt je SMS-nummer niet.

Waarom zou ik de WhatsApp Business API overzetten naar mijn eigen Twilio?

De meeste gebruikers doen dit niet. Het beheerde account is eenvoudiger:

  • Het huren van een WhatsApp-nummer, het indienen van sjablonen, de registratie van de afzender en de status van het nummer worden allemaal voor je afgehandeld. Een nummer dat hier wordt gehuurd kost minimaal 50 credits per maand, en die huur is inclusief de WhatsApp-verbinding — zie Telefoonnummers.
  • Er is geen aparte Twilio-factuur. Als je je eigen Anthropic-sleutel (BYOK) hebt gekoppeld, kosten beheerde Twilio WhatsApp-berichten 0,05 credits per stuk, zowel inkomend als uitgaand. Bij elk ander account zijn die bezorgkosten al gedekt door je AI-credittarief, dus er is geen aparte toeslag per bericht. Zie WhatsApp-kosten & de wijziging van oktober 2026 voor de prijswijziging van WhatsApp die op 1 oktober 2026 ingaat.
  • Support kan helpen bij het direct oplossen van bezorgproblemen.

Je wilt wellicht je eigen Twilio gebruiken als:

  • Je hebt al een bestaand Twilio-account met goedgekeurde WhatsApp-sjablonen en opgewarmde nummers die je wilt blijven gebruiken.
  • Je bedrijf heeft een inkoop- of compliance-reden om direct aan Twilio te betalen.
  • Je wilt volledig inzicht in het onderliggende gebruik en de prijzen op carrier-niveau.

Het behouden van een opgewarmd nummer is een taak in twee stappen. Het overschakelen van het account (hieronder) verandert alleen via welk Twilio-account we verzenden. Je bestaande WhatsApp-nummer verschijnt pas als kanaal nadat je het ook hebt gekoppeld — zie Een WhatsApp-nummer koppelen dat je al hebt. Voer ze in die volgorde uit.

Hoe overstappen

Hoe kom je daar: Instellingen → groep Kanalen → Kanalen, en zoek vervolgens de kaart Twilio-account.

Wat je ziet hangt af van je huidige configuratie:

Als je het beheerde account gebruikt (standaard)

Je ziet een korte uitleg en een Beheren-knop op de Twilio-accountkaart. Als je hierop klikt, wordt het formulier Overschakelen naar je eigen Twilio-account geopend, waarin om je Twilio Account SID en Auth Token wordt gevraagd — met de waarschuwing voor een destructieve actie direct in het dialoogvenster.

Lees de waarschuwingen zorgvuldig door voordat je bevestigt; de overstap is destructief:

  • Alle nummers die je via het platform hebt gekocht, worden permanent vrijgegeven. Als je een nummer wilt blijven gebruiken, houd het dan in het beheerde account (stap niet over) of koop/porteer het eerst naar je eigen Twilio.
  • Goedgekeurde WhatsApp-sjablonen worden niet overgezet. Sjablonen horen bij het WhatsApp Business-account dat de afzender bezit — je moet ze opnieuw indienen op je eigen account en wachten op hernieuwde goedkeuring.
  • Bestaande chats en berichtgeschiedenis blijven zichtbaar, maar nieuwe antwoorden op vrijgegeven nummers zullen mislukken (het nummer is verdwenen).
  • Je kunt later terugschakelen, maar je krijgt dan een nieuw beheerd account zonder nummers en zonder sjablonen — je oude gegevens komen niet terug.

Waar vind je je Account SID en Auth Token: log in op de Twilio Console via console.twilio.com. Beide staan op het hoofddashboard, in het paneel “Account Info”. De Account SID begint met AC en is 34 tekens lang.

Nadat je beide waarden hebt ingevoerd en bevestigd, zal het systeem:

  1. Valideren of de inloggegevens werken.
  2. Elk beheerd telefoonnummer vrijgeven vanuit Twilio.
  3. Het beheerde sub-account sluiten.
  4. Je inloggegevens opslaan zodat alle toekomstige uitgaande WhatsApp-berichten je eigen account gebruiken. Je afzonderlijk gekoppelde SMS via Twilio-nummer wordt onafhankelijk opgeslagen en wordt door deze overstap niet vrijgegeven of gewijzigd.

Dit kan enkele seconden tot een paar minuten duren als je meerdere nummers had.

Als je al op je eigen Twilio-account zit

De kaart toont je gekoppelde account en stelt je in staat om terug te schakelen naar de beheerde configuratie.

Terugschakelen naar beheerd zorgt voor een nieuw beheerd sub-account. Zoals hierboven vermeld: het herstelt niet de nummers of sjablonen die je voorheen had — je begint vanaf nul.

Een WhatsApp-nummer koppelen dat je al hebt

Zodra het account op je eigen Twilio staat, verandert de knop WhatsApp verbinden op de kaart WhatsApp Business API van functie: de beheerde optie wordt Via je Twilio-account, waarmee een WhatsApp-afzender wordt gekoppeld binnen het Twilio-account dat je hebt verbonden, en het kopen van een beheerd nummer wordt niet langer aangeboden. Dat is bewust — het kopen van een nummer of het uitvoeren van de Meta-aanmelding zou een tweede, door het platform beheerd Twilio-account naast het jouwe creëren, en je berichten zouden dan vanuit het ene account worden verzonden terwijl het nummer in het andere staat.

Voordat je begint

Je nummer moet al een werkende WhatsApp-afzender zijn binnen je eigen Twilio-account:

  • Het is geregistreerd als een WhatsApp-afzender in Twilio, gekoppeld aan je eigen WhatsApp Business-account.
  • Twilio toont die afzender als Online.

Dit scherm registreert niets. Het maakt geen afzender aan, communiceert niet met Meta en dient je nummer niet in voor goedkeuring — het verbindt een afzender die al werkt. Als je er nog geen hebt, voer dan eerst de WhatsApp-afzenderconfiguratie uit in Twilio.

Stappen

  1. Ga naar Instellingen → Kanalen-groep → Kanalen.
  2. Klik op de kaart WhatsApp Business API op Je afzender koppelen.
  3. Voer het WhatsApp-nummer in internationaal formaat in (bijvoorbeeld +31612345678), precies zoals het verschijnt bij de afzender in Twilio.
  4. Geef het optioneel een Label — een naam voor het nummer binnen de app. Indien leeg gelaten, gebruikt het de naam van je Twilio-afzenderprofiel.
  5. Klik op Afzender koppelen.

Je hoeft je Account SID of authenticatietoken niet opnieuw in te voeren: die hebben we al van de accountwissel.

Wat er achter de schermen gebeurt

  1. We zoeken de afzender voor dat nummer op in uw Twilio-account en controleren of Twilio dit online heeft staan.
  2. We zorgen ervoor dat er een berichtenservice in uw account bestaat en laten de inkomende webhook naar ons wijzen (we maken er een aan, vernoemd naar de app, als u er nog geen heeft). Dit is ook wat het verzenden van sjablonen mogelijk maakt.
  3. We koppelen uw afzender aan die berichtenservice.
  4. We laten de eigen webhook van de afzender naar ons wijzen, zodat inkomende berichten hier aankomen.
  5. Het nummer verschijnt in uw lijst met nummers, gemarkeerd als Uw Twilio (BYO), klaar om toe te wijzen aan een campagne of agent.

Je goedgekeurde sjablonen blijven precies waar ze zijn, in je eigen account. Er wordt niets opnieuw ingediend en er wordt niets vrijgegeven.

Kosten

Er zijn geen maandelijkse onderhoudskosten voor een nummer dat je op deze manier koppelt — je betaalt Twilio rechtstreeks voor het nummer en de kosten per bericht. AI-antwoorden gebruiken nog steeds credits zoals gebruikelijk.

Als het niet werkt

  • “No WhatsApp sender for … exists in your Twilio account” — het nummer is daar niet geregistreerd als WhatsApp-afzender, of het is anders getypt. Controleer de exacte afzender-ID in de Twilio Console en voer deze opnieuw in met het internationale formaat.
  • “The WhatsApp sender … is not online in Twilio” — de eigen reden van Twilio staat in het bericht. Los dit eerst op in Twilio; het koppelen van een afzender die in Twilio offline staat, zou later alleen maar stilletjes mislukken.
  • “… is already connected to another account” — het nummer is hier aan een ander account gekoppeld. Ontkoppel het daar eerst.
  • “This account is still on the managed Twilio account” — voer eerst de bovenstaande overstap uit.
  • “we could not update its webhook in Twilio” — het nummer is gekoppeld en zal verzenden, maar de afzender wijst nog steeds naar de webhook die je daarop had ingesteld. Wis die webhook op de afzender in de Twilio Console zodat inkomende berichten ons bereiken.

Limieten

  • Je kunt maximaal één keer per 24 uur van provider wisselen. Dit voorkomt dat herhaaldelijk schakelen Twilio API-kosten en snelheidslimieten opdrijft.
  • Het verzenden van SMS wordt volledig ongemoeid gelaten door deze instelling — als je al je eigen Twilio hebt gekoppeld via de kaart SMS via Twilio, is dat een andere verbinding die blijft staan, ongeacht wat je hier doet.

Wat als er iets misgaat?

  • “Could not authenticate with the provided Twilio credentials” — controleer de SID (begint met AC, 34 tekens) en het authenticatietoken nogmaals. Beide zijn hoofdlettergevoelig.
  • “Account is not active” — het Twilio-account dat u probeert te gebruiken is opgeschort of gesloten. Gebruik een actief account.
  • “Please wait Xh before switching again” — u bevindt zich in de afkoelperiode van 24 uur. Wacht tot deze voorbij is.
  • Gedeeltelijke migratie (sommige nummers zijn vrijgegeven, andere niet) — voer de overstap opnieuw uit. Het systeem is idempotent; het gaat verder waar het gebleven was en voltooit het vrijgeven van alles wat nog in het beheerde sub-account staat.

Als je vastloopt na het overschakelen — uitgaande berichten worden niet verzonden, sjablonen verschijnen niet — neem dan contact op met de ondersteuning met je Account SID (nooit de auth token).

Hulp nodig?

If you’re not sure whether switching is right for you, or run into trouble, contact support and we can help you decide.