> ## 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.
# Připojte vlastní čísla (VoIP, API)
> Připojte Twilio nebo Telnyx — případně jakýkoli SIP trunk — a importujte telefonní čísla ze svého stávajícího účtu.
Ukázková čísla jsou vhodná pro prototypování, ale provozní hovory by měly
používat čísla, která vlastníte prostřednictvím vlastního poskytovatele VoIP. Tento průvodce vás provede postupem ve třech krocích: **otestování přihlašovacích údajů → vytvoření
připojení → import čísel → ověření**.
V dashboardu je k dispozici provázená verze celého tohoto postupu v části
**Připojení → VoIP** (`/dashboard/voip-connections`): provázené
nastavení Telnyx, které vás provede vytvořením účtu a nastavením klíčů API, postup
pro připojení stávajícího účtu a ruční formulář SIP s generátorem průvodce
nastavením AI.
## Podporovaní poskytovatelé
| Poskytovatel | ID `provider` | Poznámky |
| ------------ | ------------- | ------------------------------------------------------------------------- |
| Twilio | `twilio` | Klíč API + tajný klíč |
| Telnyx | `telnyx` | Klíč API; k dispozici provázené nastavení (`setup_method: guided_telnyx`) |
| SignalWire | `signalwire` | **Již brzy** — dnes se připojte přes ruční SIP |
| Vonage | `vonage` | **Již brzy** — dnes se připojte přes ruční SIP |
| Ruční SIP | `manual` | Libovolný SIP trunk — použijte vlastní konfiguraci |
## 1. Otestování přihlašovacích údajů
Před vytvořením trvalého připojení VoIP ověřte přihlašovací údaje
poskytovatele, abyste potvrdili, že fungují. Tím získáte
`verification_evidence_id`, které předáte kroku vytvoření, aby se za
testování přihlašovacích údajů neúčtovalo dvakrát.
```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
}
}
```
Pokud některá kontrola selže, hodnota `status` v odpovědi bude `fail` a `checks`
ukáže, který krok selhal. Opravte konfiguraci na straně poskytovatele (přiřazení
trunku, seznam povolených IP adres, oprávnění pro odchozí hovory) a zkuste to znovu.
## 2. Vytvoření připojení
Předejte právě získané `verification_evidence_id`:
```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..."
}'
```
Odpovědí je [objekt VoipConnection](/api-reference/voip-connections#connection-object)
se stavem `status="connected"`. Přihlašovací údaje jsou uloženy na serveru a následné
požadavky GET je nikdy nevracejí ve formátu prostého textu — pro jejich obměnu spusťte nové
`test` a odešlete PATCH s novým ověřovacím podkladem.
## 3. Výpis a import čísel
Zkontrolujte čísla viditelná pro vaše přihlašovací údaje, která ještě nejsou
v organizaci ThunderPhone:
```bash theme={null}
curl https://api.thunderphone.com/v1/voip-connections/5/available-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Poté importujte čísla, která chcete:
```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"]}'
```
Každý import se ve vaší organizaci stane [prostředkem telefonního čísla](/api-reference/phone-numbers)
s `source="voip"` a `status="provisioning"`.
## 4. Ověřte každé importované číslo
Importem se číslo zaregistruje jako *dostupné*; skutečné směrování hovorů
přes něj vyžaduje obousměrné ověření (kontrolu příchozího volání +
sondu autorizace odchozího volání).
```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/phone-numbers/{id}/verify-voip \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
Při úspěchu se `voip_verification_status` změní na `verified` a
číslo přejde do stavu `status="active"`. Při selhání odpověď podrobně uvádí,
co se nepodařilo — opravte to (často jde o chybějící přiřazení trunku v
ovládacím panelu poskytovatele) a požadavek spusťte znovu.
## 5. Přiřaďte agenty a přijměte hovor
Po ověření čísla přiřadíte agenty pro příchozí a odchozí hovory stejným
způsobem jako u ukázkového čísla. Viz
[Zpracování příchozích hovorů](/cs/guides/handle-inbound-calls) a
[Uskutečňování odchozích hovorů](/cs/guides/place-outbound-calls).
## Obměna přihlašovacích údajů
Když poskytovatel změní klíč, znovu proveďte postup testování a následné aktualizace:
```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"
}'
```
Připojení zůstane zachováno — čísla není nutné znovu importovat.
***
## Další kroky
Všechna pole v odpovědích pro připojení, důkazy a import.
Přiřazujte agenty, převádějte čísla mezi organizacemi, uvolňujte čísla.
Nyní, když číslo vlastníte, začněte uskutečňovat odchozí hovory.