Bruk dine egne numre (VoIP, API)

Demonumre er fine for prototyping, men produksjonstrafikk bør bruke numre du eier gjennom din egen VoIP-leverandør. Denne veiledningen går gjennom flyten i tre trinn: test tilgangsopplysninger → opprett tilkobling → importer numre → verifiser.

Kontrollpanelet har en veiledet versjon av hele denne flyten under Tilkoblinger → VoIP (/dashboard/voip-connections): et veiledet Telnyx-oppsett som går gjennom kontoopprettelse og API-nøkler, en flyt for å koble til en eksisterende konto, og et manuelt SIP-skjema med en AI-generator for oppsettsveiledning.

Støttede leverandører

Leverandør	`provider` id	Merknader
Twilio	`twilio`	API-nøkkel + hemmelighet
Telnyx	`telnyx`	API-nøkkel; veiledet oppstart tilgjengelig (`setup_method: guided_telnyx`)
SignalWire	`signalwire`	Kommer snart — koble til via manuell SIP i dag
Vonage	`vonage`	Kommer snart — koble til via manuell SIP i dag
Manuell SIP	`manual`	Enhver SIP-trunk — bruk din egen konfigurasjon

1. Test tilgangsopplysninger

Før du oppretter en vedvarende VoIP-tilkobling, test leverandørens tilgangsopplysninger for å bekrefte at de fungerer. Dette returnerer en verification_evidence_id som du sender til opprettingstrinnet, slik at tilgangsopplysningene ikke belastes dobbelt for testing.

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
  }
}

Hvis en kontroll feiler, vil responsens status være fail, og checks viser hvilket trinn som feilet. Rett opp konfigurasjonen hos leverandøren (trunktilordning, IP-tillatelsesliste, utgående autorisasjon), og prøv på nytt.

2. Opprett tilkoblingen

Send inn verification_evidence_id du nettopp fikk:

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..."
  }'

Responsen er et VoipConnection-objekt med status="connected". Tilgangsopplysninger lagres på serversiden og returneres aldri i klartekst av påfølgende GET-forespørsler — for å rotere dem, kjør en ny test og PATCH med den nye verifiseringen.

3. List opp og importer numre

Se numrene som tilgangsopplysningene dine gir tilgang til, og som ikke allerede finnes i en ThunderPhone-organisasjon:

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

Importer deretter numrene du ønsker:

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"]}'

Hver import blir en telefonnummerressurs i organisasjonen din med source="voip" og status="provisioning".

4. Verifiser hvert importerte nummer

Importeringen registrerer nummeret som tilgjengelig; for faktisk å rute samtaler gjennom det må du gjennomføre en verifisering tur-retur (sjekk av innkommende oppringing + autorisasjonskontroll for utgående samtaler).

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

Ved suksess endres voip_verification_status til verified, og nummeret får status="active". Ved feil forklarer svaret hva som feilet — rett det (ofte manglende trunk-tilordning i leverandørens kontrollpanel) og prøv igjen.

5. Tilordne stemmeagenter og ta imot en samtale

Når nummeret er verifisert, tilordner du stemmeagenter for innkommende / utgående samtaler på samme måte som for et demonummer. Se Håndter innkommende samtaler og Foreta utgående samtaler.

Roterende påloggingsopplysninger

Når en leverandørnøkkel roteres, kjører du test-og-oppdater-flyten på nytt:

# 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"
  }'

Tilkoblingen blir værende — du trenger ikke importere numrene på nytt.

Neste trinn

Referanse for VoIP-tilkoblinger

Alle felt i svarene for tilkobling, bevis og import.

Referanse for telefonnumre

Tilordne stemmeagenter, overfør mellom organisasjoner, frigi numre.

Foreta utgående samtaler

Nå som du eier nummeret, kan du begynne å ringe utgående samtaler.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Bruk dine egne numre (VoIP, API)

Støttede leverandører

1. Test tilgangsopplysninger

2. Opprett tilkoblingen

3. List opp og importer numre

4. Verifiser hvert importerte nummer

5. Tilordne stemmeagenter og ta imot en samtale

Roterende påloggingsopplysninger

Neste trinn

Referanse for VoIP-tilkoblinger

Referanse for telefonnumre

Foreta utgående samtaler

​Støttede leverandører

​1. Test tilgangsopplysninger

​2. Opprett tilkoblingen

​3. List opp og importer numre

​4. Verifiser hvert importerte nummer

​5. Tilordne stemmeagenter og ta imot en samtale

​Roterende påloggingsopplysninger

​Neste trinn

Referanse for VoIP-tilkoblinger

Referanse for telefonnumre

Foreta utgående samtaler

Støttede leverandører

1. Test tilgangsopplysninger

2. Opprett tilkoblingen

3. List opp og importer numre

4. Verifiser hvert importerte nummer

5. Tilordne stemmeagenter og ta imot en samtale

Roterende påloggingsopplysninger

Neste trinn