Folosiți propriile numere (VoIP, API)

Numerele demo sunt potrivite pentru prototipare, dar traficul de producție trebuie să folosească numere pe care le dețineți, prin propriul furnizor VoIP. Acest ghid vă prezintă fluxul în trei pași: testați acreditările → creați conexiunea → importați numerele → verificați.

Tabloul de bord include o versiune ghidată a întregului flux, în Conexiuni → VoIP (/dashboard/voip-connections): o configurare ghidată Telnyx care vă ajută cu crearea contului și cheile API, o opțiune de conectare a unui cont existent și un formular SIP manual cu un generator de ghiduri de configurare AI.

Furnizori acceptați

Furnizor	ID `provider`	Note
Twilio	`twilio`	Cheie API + secret
Telnyx	`telnyx`	Cheie API; integrare ghidată disponibilă (`setup_method: guided_telnyx`)
SignalWire	`signalwire`	În curând — conectați-vă astăzi prin SIP manual
Vonage	`vonage`	În curând — conectați-vă astăzi prin SIP manual
SIP manual	`manual`	Orice trunk SIP — folosiți propria configurație

1. Testați acreditările

Înainte de a crea o conexiune VoIP persistentă, verificați acreditările furnizorului pentru a confirma că funcționează. Aceasta returnează un verification_evidence_id pe care îl transmiteți la pasul de creare, astfel încât acreditările să nu fie taxate de două ori pentru testare.

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

Dacă oricare verificare eșuează, status din răspuns va fi fail, iar checks va arăta ce pas a eșuat. Corectați configurația de la furnizor (atribuirea trunkului, lista de IP-uri permise, autorizarea apelurilor de ieșire) și reîncercați.

2. Creați conexiunea

Transmiteți verification_evidence_id pe care tocmai l-ați obținut:

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

Răspunsul este un obiect VoipConnection cu status="connected". Acreditările sunt stocate pe server și nu sunt returnate niciodată în text simplu de GET-urile ulterioare — pentru rotație, executați un nou test și un PATCH cu noile dovezi.

3. Listați și importați numerele

Examinați numerele vizibile pentru acreditările dumneavoastră care nu sunt deja într-o organizație ThunderPhone:

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

Apoi importați-le pe cele dorite:

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

Fiecare import devine o resursă de număr de telefon în organizația dumneavoastră, cu source="voip" și status="provisioning".

4. Verificați fiecare număr importat

Importul înregistrează numărul ca fiind disponibil; direcționarea efectivă a apelurilor prin acesta necesită o verificare dus-întors (verificare de apelare pentru apelurile primite + test de autorizare pentru apelurile efectuate).

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

În caz de reușită, voip_verification_status devine verified, iar numărul primește status="active". În caz de eșec, răspunsul precizează ce nu a reușit — remediați problema (adesea, o atribuire de trunk lipsă în tabloul de bord al furnizorului) și apelați din nou.

5. Atribuiți agenți și preluați un apel

După verificarea numărului, atribuiți agenți pentru apeluri primite / efectuate în același mod ca pentru un număr demonstrativ. Consultați Gestionarea apelurilor primite și Inițierea apelurilor efectuate.

Rotirea credențialelor

Când se rotește o cheie de furnizor, reluați fluxul de testare-apoi-actualizare:

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

Conexiunea rămâne configurată — nu este necesar să reimportați numerele.

Pașii următori

Referință pentru conexiunile VoIP

Toate câmpurile din răspunsurile pentru conexiune, dovezi și import.

Referință pentru numerele de telefon

Atribuiți agenți, transferați între organizații, eliberați numere.

Inițiați apeluri efectuate

Acum că dețineți numărul, începeți să inițiați apeluri efectuate.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Folosiți propriile numere (VoIP, API)

Furnizori acceptați

1. Testați acreditările

2. Creați conexiunea

3. Listați și importați numerele

4. Verificați fiecare număr importat

5. Atribuiți agenți și preluați un apel

Rotirea credențialelor

Pașii următori

Referință pentru conexiunile VoIP

Referință pentru numerele de telefon

Inițiați apeluri efectuate

​Furnizori acceptați

​1. Testați acreditările

​2. Creați conexiunea

​3. Listați și importați numerele

​4. Verificați fiecare număr importat

​5. Atribuiți agenți și preluați un apel

​Rotirea credențialelor

​Pașii următori

Referință pentru conexiunile VoIP

Referință pentru numerele de telefon

Inițiați apeluri efectuate

Furnizori acceptați

1. Testați acreditările

2. Creați conexiunea

3. Listați și importați numerele

4. Verificați fiecare număr importat

5. Atribuiți agenți și preluați un apel

Rotirea credențialelor

Pașii următori