Använd egna nummer (VoIP, API)

Demonstrationsnummer fungerar bra för prototyper, men produktionstrafik bör använda nummer som du äger via din egen VoIP-leverantör. Den här guiden går igenom trestegsflödet: testa autentiseringsuppgifter → skapa anslutning → importera nummer → verifiera.

Instrumentpanelen har en guidad version av hela flödet under Anslutningar → VoIP (/dashboard/voip-connections): en guidad Telnyx-konfiguration som går igenom kontoskapande och API-nycklar, en väg för att ansluta ett befintligt konto samt ett manuellt SIP-formulär med en AI-generator för installationsguider.

Leverantörer som stöds

Leverantör	`provider`-id	Anteckningar
Twilio	`twilio`	API-nyckel + hemlighet
Telnyx	`telnyx`	API-nyckel; guidad registrering tillgänglig (`setup_method: guided_telnyx`)
SignalWire	`signalwire`	Kommer snart — anslut via manuell SIP i dag
Vonage	`vonage`	Kommer snart — anslut via manuell SIP i dag
Manuell SIP	`manual`	Valfri SIP-trunk — använd din egen konfiguration

1. Testa autentiseringsuppgifter

Innan du skapar en sparad VoIP-anslutning testar du leverantörens autentiseringsuppgifter för att bekräfta att de fungerar. Detta returnerar ett verification_evidence_id som du skickar till skapandesteget så att autentiseringsuppgifterna inte debiteras två gånger för testning.

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

Om någon kontroll misslyckas blir svarets status fail och checks visar vilket steg som misslyckades. Åtgärda konfigurationen hos leverantören (trunk-tilldelning, IP-tillåtelselista, auktorisering för utgående samtal) och försök igen.

2. Skapa anslutningen

Skicka med verification_evidence_id som du just fick:

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

Svaret är ett VoipConnection-objekt med status="connected". Autentiseringsuppgifter lagras på servern och returneras aldrig i klartext av efterföljande GET-anrop — för att rotera dem, kör ett nytt test och PATCH med det nya underlaget.

3. Lista och importera nummer

Granska de nummer som är tillgängliga med dina autentiseringsuppgifter och som inte redan finns i en ThunderPhone-organisation:

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

Importera sedan de nummer du vill ha:

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

Varje import blir en telefonnummerresurs i din organisation med source="voip" och status="provisioning".

4. Verifiera varje importerat nummer

Importen registrerar numret som tillgängligt; för att faktiskt dirigera samtal genom det krävs en verifiering tur och retur (kontroll av inkommande uppringning + auktoriseringskontroll för utgående samtal).

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

Vid lyckad verifiering ändras voip_verification_status till verified och numret får status="active". Vid fel anger svaret vad som misslyckades — åtgärda det (ofta saknas en trunk-tilldelning i leverantörens kontrollpanel) och anropa igen.

5. Tilldela agenter och ta emot ett samtal

När numret har verifierats tilldelar du agenter för inkommande/utgående samtal på samma sätt som för ett demonummer. Se Hantera inkommande samtal och Ring utgående samtal.

Roterande autentiseringsuppgifter

När en leverantörsnyckel roteras kör du test-och-uppdatera-flödet igen:

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

Anslutningen finns kvar — du behöver inte importera numren igen.

Nästa steg

Referens för VoIP-anslutningar

Alla fält i svaren för anslutning, underlag och import.

Referens för telefonnummer

Tilldela agenter, överför mellan organisationer, frigör nummer.

Ring utgående samtal

Nu när du äger numret kan du börja ringa utgående samtal.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Använd egna nummer (VoIP, API)

Leverantörer som stöds

1. Testa autentiseringsuppgifter

2. Skapa anslutningen

3. Lista och importera nummer

4. Verifiera varje importerat nummer

5. Tilldela agenter och ta emot ett samtal

Roterande autentiseringsuppgifter

Nästa steg

Referens för VoIP-anslutningar

Referens för telefonnummer

Ring utgående samtal

​Leverantörer som stöds

​1. Testa autentiseringsuppgifter

​2. Skapa anslutningen

​3. Lista och importera nummer

​4. Verifiera varje importerat nummer

​5. Tilldela agenter och ta emot ett samtal

​Roterande autentiseringsuppgifter

​Nästa steg

Referens för VoIP-anslutningar

Referens för telefonnummer

Ring utgående samtal

Leverantörer som stöds

1. Testa autentiseringsuppgifter

2. Skapa anslutningen

3. Lista och importera nummer

4. Verifiera varje importerat nummer

5. Tilldela agenter och ta emot ett samtal

Roterande autentiseringsuppgifter

Nästa steg