# Telefoon (SMS)

Configureer de gateway die eenmalige codes per sms of spraakoproep aflevert (de ingebouwde gateway, Twilio of een aangepaste HTTP-gateway).

Requires: customSmsGateway

> **Plan-opmerking:** Een aangepaste sms-gateway is beschikbaar vanaf het Essential-plan. Zie [Plans & add-ons](https://dts-identity.com/nl/docs/getting-started/plans-and-addons.md). Op lagere niveaus verstuurt het platform eenmalige codes via de ingebouwde gateway.

Het platform levert eenmalige codes per sms af voor telefoongebaseerde [meervoudige verificatie](https://dts-identity.com/nl/docs/security/multi-factor-authentication.md) en voor de verificatie van telefoonnummers. Een ingebouwde gateway werkt direct; vanaf het Essential-plan kunt u deze berichten via uw eigen provider laten verlopen.

[Image: Het tabblad Telefoon van de branding-instellingen]

## Een gateway kiezen

1. Open in de Admin Console **Branding → Telefoon**.
2. Selecteer een provider:
   - **Ingebouwde gateway**: de standaarddienst. Geen configuratie nodig.
   - **Twilio**: verstuur via uw Twilio-account.
   - **Aangepaste gateway**: verstuur via een willekeurige HTTP-sms-API.
3. Configureer de velden voor uw keuze (zie hieronder) en selecteer **Wijzigingen opslaan**.

## Twilio

Geef uw Twilio-**Account SID** en **Auth-token** op en kies vervolgens hoe berichten worden verzonden:

- **Afzender**: een **Afzendernummer** of een **Messaging Service SID**. Een Messaging Service geldt voor tekstberichten; spraakoproepen gebruiken altijd een afzendernummer.
- **Afleveringsmethoden**: lever de code af als **tekstbericht (sms)**, als **spraakoproep** of beide.

## Aangepaste gateway

Laat het platform verwijzen naar een willekeurige HTTP-sms-API:

- **Gateway-URL** en **HTTP-methode** (GET of POST).
- Voor POST een **body-indeling** (JSON, form-encoded of raw) en een sjabloon voor de **request body**. Voor raw bodies kunt u het **Content-Type** instellen.
- **Aangepaste headers**: één `Name: value` per regel, handig voor een `Authorization`-header.
- **Gebruikersnaam**, **wachtwoord** en een **Auth-token** voor gateways die deze vereisen.

De URL, de request body en de headers ondersteunen placeholders die bij het verzenden worden vervangen, waaronder het nummer van de ontvanger en de berichttekst, bijvoorbeeld `https://api.example.com/send?to={{to}}&text={{message}}` of een header zoals `Authorization: Bearer {{authToken}}`.

## Geheime velden

Gevoelige waarden zoals het Twilio Auth-token en het wachtwoord en Auth-token van de aangepaste gateway worden veilig opgeslagen en nooit vooraf ingevuld. **Laat een geheim veld leeg om de huidige waarde te behouden**; voer alleen een nieuwe waarde in wanneer u deze wilt wijzigen.

## Berichtinhoud

De tekst van het codebericht komt uit de ingebouwde, vertaalde formulering van het platform; deze wordt niet op deze pagina bewerkt. De inhoud wordt bepaald door de gelokaliseerde taalteksten van de instantie, zodat de taal van het bericht de landinstelling van de gebruiker (of van de instantie) volgt in plaats van een editor per sjabloon.

## Bescherming tegen misbruik

Uitgaande sms-berichten zijn per gebruiker in aantal beperkt, zodat één account geen onbeperkt aantal berichten kan activeren. Dit beschermt u tegen onbedoelde lussen en opzettelijk misbruik die anders de afleveringskosten zouden opdrijven.

## Probleemoplossing

- **Codes komen niet aan**: controleer of de gateway-inloggegevens correct zijn, sla opnieuw op en test de flow opnieuw. Houd er rekening mee dat geheime velden na het opslaan bewust leeg zijn; dat betekent niet dat de waarde is gewist.
- **Twilio-spraak maar geen nummer**: een Messaging Service SID dekt alleen sms; voeg een afzendernummer toe om aflevering per spraakoproep in te schakelen.
- **Aangepaste gateway geeft een fout terug**: controleer of de URL, HTTP-methode, body-indeling en placeholders overeenkomen met wat uw provider verwacht.
