# SMS-berichten Verstuur en ontvang tekstberichten (SMS) via het platform en ontvang inkomende multimediaberichten (MMS). SMS wordt mogelijk gemaakt door Twilio, een toonaangevende telefoondienstverlener, waardoor je wereldwijd betrouwbare dekking en beschikbaarheid van telefoonnummers hebt. --- ## Overzicht Met SMS-berichten in de app kun je: - Verstuur en ontvang sms-berichten met contacten - Ontvang multimediaberichten (afbeeldingen, video's, documenten) via mms - Automatiseer antwoorden met een AI-agent - Voer sms-gebaseerde uitzendingen uit, inclusief bulkverzendingen - Beheer wettelijke naleving voor verschillende landen --- ## Hoe SMS werkt **Voor sms moet je je eigen Twilio-account koppelen.** Sms is in de meeste landen zwaar gereguleerd — denk aan **A2P 10DLC** in de VS (een registratiesysteem dat providers gebruiken om te bevestigen dat een bedrijf echt is wie het zegt te zijn, zodat berichten niet als spam worden geblokkeerd), merkregistratie in Australië, goedkeuring van afzender-ID's in Europa, enz. — en naleving moet op naam van de afzender van het bericht worden ingediend. Om die reden biedt het platform geen beheerde sms-nummers aan; je brengt je eigen Twilio-account mee, betaalt Twilio rechtstreeks voor nummers en per-berichtkosten, en het platform zorgt voor de routering, AI en de conversatielaag daarbovenop. Wat je krijgt zodra je verbinding hebt gemaakt: - **Wereldwijde dekking** in elk land dat Twilio ondersteunt - **Nummertypen** waaronder lokaal, mobiel en gratis nummers - **Ondersteuning voor inkomende mms** — media die een contactpersoon naar je stuurt, wordt opgeslagen in het gesprek (het verzenden van uitgaande mms wordt niet ondersteund; uitgaande sms is alleen tekst) - **Geen creditkosten van het platform voor sms-bezorging** — je betaalt alleen rechtstreeks de carrier-kosten per segment aan Twilio. Als een AI-agent het antwoord genereert, verbruikt dat AI-antwoord nog steeds AI-credits, net als bij elk ander kanaal. > **WhatsApp Business API is anders.** WhatsApp Business API-nummers kunnen worden uitgevoerd op het beheerde Twilio van het platform of op uw eigen Twilio. Als u uw eigen Anthropic-sleutel (BYOK) heeft 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 uw AI-credits-tarief, dus er is geen afzonderlijke toeslag per bericht. Zie [WhatsApp Business](whatsapp-business.md) voor dat pad. > **Verwar dit niet met de Twilio-accountkaart.** De pagina Kanalen heeft ook een aparte **Twilio-account**-kaart, verderop in de lijst onder **SMS via Twilio**. Deze schakelt uw via het platform gekochte **WhatsApp**-nummers over naar uw eigen Twilio-account en staat los van de sms-verbinding op deze pagina — het inschakelen hiervan heeft geen invloed op uw sms-nummer. Zie [SMS-provider](../settings/sms-provider.md) voor de volledige uitleg van die kaart. > **Geen Twilio? Gebruik je eigen Android-telefoon (bèta).** Voor kleinschalige, conversationele sms-berichten kun je Twilio volledig overslaan en sms'en via je eigen Android-telefoon en mobiele abonnement. Zie [Android-telefoon als sms-gateway](android-sms-gateway.md). Dit is het meest geschikt voor één-op-één antwoorden en AI-gesprekken — voor bulk-sms-uitzendingen is nog steeds Twilio vereist. --- ## Je Twilio-account koppelen 1. Klik in de linkerzijbalk onderaan op **Instellingen**. 2. Klik in de linkerzijbalk van Instellingen onder **Kanalen** op **Kanalen**. 3. Zoek de kaart **SMS via Twilio** en klik op **Verbinden**. (Op de pagina Kanalen staat deze kaart verderop in de lijst, onder Telegram, LINE en de andere kanaalkaarten.) Verbinden is een enkel formulier, geen wizard met meerdere stappen: 1. **Account SID** — plak deze vanuit je Twilio Console, onder **Account**. 2. **Auth Token** — plak deze vanaf dezelfde plek, onder **Account → API credentials**. Deze wordt gevalideerd door Twilio en daarna nooit meer aan je getoond. 3. **Telefoonnummer** — het voor sms geschikte nummer in je Twilio-account, in internationaal formaat (bijv. `+14155552671`). 4. Klik op **Connect Twilio**. De app valideert de inloggegevens en koppelt automatisch de inkomende webhook aan je Twilio-nummer — er is geen aparte stap voor het instellen van webhooks of het versturen van testberichten. Zodra de verbinding tot stand is gebracht, toont de kaart je nummer en een gemaskeerde Account SID, plus de acties **Bewerken** en **Verbinding verbreken**. Direct na het verbinden (of bewerken) wordt de webhook-URL die de app heeft geconfigureerd eenmalig getoond ter referentie — deze wordt niet opgeslagen, dus als je deze opnieuw wilt zien, klik je op **Bewerken** en voer je dezelfde inloggegevens opnieuw in. Waar je je Account SID en Auth Token kunt vinden: log in op [console.twilio.com](https://console.twilio.com). Beide staan op het hoofddashboard in het paneel **Account Info**. Je koopt en beheert sms-nummers rechtstreeks in de Twilio Console — het platform heeft geen eigen interface voor het aanschaffen van sms-nummers. > **Je kunt één Twilio-nummer tegelijk verbinden.** Om een ander nummer te gebruiken, klik je op **Bewerken** op de verbonden kaart en voer je de nieuwe inloggegevens in — het oude nummer wordt losgekoppeld en het nieuwe wordt geconfigureerd. ### SMS bijwerken of de verbinding verbreken Om je sms-nummer of Twilio-inloggegevens te wijzigen, open je **SMS via Twilio** op de pagina Kanalen, klik je op **Bewerken** en voer je alle drie de velden opnieuw in (Account SID, Auth Token en telefoonnummer — het formulier heeft altijd alle drie nodig, omdat het authenticatietoken nooit naar de browser wordt teruggestuurd om in te vullen). Om te stoppen met het gebruik van sms, klik je op **Verbinding verbreken**; hiermee wordt de inkomende webhook op je Twilio-nummer gewist en de verbinding verwijderd. Bestaande gesprekken worden niet verwijderd. --- ## SMS verzenden en ontvangen ### Berichten ontvangen Zodra je nummer actief is, worden inkomende SMS-berichten automatisch naar het platform doorgestuurd: 1. Een contactpersoon stuurt een sms naar je telefoonnummer. 2. Het bericht verschijnt in realtime in **Chats**. 3. Er wordt automatisch een nieuw contact aangemaakt als dit het eerste bericht van die afzender is. 4. Als een AI-agent het relevante gesprek afhandelt, reageert deze automatisch. ### Berichten verzenden - **Handmatig antwoord:** Open een gesprek in Chats en typ uw antwoord. - **Uitzendingen:** Stel een bulk-SMS-uitzending in om contacten op grote schaal te bereiken — SMS wordt volledig ondersteund als uitgaand kanaal, net als WhatsApp. Zie [Uitzendingen](../broadcasts/broadcasts.md). - **AI-agent:** Wijs een agent toe om automatisch op inkomende berichten te reageren. - **Geplande berichten:** Plan berichten in om op een specifiek tijdstip te worden verzonden. ### MMS (Multimedia-berichten) SMS-nummers ondersteunen **inkomende** MMS, dus wanneer een contactpersoon je media stuurt, wordt dit opgeslagen in het gesprek: - Afbeeldingen (JPEG, PNG, GIF) - Video's (MP4) - Audiobestanden - Documenten (PDF) Media-bijlagen worden automatisch opgeslagen en zijn toegankelijk in de gespreksweergave. **Het verzenden** van uitgaande mms vanuit het platform wordt momenteel niet ondersteund — uitgaande sms is alleen tekst. ::: note **Let op:** De beschikbaarheid van inkomende mms varieert per land en provider. Mms wordt breed ondersteund in de VS en Canada, maar kan elders beperkte ondersteuning hebben. ::: --- ## Een 'Klik-om-te-sms'en'-link toevoegen aan je website Er is geen zwevende sms-widget zoals voor WhatsApp, maar je kunt nog steeds een knop of link op je website (of in een e-mail, QR-code, enz.) plaatsen die de berichten-app van de bezoeker opent met jouw nummer al ingevuld. Dit maakt gebruik van een eenvoudige `sms:`-link. Het formaat is: ``` sms:+NUMBER ``` Gebruik je nummer in internationaal formaat, inclusief het plusteken. Bijvoorbeeld: ``` sms:+15551234567 ``` ### Op een knop plaatsen Koppel een knop of tekst aan dat adres: ```html Text us ``` In een websitebouwer (Wix, Squarespace, WordPress, Webflow, enz.), voeg je zoals gebruikelijk een knop toe en plak je `sms:+15551234567` in het veld voor de "link" / "URL". ### Een bericht vooraf invullen Je kunt het bericht dat de bezoeker gaat sturen vooraf invullen. iPhone en Android verwachten dit op een iets andere manier, dus gebruik deze gecombineerde vorm om beide te dekken: ``` sms:+15551234567?&body=Hi!%20I%20have%20a%20question ``` Spaties in het bericht moeten worden geschreven als `%20`. > **Goed om te weten.** > - Klik-om-te-sms-links werken alleen op een apparaat dat een sms-app heeft — ze werken op telefoons, maar op een desktopcomputer gebeurt er meestal niets als je op de link klikt. > - Deze links openen de **eigen** sms-app van de bezoeker; het eerste bericht komt van het telefoonnummer van de bezoeker, niet van dat van jou. De conversatie verschijnt vervolgens in Chats zoals elk ander inkomend sms-bericht zodra ze op verzenden drukken. > - Vermijd het plaatsen van een `sms:` link **in een sms die je verstuurt** — de meeste telefoons maken deze niet aanklikbaar. Ze werken het beste op webpagina's, in e-mails en in QR-codes. --- ## Spraakoproepen naar je sms-nummer Spraakoproepen naar je gekoppelde Twilio-sms-nummer worden volledig afgehandeld door je eigen Twilio-account — het platform installeert geen voicemailbegroeting, opname of transcriptie op nummers die je zelf toevoegt. Als je voicemail wilt op je sms-nummer, configureer dit dan in je Twilio Console. ::: note **Let op:** De geautomatiseerde voicemail van het platform is alleen van toepassing op nummers die via het platform voor WhatsApp zijn gekocht, niet op de Twilio-nummers die u koppelt voor sms. ::: --- ## Naleving van regelgeving SMS-regelgeving wordt rechtstreeks afgehandeld via Twilio in uw eigen account. Het platform dient namens u geen nalevingsdocumenten in voor SMS — dit moet op naam van uw bedrijf gebeuren. Veelvoorkomende vereisten: - **A2P 10DLC** (Verenigde Staten) — registreer uw merk en campagne bij The Campaign Registry via Twilio voordat u berichten naar Amerikaanse nummers verstuurt. - **Toll-Free verificatie** (Verenigde Staten en Canada) — vereist voor het versturen van gratis SMS-berichten. - **Sender ID-registratie** (groot deel van Europa, Midden-Oosten, Azië-Pacific) — Twilio handelt het indieningsproces af. - **Identiteitsdocumenten** (gereguleerde landen zoals Duitsland, Frankrijk, India, enz.) — te uploaden in uw Twilio Console bij het kopen van een nummer. Als je account een formeel wettelijk pakket vereist (Amerikaans gratis nummer, Brits mobiel nummer, en dergelijke), start en volgt de kaart **Naleving van regelgeving** op de pagina Kanalen die indiening bij Twilio. Zie [Twilio's richtlijnen voor regelgeving](https://www.twilio.com/docs/messaging/compliance) voor het volledige overzicht per land. ### Best practices voor naleving van berichtgeving - **Verkrijg toestemming** voordat je sms-berichten naar contacten verstuurt. Dit is in de meeste rechtsgebieden wettelijk verplicht (TCPA in de VS, AVG in Europa, enz.). - **Voeg afmeldinstructies toe** in verzonden berichten (bijv. "Antwoord STOP om je af te melden"). - **Respecteer afmeldverzoeken** onmiddellijk. - **Identificeer jezelf** in berichten — ontvangers moeten weten wie er contact met hen opneemt. - **Volg de lokale regelgeving** voor de landen waar je contacten zich bevinden. --- ## Probleemoplossing ### Berichten worden niet afgeleverd - Controleer of het telefoonnummer van de ontvanger de juiste internationale indeling heeft (bijv. +1234567890). - Controleer of uw Twilio-account een positief saldo heeft en of de gekoppelde inloggegevens nog geldig zijn. - Zorg ervoor dat het nummer niet is gedeactiveerd of vrijgegeven in uw Twilio Console. - Controleer de berichtstatus in de gespreksweergave voor foutdetails — Twilio-foutcodes worden direct weergegeven en elk daarvan wordt uitgelegd in het [Error Log](../settings/error-log.md#sms-twilio). - Sommige landen blokkeren berichten van buitenlandse nummers — koop een lokaal Twilio-nummer voor dat land. ### Nummer verstuurt of ontvangt niet - Bevestig dat het nummer actief is in je Twilio Console. - Bevestig dat de Twilio-inloggegevens die op de pagina **Kanalen** zijn gekoppeld, nog steeds overeenkomen met het account dat het nummer bezit. - Bevestig voor gereguleerde landen dat A2P 10DLC, afzender-ID of andere stappen voor Twilio-naleving zijn voltooid. ### MMS werkt niet - Bevestig dat MMS wordt ondersteund in het land van de ontvanger. - Controleer of de bestandsgrootte binnen de limieten valt (meestal 5 MB voor MMS). - Controleer of het bestandsformaat wordt ondersteund (JPEG, PNG, GIF, MP4, PDF). ### Ontvang geen inkomende berichten - Stuur een test-sms naar je telefoonnummer vanaf je persoonlijke telefoon. - Controleer of het nummer als verbonden wordt weergegeven op de pagina Kanalen. - Als het probleem aanhoudt, probeer dan het nummer opnieuw te koppelen via de kaart 'SMS via Twilio' — het platform voert de technische configuratie automatisch opnieuw uit. --- ## Best practices - **Gebruik lokale nummers** voor de landen waar je contacten zijn gevestigd. Berichten van lokale nummers hebben een hoger vertrouwen en hogere afleverpercentages. - **Houd berichten beknopt.** SMS heeft een limiet van 160 tekens per segment. Langere berichten worden opgesplitst in meerdere segmenten, wat de kosten verhoogt. - **Vertrouw niet op emoji's of speciale symbolen.** Om elk sms-bericht tot één (goedkoper) segment te beperken, schoont het platform uitgaande tekst automatisch op voor standaard sms-codering: emoji's worden verwijderd en krulquotes, gedachtestreepjes, weglatingstekens en soortgelijke tekens worden omgezet naar hun standaardequivalenten. Tekens buiten de standaard sms-set worden verwijderd, dus ze zullen niet in de sms verschijnen. - **Plan je berichten op het juiste moment.** Vermijd het versturen van berichten buiten kantooruren in de tijdzone van de ontvanger. - **Monitor afleverpercentages.** Als je een slechte aflevering in bepaalde regio's opmerkt, overweeg dan om een lokaal nummer voor dat land aan te schaffen om het vertrouwen en de afleverbaarheid te verbeteren. - **Wijs een AI-agent toe** om snel op inkomende berichten te reageren, vooral buiten kantooruren.