Naudokite savo numerius (VoIP, API)

Demonstraciniai numeriai tinka prototipams kurti, tačiau produkcijos srautui turėtumėte naudoti numerius, kuriuos valdote per savo VoIP teikėją. Šiame vadove aprašomas trijų žingsnių procesas: patikrinkite prisijungimo duomenis → sukurkite ryšį → importuokite numerius → patvirtinkite.

Palaikomi teikėjai

1. Patikrinkite prisijungimo duomenis

Prieš kurdami išsaugotą VoIP ryšį, patikrinkite teikėjo prisijungimo duomenis, kad įsitikintumėte, jog jie veikia. Taip grąžinamas verification_evidence_id, kurį perduodate kūrimo veiksmui, kad už prisijungimo duomenų tikrinimą nebūtų apmokestinta du kartus.

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

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

Jei kuri nors patikra nepavyksta, atsakymo status bus fail, o checks parodys, kuriame žingsnyje įvyko klaida. Pataisykite teikėjo pusės konfigūraciją (magistralės priskyrimą, IP leidžiamų adresų sąrašą, siunčiamųjų skambučių autorizavimą) ir bandykite dar kartą.

2. Sukurkite ryšį

Perduokite ką tik gautą 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..."
  }'

Atsakymas yra VoipConnection objektas, kurio status="connected". Prisijungimo duomenys saugomi serverio pusėje ir vėlesnės GET užklausos jų niekada negrąžina paprastu tekstu — norėdami juos pakeisti, atlikite naują test ir PATCH užklausą su naujais įrodymais.

3. Išvardykite ir importuokite numerius

Peržiūrėkite jūsų prisijungimo duomenims matomus numerius, kurių dar nėra ThunderPhone organizacijoje:

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

Tada importuokite norimus numerius:

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

Kiekvienas importuotas numeris tampa telefono numerio ištekliumi jūsų organizacijoje su source="voip" ir status="provisioning".

4. Patvirtinkite kiekvieną importuotą numerį

Importuojant numeris užregistruojamas kaip pasiekiamas; norint iš tikrųjų nukreipti skambučius per jį, reikia abipusio patvirtinimo (įeinančiojo skambučio patikros + išeinančiųjų skambučių autorizacijos patikros).

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

Sėkmės atveju voip_verification_status pakeičiama į verified, o numerio būsena tampa status="active". Nesėkmės atveju atsakyme nurodoma, kas nepavyko — ištaisykite problemą (dažnai tai būna nepriskirtas magistralinis ryšys teikėjo valdymo skydelyje) ir iškvieskite dar kartą.

5. Priskirkite agentus ir priimkite skambutį

Patvirtinus numerį, įeinančiųjų / išeinančiųjų skambučių agentus priskirkite taip pat, kaip demonstraciniam numeriui. Žr. Tvarkyti įeinančius skambučius ir Vykdyti išeinančius skambučius.

Prisijungimo duomenų keitimas

Pasikeitus teikėjo raktui, pakartokite testavimo ir atnaujinimo veiksmus:

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

Ryšys lieka toks pats — numerių iš naujo importuoti nereikia.

Tolesni veiksmai