> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Csatlakoztassa a Twiliót vagy a Telnyxet — illetve bármely SIP-trunköt —, és importáljon telefonszámokat meglévő fiókjából.

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**.

<Note>
  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.
</Note>

## 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.

```bash theme={null}
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" }
  }'
```

```json Response theme={null}
{
  "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:

```bash theme={null}
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](/api-reference/voip-connections#connection-object).
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:

```bash theme={null}
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:

```bash theme={null}
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á](/api-reference/phone-numbers)
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).

```bash theme={null}
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](/hu/guides/handle-inbound-calls) és
[Kimenő hívások indítása](/hu/guides/place-outbound-calls).

## 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:

```bash theme={null}
# 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

<CardGroup cols={2}>
  <Card title="VoIP-kapcsolatok referenciája" icon="phone-volume" href="/api-reference/voip-connections">
    A kapcsolat, a bizonyíték és az importálási válaszok minden mezője.
  </Card>

  <Card title="Telefonszámok referenciája" icon="phone" href="/api-reference/phone-numbers">
    Rendeljen hozzá ügynököket, helyezze át a számokat szervezetek között, vagy szabadítsa fel őket.
  </Card>

  <Card title="Kimenő hívások indítása" icon="arrow-up-right" href="/hu/guides/place-outbound-calls">
    Most, hogy Ön birtokolja a számot, kezdjen kimenő hívásokat indítani.
  </Card>
</CardGroup>