Gebruik je eigen nummers (VoIP, API)

Demonummers zijn prima voor prototyping, maar productieoproepen moeten nummers gebruiken die je via je eigen VoIP-provider bezit. Deze gids leidt je door de workflow in drie stappen: inloggegevens testen → verbinding maken → nummers importeren → verifiëren.

Het dashboard heeft een begeleide versie van deze volledige workflow onder Verbindingen → VoIP (/dashboard/voip-connections): een begeleide Telnyx-configuratie die je door het aanmaken van een account en API-sleutels leidt, een optie om een bestaand account te verbinden en een handmatig SIP-formulier met een AI-generator voor configuratiehandleidingen.

Ondersteunde providers

Provider	`provider` id	Opmerkingen
Twilio	`twilio`	API-sleutel + geheim
Telnyx	`telnyx`	API-sleutel; begeleide onboarding beschikbaar (`setup_method: guided_telnyx`)
SignalWire	`signalwire`	Binnenkort beschikbaar — verbind vandaag via Handmatige SIP
Vonage	`vonage`	Binnenkort beschikbaar — verbind vandaag via Handmatige SIP
Handmatige SIP	`manual`	Elke SIP-trunk — gebruik je eigen configuratie

1. Inloggegevens testen

Voordat je een opgeslagen VoIP-verbinding maakt, test je de inloggegevens van de provider om te bevestigen dat ze werken. Dit retourneert een verification_evidence_id die je aan de maakstap doorgeeft, zodat er geen dubbele kosten voor het testen van de inloggegevens worden berekend.

curl -X POST https://api.thunderphone.com/v1/voip-connections/test \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider":    "telnyx",
    "credentials": { "apiKey": "KEY...", "connectionId": "123456" },
    "sip_config":  { "domain": "acme.sip.telnyx.com" }
  }'

Response

{
  "status": "pass",
  "verification_evidence_id": "b9a2...",
  "suggested_connection_name": "Telnyx: Acme Main (+15550001234)",
  "checks": {
    "credentials_valid": true,
    "inbound_reachable": true,
    "outbound_authorized": true
  }
}

Als een controle mislukt, is de status van het antwoord fail en toont checks welke stap is mislukt. Los de configuratie bij de provider op (trunktoewijzing, IP-allowlist, uitgaande autorisatie) en probeer opnieuw.

2. De verbinding maken

Geef de verification_evidence_id door die je zojuist hebt ontvangen:

curl -X POST https://api.thunderphone.com/v1/voip-connections \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":         "Acme Telnyx Main",
    "provider":     "telnyx",
    "setup_method": "api_key",
    "credentials":  { "apiKey": "KEY...", "connectionId": "123456" },
    "sip_config":   { "domain": "acme.sip.telnyx.com" },
    "verification_evidence_id": "b9a2..."
  }'

Het antwoord is een VoipConnection-object met status="connected". Inloggegevens worden server-side opgeslagen en worden nooit als platte tekst teruggegeven door latere GET-aanvragen — voer om ze te vernieuwen een nieuwe test uit en gebruik PATCH met het nieuwe bewijs.

3. Nummers weergeven en importeren

Bekijk de nummers die beschikbaar zijn voor je inloggegevens en nog niet in een ThunderPhone-organisatie staan:

curl https://api.thunderphone.com/v1/voip-connections/5/available-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Importeer vervolgens de nummers die je wilt:

curl -X POST https://api.thunderphone.com/v1/voip-connections/5/import-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numbers": ["+15550001234", "+15550009999"]}'

Elke import wordt een telefoonnummerresource in je organisatie met source="voip" en status="provisioning".

4. Verifieer elk geïmporteerd nummer

Importeren registreert het nummer als beschikbaar; oproepen er daadwerkelijk via routeren vereist verificatie in twee richtingen (controle van inkomend inbellen + autorisatiecontrole voor uitgaande oproepen).

curl -X POST https://api.thunderphone.com/v1/phone-numbers/{id}/verify-voip \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Bij succes verandert voip_verification_status in verified en krijgt het nummer status="active". Bij een fout vermeldt het antwoord precies wat er is mislukt — los dit op (vaak een ontbrekende trunktoewijzing in het providerdashboard) en roep de endpoint opnieuw aan.

5. Wijs agenten toe en neem een oproep aan

Nadat het nummer is geverifieerd, wijs je inkomende / uitgaande agenten op dezelfde manier toe als bij een demonummer. Zie Inkomende oproepen afhandelen en Uitgaande oproepen plaatsen.

Credentials roteren

Wanneer een providersleutel roteert, voer je de test-en-updateprocedure opnieuw uit:

# 1. Test the new credentials
curl -X POST https://api.thunderphone.com/v1/voip-connections/test ...

# 2. PATCH the connection with the new evidence
curl -X PATCH https://api.thunderphone.com/v1/voip-connections/{id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "credentials": { "apiKey": "NEW_KEY..." },
    "verification_evidence_id": "fresh-evidence-id"
  }'

De verbinding blijft bestaan — je hoeft nummers niet opnieuw te importeren.

Volgende stappen

Referentie voor VoIP-verbindingen

Elk veld in de antwoorden voor verbindingen, verificatiebewijzen en importen.

Referentie voor telefoonnummers

Wijs agenten toe, draag over tussen organisaties, geef nummers vrij.

Uitgaande oproepen plaatsen

Nu je eigenaar bent van het nummer, kun je uitgaande oproepen plaatsen.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Gebruik je eigen nummers (VoIP, API)

Ondersteunde providers

1. Inloggegevens testen

2. De verbinding maken

3. Nummers weergeven en importeren

4. Verifieer elk geïmporteerd nummer

5. Wijs agenten toe en neem een oproep aan

Credentials roteren

Volgende stappen

Referentie voor VoIP-verbindingen

Referentie voor telefoonnummers

Uitgaande oproepen plaatsen

​Ondersteunde providers

​1. Inloggegevens testen

​2. De verbinding maken

​3. Nummers weergeven en importeren

​4. Verifieer elk geïmporteerd nummer

​5. Wijs agenten toe en neem een oproep aan

​Credentials roteren

​Volgende stappen

Referentie voor VoIP-verbindingen

Referentie voor telefoonnummers

Uitgaande oproepen plaatsen

Ondersteunde providers

1. Inloggegevens testen

2. De verbinding maken

3. Nummers weergeven en importeren

4. Verifieer elk geïmporteerd nummer

5. Wijs agenten toe en neem een oproep aan

Credentials roteren

Volgende stappen