Saját telefonszámok használata (VoIP, API)

A demószámok megfelelőek prototípusokhoz, de az éles forgalomhoz a saját VoIP-szolgáltatóján keresztül birtokolt számokat használjon. Ez az útmutató végigvezeti a háromlépéses folyamaton: hitelesítő adatok tesztelése → kapcsolat létrehozása → számok importálása → ellenőrzés.

Az irányítópulton ennek a teljes folyamatnak egy vezetett változata található a Kapcsolatok → VoIP (/dashboard/voip-connections) alatt: egy Telnyx vezetett beállítás, amely végigvezeti a fiók létrehozásán és az API-kulcsokon, egy meglévő fiók csatlakoztatására szolgáló útvonal, valamint egy manuális SIP-űrlap AI beállítási útmutató generátorral.

Támogatott szolgáltatók

Szolgáltató	`provider` azonosító	Megjegyzések
Twilio	`twilio`	API-kulcs + titkos kulcs
Telnyx	`telnyx`	API-kulcs; vezetett bevezetés elérhető (`setup_method: guided_telnyx`)
SignalWire	`signalwire`	Hamarosan — jelenleg manuális SIP-en keresztül csatlakoztatható
Vonage	`vonage`	Hamarosan — jelenleg manuális SIP-en keresztül csatlakoztatható
Manuális SIP	`manual`	Bármilyen SIP-trönk — használja a saját konfigurációját

1. Hitelesítő adatok tesztelése

Mielőtt tartósan tárolt VoIP-kapcsolatot hozna létre, ellenőrizze a szolgáltatói hitelesítő adatokat, hogy megbizonyosodjon azok működéséről. Ez egy verification_evidence_id értéket ad vissza, amelyet a létrehozási lépésnek ad át, így a hitelesítő adatok teszteléséért nem számítanak fel díjat kétszer.

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

Ha bármelyik ellenőrzés sikertelen, a válasz status értéke fail lesz, a checks pedig megmutatja, melyik lépés hiúsult meg. Javítsa a szolgáltatói oldali konfigurációt (trönkhozzárendelés, IP-engedélyezési lista, kimenő jogosultság), majd próbálja újra.

2. A kapcsolat létrehozása

Adja meg az imént kapott verification_evidence_id értéket:

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

A válasz egy status="connected" állapotú VoipConnection-objektum. A hitelesítő adatokat szerveroldalon tároljuk, és a későbbi GET-kérések soha nem adják vissza őket olvasható formában — cseréjükhöz futtasson egy új test hívást, majd küldjön PATCH-kérést az új ellenőrzési bizonyítékkal.

3. Számok listázása és importálása

Tekintse meg a hitelesítő adatai számára elérhető, még ThunderPhone-szervezethez nem tartozó számokat:

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

Ezután importálja a kívánt számokat:

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

Minden importált szám telefonszám-erőforrássá válik a szervezetében source="voip" és status="provisioning" értékekkel.

4. Ellenőrizze az egyes importált számokat

Az importálás a számot elérhetőként regisztrálja; a hívások tényleges átirányításához oda-vissza ellenőrzés szükséges (bejövő behívási ellenőrzés + kimenő engedélyezési próba).

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

Siker esetén a voip_verification_status értéke verified lesz, és a szám status="active" állapotba kerül. Sikertelenség esetén a válasz részletezi, mi hibázott — javítsa ki (gyakran a szolgáltatói irányítópulton hiányzó trunk-hozzárendelésről van szó), majd hívja meg újra.

5. Rendeljen hozzá ügynököket, és fogadjon hívást

A szám ellenőrzése után ugyanúgy rendelhet hozzá bejövő / kimenő ügynököket, mint egy demószámhoz. Lásd: Bejövő hívások kezelése és Kimenő hívások indítása.

Hitelesítő adatok rotálása

Amikor egy szolgáltatói kulcs lecserélődik, futtassa újra a tesztelés, majd frissítés folyamatát:

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

A kapcsolat változatlanul megmarad — nincs szükség a számok újbóli importálására.

Következő lépések

VoIP-kapcsolatok referenciája

A kapcsolat, a bizonyíték és az importálási válaszok minden mezője.

Telefonszámok referenciája

Rendeljen hozzá ügynököket, helyezze át a számokat szervezetek között, vagy szabadítsa fel őket.

Kimenő hívások indítása

Most, hogy Ön birtokolja a számot, kezdjen kimenő hívásokat indítani.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Saját telefonszámok használata (VoIP, API)

Támogatott szolgáltatók

1. Hitelesítő adatok tesztelése

2. A kapcsolat létrehozása

3. Számok listázása és importálása

4. Ellenőrizze az egyes importált számokat

5. Rendeljen hozzá ügynököket, és fogadjon hívást

Hitelesítő adatok rotálása

Következő lépések

VoIP-kapcsolatok referenciája

Telefonszámok referenciája

Kimenő hívások indítása

​Támogatott szolgáltatók

​1. Hitelesítő adatok tesztelése

​2. A kapcsolat létrehozása

​3. Számok listázása és importálása

​4. Ellenőrizze az egyes importált számokat

​5. Rendeljen hozzá ügynököket, és fogadjon hívást

​Hitelesítő adatok rotálása

​Következő lépések

VoIP-kapcsolatok referenciája

Telefonszámok referenciája

Kimenő hívások indítása

Támogatott szolgáltatók

1. Hitelesítő adatok tesztelése

2. A kapcsolat létrehozása

3. Számok listázása és importálása

4. Ellenőrizze az egyes importált számokat

5. Rendeljen hozzá ügynököket, és fogadjon hívást

Hitelesítő adatok rotálása

Következő lépések