Pievienojiet savus numurus (VoIP, API)

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.

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.

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.

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

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:

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 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ā:

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:

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

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 un Veiciet izejošos zvanus.

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:

# 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

VoIP savienojumu atsauce

Visi lauki savienojuma, pierādījumu un importēšanas atbildēs.

Tālruņa numuru atsauce

Piešķiriet balss aģentus, pārsūtiet starp organizācijām, atbrīvojiet numurus.

Veiciet izejošos zvanus

Tagad, kad numurs pieder jums, sāciet veikt izejošos zvanus.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Pievienojiet savus numurus (VoIP, API)

Atbalstītie pakalpojumu sniedzēji

1. Testējiet akreditācijas datus

2. Izveidojiet savienojumu

3. Uzskaitiet un importējiet numurus

4. Pārbaudiet katru importēto numuru

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

Piekļuves datu rotācija

Nākamās darbības

VoIP savienojumu atsauce

Tālruņa numuru atsauce

Veiciet izejošos zvanus

​Atbalstītie pakalpojumu sniedzēji

​1. Testējiet akreditācijas datus

​2. Izveidojiet savienojumu

​3. Uzskaitiet un importējiet numurus

​4. Pārbaudiet katru importēto numuru

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

​Piekļuves datu rotācija

​Nākamās darbības

VoIP savienojumu atsauce

Tālruņa numuru atsauce

Veiciet izejošos zvanus

Atbalstītie pakalpojumu sniedzēji

1. Testējiet akreditācijas datus

2. Izveidojiet savienojumu

3. Uzskaitiet un importējiet numurus

4. Pārbaudiet katru importēto numuru

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

Piekļuves datu rotācija

Nākamās darbības