Uporabite lastne številke (VoIP, API)

Predstavitvene številke so primerne za izdelavo prototipov, vendar naj produkcijski promet uporablja številke, ki jih imate v lasti prek svojega ponudnika VoIP. Ta vodnik vas vodi skozi postopek v treh korakih: preizkusite poverilnice → ustvarite povezavo → uvozite številke → preverite.

Podprti ponudniki

1. Preizkusite poverilnice

Preden ustvarite trajno povezavo VoIP, preverite poverilnice ponudnika, da potrdite, da delujejo. Tako prejmete verification_evidence_id, ki ga posredujete koraku ustvarjanja, da za preizkušanje poverilnic ne pride do dvojnega zaračunavanja.

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

Če katero koli preverjanje ne uspe, bo odgovor status nastavljen na fail, polje checks pa bo pokazalo, pri katerem koraku je prišlo do napake. Popravite konfiguracijo na strani ponudnika (dodelitev trunka, seznam dovoljenih IP-jev, avtorizacija odhodnih klicev) in poskusite znova.

2. Ustvarite povezavo

Posredujte verification_evidence_id, ki ste ga pravkar prejeli:

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 s status="connected". Poverilnice so shranjene na strežniku in jih nadaljnje zahteve GET nikoli ne vrnejo v navadnem besedilu — za zamenjavo izvedite nov test in PATCH z novim dokazilom.

3. Navedite in uvozite številke

Preglejte številke, vidne vašim poverilnicam, ki še niso v organizaciji ThunderPhone:

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

Nato uvozite želene številke:

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

Vsak uvoz postane vir telefonske številke v vaši organizaciji z source="voip" in status="provisioning".

4. Preverite vsako uvoženo številko

Z uvozom se številka registrira kot razpoložljiva; za dejansko usmerjanje klicev prek nje je potrebno povratno preverjanje (preverjanje dohodnega klica + preizkus odhodne avtorizacije).

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

Ob uspehu se voip_verification_status spremeni v verified in številka preide v status="active". Ob neuspehu odgovor natančno navede, kaj je bilo neuspešno — odpravite težavo (pogosto manjka dodelitev trunk povezave na nadzorni plošči ponudnika) in znova izvedite klic.

5. Dodelite agente in sprejmite klic

Ko je številka preverjena, dohodne / odhodne glasovne agente dodelite na enak način kot pri predstavitveni številki. Glejte Obravnava dohodnih klicev in Izvajanje odhodnih klicev.

Menjava poverilnic

Ko se ključ ponudnika zamenja, znova izvedite postopek preizkusa in posodobitve:

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

Povezava ostane vzpostavljena — številk ni treba znova uvoziti.

Naslednji koraki