Připojte vlastní čísla (VoIP, API)

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.

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

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:

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

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

Poté importujte čísla, která chcete:

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 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í).

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ů a Uskutečňování odchozích hovorů.

Obměna přihlašovacích údajů

Když poskytovatel změní klíč, znovu proveďte postup testování a následné aktualizace:

# 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

Reference připojení VoIP

Všechna pole v odpovědích pro připojení, důkazy a import.

Reference telefonních čísel

Přiřazujte agenty, převádějte čísla mezi organizacemi, uvolňujte čísla.

Uskutečňování odchozích hovorů

Nyní, když číslo vlastníte, začněte uskutečňovat odchozí hovory.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Připojte vlastní čísla (VoIP, API)

Podporovaní poskytovatelé

1. Otestování přihlašovacích údajů

2. Vytvoření připojení

3. Výpis a import čísel

4. Ověřte každé importované číslo

5. Přiřaďte agenty a přijměte hovor

Obměna přihlašovacích údajů

Další kroky

Reference připojení VoIP

Reference telefonních čísel

Uskutečňování odchozích hovorů

​Podporovaní poskytovatelé

​1. Otestování přihlašovacích údajů

​2. Vytvoření připojení

​3. Výpis a import čísel

​4. Ověřte každé importované číslo

​5. Přiřaďte agenty a přijměte hovor

​Obměna přihlašovacích údajů

​Další kroky

Reference připojení VoIP

Reference telefonních čísel

Uskutečňování odchozích hovorů

Podporovaní poskytovatelé

1. Otestování přihlašovacích údajů

2. Vytvoření připojení

3. Výpis a import čísel

4. Ověřte každé importované číslo

5. Přiřaďte agenty a přijměte hovor

Obměna přihlašovacích údajů

Další kroky