> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bruk dine egne numre (VoIP, API)

> Koble til Twilio eller Telnyx – eller en hvilken som helst SIP-trunk – og importer telefonnumre fra din eksisterende konto.

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**.

<Note>
  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.
</Note>

## 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.

```bash theme={null}
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" }
  }'
```

```json Response theme={null}
{
  "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:

```bash theme={null}
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](/api-reference/voip-connections#connection-object)
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:

```bash theme={null}
curl https://api.thunderphone.com/v1/voip-connections/5/available-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Importer deretter numrene du ønsker:

```bash theme={null}
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](/api-reference/phone-numbers)
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).

```bash theme={null}
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](/nb/guides/handle-inbound-calls) og
[Foreta utgående samtaler](/nb/guides/place-outbound-calls).

## Roterende påloggingsopplysninger

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

```bash theme={null}
# 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

<CardGroup cols={2}>
  <Card title="Referanse for VoIP-tilkoblinger" icon="phone-volume" href="/api-reference/voip-connections">
    Alle felt i svarene for tilkobling, bevis og import.
  </Card>

  <Card title="Referanse for telefonnumre" icon="phone" href="/api-reference/phone-numbers">
    Tilordne stemmeagenter, overfør mellom organisasjoner, frigi numre.
  </Card>

  <Card title="Foreta utgående samtaler" icon="arrow-up-right" href="/nb/guides/place-outbound-calls">
    Nå som du eier nummeret, kan du begynne å ringe utgående samtaler.
  </Card>
</CardGroup>