Koristite vlastite brojeve (VoIP, API)

Demonstracijski brojevi prikladni su za izradu prototipa, ali produkcijski promet trebao bi upotrebljavati brojeve koje posjedujete putem vlastitog VoIP pružatelja. Ovaj vodič vodi vas kroz tijek u tri koraka: testiranje vjerodajnica → stvaranje veze → uvoz brojeva → provjera.

Podržani pružatelji

1. Testirajte vjerodajnice

Prije stvaranja trajne VoIP veze provjerite vjerodajnice pružatelja kako biste potvrdili da rade. Time se vraća verification_evidence_id koji prosljeđujete u korak stvaranja kako vjerodajnice ne bi bile dvostruko naplaćene za testiranje.

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

Ako bilo koja provjera ne uspije, odgovor status bit će fail, a checks će pokazati koji korak nije uspio. Ispravite konfiguraciju na strani pružatelja (dodjelu trunka, popis dopuštenih IP adresa, autorizaciju odlaznih poziva) i pokušajte ponovno.

2. Stvorite vezu

Proslijedite verification_evidence_id koji ste upravo dobili:

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

Odgovor je objekt VoipConnection sa status="connected". Vjerodajnice se pohranjuju na poslužitelju i nikada se ne vraćaju u običnom tekstu u naknadnim GET zahtjevima — za zamjenu pokrenite novi test i izvršite PATCH s novim dokazom.

3. Prikažite i uvezite brojeve

Pregledajte brojeve vidljive vašim vjerodajnicama koji još nisu u ThunderPhone organizaciji:

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

Zatim uvezite one koje želite:

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

Svaki uvoz postaje resurs telefonskog broja u vašoj organizaciji s source="voip" i status="provisioning".

4. Potvrdite svaki uvezeni broj

Uvoz registrira broj kao dostupan; za stvarno usmjeravanje poziva preko njega potrebna je dvosmjerna provjera (provjera dolaznog poziva + provjera autorizacije odlaznog poziva).

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

Nakon uspjeha, voip_verification_status mijenja se u verified, a broj prelazi u status="active". U slučaju neuspjeha odgovor navodi što nije uspjelo — ispravite to (često nedostaje dodjela trunka u upravljačkoj ploči pružatelja usluge) i ponovno pozovite API.

5. Dodijelite agente i primite poziv

Nakon potvrde broja, dodjeljujete agente za dolazne / odlazne pozive na isti način kao za demonstracijski broj. Pogledajte Obrada dolaznih poziva i Upućivanje odlaznih poziva.

Rotiranje vjerodajnica

Kada se ključ pružatelja usluge rotira, ponovno pokrenite postupak testiranja pa ažuriranja:

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

Veza ostaje na mjestu — nema potrebe ponovno uvoziti brojeve.

Sljedeći koraci