Použite vlastné čísla (VoIP, API)

Demo čísla sú vhodné na prototypovanie, ale produkčná prevádzka by mala používať čísla, ktoré vlastníte prostredníctvom vlastného poskytovateľa VoIP. Tento návod vás prevedie trojkrokovým postupom: otestovať poverenia → vytvoriť pripojenie → importovať čísla → overiť.

Podporovaní poskytovatelia

1. Otestujte poverenia

Pred vytvorením trvalého pripojenia VoIP overte poverenia poskytovateľa, aby ste potvrdili, že fungujú. Týmto získate verification_evidence_id, ktorý odovzdáte v kroku vytvorenia, aby sa poverenia za testovanie neúčtovali dvakrát.

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

Ak niektorá kontrola zlyhá, status odpovede bude fail a checks zobrazí, ktorý krok zlyhal. Opravte konfiguráciu na strane poskytovateľa (priradenie trunku, zoznam povolených IP adries, autorizáciu odchádzajúcich hovorov) a skúste to znova.

2. Vytvorte pripojenie

Odovzdajte verification_evidence_id, ktorý ste práve získali:

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

Odpoveďou je objekt VoipConnection so stavom status="connected". Poverenia sa ukladajú na strane servera a následné požiadavky GET ich nikdy nevrátia vo forme obyčajného textu — ak ich chcete obnoviť, spustite nové test a vykonajte PATCH s novým dôkazom.

3. Zobrazte zoznam a importujte čísla

Skontrolujte čísla viditeľné pre vaše poverenia, ktoré sa ešte nenachádzajú v organizácii ThunderPhone:

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

Potom importujte požadované čísla:

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

Každý import sa vo vašej organizácii zmení na zdroj telefónneho čísla s source="voip" a status="provisioning".

4. Overte každý importovaný číslo

Importovaním sa číslo zaregistruje ako dostupné; na skutočné smerovanie hovorov cez neho je potrebné obojsmerné overenie (kontrola prichádzajúceho volania + test autorizácie odchádzajúceho volania).

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

Po úspechu sa voip_verification_status zmení na verified a číslo prejde do status="active". Pri zlyhaní odpoveď uvedie, čo zlyhalo — opravte to (často chýbajúce priradenie trunku na paneli poskytovateľa) a volanie zopakujte.

5. Priraďte agentov a uskutočnite hovor

Po overení čísla priradíte agentov pre prichádzajúce / odchádzajúce hovory rovnako ako pri ukážkovom čísle. Pozrite si Spracovanie prichádzajúcich hovorov a Uskutočňovanie odchádzajúcich hovorov.

Obnova poverení

Keď sa kľúč poskytovateľa obnoví, znova vykonajte postup testovania a aktualizácie:

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

Pripojenie zostane zachované — čísla netreba znovu importovať.

Ďalšie kroky