SIP-trunk configureren voor Twilio BYOC Trunking

Stap-voor-stap handleiding voor het koppelen van een OpVoIP SIP-trunk aan Twilio via BYOC Trunking: Origination en Termination instellen, IP-ranges en codecs, afzendernummers aanmelden en de meest voorkomende foutmeldingen.

BYOC Trunking versus Elastic SIP Trunking

Twilio kent twee manieren om SIP-trunks te koppelen. Elastic SIP Trunking is bedoeld voor wie zijn telefoonnummers rechtstreeks bij Twilio afneemt. BYOC Trunking (Bring Your Own Carrier) is het product voor de situatie waarin het nummer bij een externe provider blijft — in dit geval OpVoIP — en u Twilio Programmable Voice, een IVR of een uitgaande belmodule bovenop die trunk bouwt.

Een BYOC-trunk kent twee richtingen, en Twilio gebruikt de termen omgekeerd aan wat in de markt gebruikelijk is:

Twilio-term	Praktische richting
BYOC Termination	Verkeer van OpVoIP naar Twilio — inkomende gesprekken op uw nummer
BYOC Origination	Verkeer van Twilio naar OpVoIP — uitgaande gesprekken met uw nummer als CLI

Wat u nodig heeft

• Een Twilio-account met toegang tot BYOC Trunking
• Een bij OpVoIP afgenomen (of aangevraagde) SIP-trunk met telefoonnummer
• Het SIP-endpoint en de accountgegevens die u van OpVoIP ontvangt bij de aanvraag

Stap 1 — BYOC Trunk aanmaken in Twilio

1. Ga in de Twilio Console naar Elastic SIP Trunking → BYOC Trunks
2. Klik op Create new BYOC Trunk
3. Geef de trunk een herkenbare naam, bijvoorbeeld opvoip-byoc

Stap 2 — Termination: inkomend verkeer naar Twilio

Voor inkomende gesprekken (OpVoIP → Twilio) stelt u een Twilio SIP-domein in en levert u dat aan OpVoIP als bestemming:

Veld	Waarde	Toelichting
Termination SIP Domain	uwbedrijf.sip.dublin.twilio.com	Kies de EU-edge Dublin; subdomeinen zijn wereldwijd uniek
IP Access Control List	SIP-bron-IP van OpVoIP	Ontvangt u bij de aanvraag — wordt in Twilio toegevoegd zodat alleen OpVoIP verkeer mag aanleveren
Bestemming voor OpVoIP	sip:+31UWNUMMER@uwbedrijf.sip.dublin.twilio.com	Dit adres geeft u aan OpVoIP door als terminatiebestemming

Stap 3 — Origination: uitgaand verkeer naar OpVoIP

Voor uitgaande gesprekken (Twilio → OpVoIP) maakt u een Origination Connection Policy aan die naar het SIP-endpoint van OpVoIP wijst:

Veld	Waarde	Toelichting
Origination URI	sip:[opvoip-sbc-endpoint]:5060	Ontvangt u van OpVoIP bij de aanvraag
Priority / Weight	10 / 10	Eén actief target; bij meerdere targets bepaalt dit de volgorde
Authenticatie	IP-gebaseerd	BYOC Origination ondersteunt geen registratie of digest-auth — de carrier moet Twilio op bron-IP vertrouwen

Stap 4 — Twilio-signaleringsranges toestaan

Twilio's uitgaande signalering komt niet uit één vast IP-adres. Sta bij uw eigen SBC-configuratie (of laat OpVoIP dit doen) de volgende ranges toe op poort 5060 (UDP/TCP) en 5061 (TLS):

Regio	IP-range
Dublin (EU, primair)	54.171.127.192/30
Frankfurt (EU, uitwijk)	35.156.191.128/30
Virginia (uitwijk)	54.172.60.0/30
Oregon (uitwijk)	54.244.51.0/30

Sta bij voorkeur alle vier de ranges toe. De uitgaande edge van Twilio is niet gegarandeerd de regio die u als primair heeft ingesteld.

Stap 5 — RTP media-range toestaan

Signalering en media lopen bij Twilio over gescheiden bereiken. Naast de signaleringsranges uit stap 4 moet ook de media-range open staan:

Verkeer	Range
RTP-media (Twilio)	168.86.128.0/18, UDP 10000–60000

Filtert uw SBC media op dezelfde bron als de signalering, dan komt het gesprek wel tot stand (INVITE en 200 OK gaan goed) maar blijft de audio in één of beide richtingen weg. Dat oogt als een codec- of NAT-probleem, maar is in de praktijk vaak deze ontbrekende media-range.

Stap 6 — Codecs en DTMF

Instelling	Waarde
Codecs	G.711 (PCMA/PCMU) — standaard op BYOC-trunks
DTMF	RFC 2833 / telephone-event
Transport (eerste test)	UDP/5060, TLS/SRTP na een geslaagde basistest

G.729, Opus en AMR-NB zijn op BYOC-trunks "Limited Availability" en moeten per account door Twilio worden vrijgeschakeld.

Stap 7 — Afzendernummer (CLI) aanmelden

Elk telefoonnummer dat u als CLI via de koppeling gebruikt, meldt u vooraf bij OpVoIP aan — dit voorkomt zowel spoofing als foutieve facturatie. Vermeld daarbij:

• het afzendernummer in E.164-formaat, bijvoorbeeld +3185…
• de gewenste ingangsdatum
• de naam van de organisatie of klant waarvoor het nummer wordt gebruikt
• indien beschikbaar: het bijbehorende klant- of offertenummer

Bij complete gegevens, ontvangen op een werkdag, hanteert OpVoIP een doorlooptijd van maximaal één werkdag. Wij bevestigen per e-mail zodra het nummer actief op de koppeling staat — neem het pas dan in productie, gezien de fallback naar Twilio's eigen route uit stap 3.

Stap 8 — Testgesprek en verificatie

1. Voer na bevestiging een testgesprek uit: inkomend op uw nummer, en uitgaand met uw nummer als CLI
2. Controleer in Twilio's call-logging of er een BYOC-gerelateerde foutmelding verschijnt (zie tabel hieronder) — geen foutmelding is een eerste goed teken
3. Vraag OpVoIP het testgesprek naast onze eigen SIP-logging te leggen, zodat aantoonbaar is dat het gesprek daadwerkelijk via de trunk liep en niet via een fallback-route

Veelvoorkomende meldingen

Melding	Betekenis	Meest voorkomende oorzaak
32401 — BYOC Trunk routing failure, failover to Twilio default routing	De sessie naar uw Origination-target kwam niet tot stand; Twilio heeft het gesprek daarna via zijn eigen route afgeleverd	Het bron-IP van Twilio (stap 4) staat nog niet toe op de ontvangende SBC, of de trunk-matching aan de ontvangende kant herkent het verkeer niet
403 Forbidden bij inkomend verkeer	De ontvangende SBC wijst de sessie direct af	Het werkelijke bron-IP van de INVITE (kan per regio verschillen, zie stap 4) staat niet in de IP-ACL
Gesprek komt tot stand, maar geen audio	Signalering slaagt, media niet	RTP media-range (stap 5) niet toegestaan, of NAT-instelling op de ontvangende SBC