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

# Pievienojiet savus numurus (VoIP, API)

> Pievienojiet Twilio vai Telnyx — vai jebkuru SIP maģistrāli — un importējiet tālruņa numurus no sava esošā konta.

Demonstrācijas numuri ir piemēroti prototipēšanai, taču ražošanas datplūsmai jāizmanto numuri, kas jums pieder, izmantojot savu VoIP pakalpojumu sniedzēju. Šajā ceļvedī aprakstīta trīs soļu plūsma: **testēt akreditācijas datus → izveidot savienojumu → importēt numurus → verificēt**.

<Note>
  Informācijas panelī ir šīs visas plūsmas vadītā versija sadaļā
  **Savienojumi → VoIP** (`/dashboard/voip-connections`): Telnyx
  vadītā iestatīšana, kas palīdz izveidot kontu un iestatīt API atslēgas,
  ceļš esoša konta pievienošanai un manuāla SIP veidlapa ar AI
  iestatīšanas ceļveža ģeneratoru.
</Note>

## Atbalstītie pakalpojumu sniedzēji

| Pakalpojumu sniedzējs | `provider` id | Piezīmes                                                               |
| --------------------- | ------------- | ---------------------------------------------------------------------- |
| Twilio                | `twilio`      | API atslēga + slepenā atslēga                                          |
| Telnyx                | `telnyx`      | API atslēga; pieejama vadītā ieviešana (`setup_method: guided_telnyx`) |
| SignalWire            | `signalwire`  | **Drīzumā** — pašlaik pievienojiet, izmantojot manuālo SIP             |
| Vonage                | `vonage`      | **Drīzumā** — pašlaik pievienojiet, izmantojot manuālo SIP             |
| Manuālais SIP         | `manual`      | Jebkurš SIP maģistrālais savienojums — izmantojiet savu konfigurāciju  |

## 1. Testējiet akreditācijas datus

Pirms izveidojat pastāvīgu VoIP savienojumu, pārbaudiet pakalpojumu sniedzēja
akreditācijas datus, lai apstiprinātu, ka tie darbojas. Tādējādi tiek atgriezts
`verification_evidence_id`, ko nododat izveides solim, lai par akreditācijas
datu testēšanu netiktu iekasēta maksa divreiz.

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

Ja kāda pārbaude neizdodas, atbildes `status` būs `fail`, un `checks`
norādīs, kurā solī radās kļūda. Izlabojiet pakalpojumu sniedzēja puses konfigurāciju
(maģistrāles piešķiršanu, IP atļauju sarakstu, izejošo zvanu autorizāciju) un mēģiniet vēlreiz.

## 2. Izveidojiet savienojumu

Nododiet tikko iegūto `verification_evidence_id`:

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

Atbilde ir [VoipConnection objekts](/api-reference/voip-connections#connection-object)
ar `status="connected"`. Akreditācijas dati tiek glabāti servera pusē un turpmākajos
GET pieprasījumos nekad netiek atgriezti atklātā tekstā — lai tos rotētu, veiciet jaunu
`test` un PATCH pieprasījumu ar jaunajiem pierādījumiem.

## 3. Uzskaitiet un importējiet numurus

Pārskatiet numurus, kas ir pieejami jūsu akreditācijas datiem un vēl neatrodas
ThunderPhone organizācijā:

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

Pēc tam importējiet vajadzīgos numurus:

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

Katrs imports kļūst par [tālruņa numura resursu](/api-reference/phone-numbers)
jūsu organizācijā ar `source="voip"` un `status="provisioning"`.

## 4. Pārbaudiet katru importēto numuru

Importēšana reģistrē numuru kā *pieejamu*; lai faktiski maršrutētu zvanus
caur to, nepieciešama pilna pārbaude (ienākošā zvana pārbaude +
izejošo zvanu autorizācijas pārbaude).

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

Veiksmīgas pārbaudes gadījumā `voip_verification_status` tiek mainīts uz `verified`, un
numurs iegūst `status="active"`. Neveiksmīgas pārbaudes gadījumā atbilde norāda,
kas neizdevās — izlabojiet to (bieži vien pakalpojumu sniedzēja
informācijas panelī trūkst tranka piešķīruma) un izsauciet vēlreiz.

## 5. Piešķiriet balss aģentus un veiciet zvanu

Kad numurs ir pārbaudīts, ienākošo / izejošo zvanu balss aģentus piešķiriet
tāpat kā demonstrācijas numuram. Skatiet
[Apstrādājiet ienākošos zvanus](/lv/guides/handle-inbound-calls) un
[Veiciet izejošos zvanus](/lv/guides/place-outbound-calls).

## Piekļuves datu rotācija

Kad tiek nomainīta pakalpojumu sniedzēja atslēga, atkārtoti palaidiet pārbaudes un pēc tam atjaunināšanas procesu:

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

Savienojums paliek spēkā — numuri nav jāimportē atkārtoti.

***

## Nākamās darbības

<CardGroup cols={2}>
  <Card title="VoIP savienojumu atsauce" icon="phone-volume" href="/api-reference/voip-connections">
    Visi lauki savienojuma, pierādījumu un importēšanas atbildēs.
  </Card>

  <Card title="Tālruņa numuru atsauce" icon="phone" href="/api-reference/phone-numbers">
    Piešķiriet balss aģentus, pārsūtiet starp organizācijām, atbrīvojiet numurus.
  </Card>

  <Card title="Veiciet izejošos zvanus" icon="arrow-up-right" href="/lv/guides/place-outbound-calls">
    Tagad, kad numurs pieder jums, sāciet veikt izejošos zvanus.
  </Card>
</CardGroup>