Savienojiet, izmantojot SIP (bez tālruņa numura)

Novirziet zvanus uz ThunderPhone balss aģentu tieši no savas PBX sistēmas, operatora vai SIP lietojumprogrammas, izmantojot vienreizēju SIP URI katram zvanam vai pastāvīgu SIP adresi.

Ja jūsu sistēma jau apstrādā tālruņa numurus (PBX, kontaktu centra platforma vai operatora konts, kurā maināt numurus), varat sūtīt zvanus uz ThunderPhone balss aģentu, izmantojot parastu SIP. Jums nav jāimportē vai jāpērk numurs pakalpojumā ThunderPhone. Jūsu sistēma sastāda SIP adresi, un aģents atbild.

Ir divu veidu SIP adreses:

Abi veidi maršrutē uz vienu balss aģentu jūsu organizācijā, un abi zvanu vēsturē tiek rādīti kā jebkurš cits ienākošais zvans.

SIP URI katram zvanam#

1. Reģistrējiet zvanu#

curl -X POST https://api.thunderphone.com/v1/calls/register-sip \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": 12,
    "to_number": "+14155550142",
    "variables": {"customer_name": "Ada"}
  }'

{
  "call_id": 862197007562,
  "sip_uri": "sip:c-1790372992.Qm3xT8vLk2PzR7nYw4HbJa.uF6sD1gK9eW2cX5vB8nM0q@sip.thunderphone.com",
  "expires_at": "2026-09-25T21:49:52Z",
  "agent_id": 12,
  "to_number": "+14155550142"
}

• to_number (neobligāts) ir numurs, ko zvanītājs sastādīja jūsu pusē. Tas zvanu vēsturē tiek saglabāts kā zvana galamērķis, un balss aģents to redz kā savu numuru.
• variables (neobligāts) aizpilda {{placeholders}} aģenta uzvednē tāpat kā izejošajiem zvaniem.
• call_id ir ID, kas zvanam būs zvanu vēsturē (GET /v1/calls/{call_id}), kad tas savienosies.

2. Sastādiet URI#

Nosūtiet zvanu uz sip_uri 5 minūšu laikā. URI darbojas tikai vienam zvanam: tiklīdz zvans to ir izmantojis, tas vairs nav derīgs, pat ja šis zvans ātri beidzas.

Piemēram, izmantojot Twilio, atgrieziet šo TwiML zvanam, kuru vēlaties nodot:

<Response>
  <Dial>
    <Sip>sip:c-1790372992.Qm3xT8vLk2PzR7nYw4HbJa.uF6sD1gK9eW2cX5vB8nM0q@sip.thunderphone.com;transport=tcp</Sip>
  </Dial>
</Response>

No PBX sastādiet URI kā SIP galamērķi. Lietotājvārds vai parole nav nepieciešami; marķieris ir piekļuves dati, tāpēc līdz tā izmantošanai izturieties pret URI kā pret paroli.

SIP galapunkts (pastāvīga adrese)#

1. Izveidojiet galapunktu#

curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 12, "name": "Main PBX"}'

{
  "id": 7,
  "name": "Main PBX",
  "agent_id": 12,
  "sip_uri": "sip:agent-12-jhxmginwjx@sip.thunderphone.com",
  "username": "tp409667538f83",
  "password": "8mJ0…",
  "allowed_source_cidrs": [],
  "status": "active",
  "created_at": "2026-09-25T21:46:18Z"
}

2. Norādiet uz to savā sistēmā#

Konfigurējiet SIP maģistrāli vai galamērķi ar šādiem iestatījumiem:

Šie transporta un kodeku iestatījumi attiecas arī uz katra zvana URI. Abiem adrešu veidiem ir svarīgas divas tīkla detaļas:

• Ievērojiet Record-Route. Pēc pirmā INVITE pārējā zvana signalizācija (ACK, nolikšana, pārsūtīšana) tiek nosūtīta uz konkrēto ThunderPhone serveri, kas atbildēja un ir norādīts Record-Route galvenē (sip-1.thunderphone.com vai sip-2.thunderphone.com, vai tā IP adrese). Ja ierobežojat izejošo SIP, atļaujiet šos resursdatorus, kā arī sip.thunderphone.com: 172.170.39.202 (sip), 13.86.104.121 (sip-1) un 20.80.98.90 (sip-2).
• Audio tiek nosūtīts citur. sip.thunderphone.com nodrošina tikai signalizāciju. Atļaujiet multividi (RTP) uz SDP atbildē norādītajām adresēm un portiem.

Katrs zvans uz šo adresi sasniedz galapunkta balss aģentu neatkarīgi no tā, kādu numuru zvanītājs sastādīja jūsu pusē. Jums nekad nav jāimportē numuri, tāpēc to maiņai jūsu pusē ThunderPhone nav nepieciešamas izmaiņas.

Nododiet sastādīto numuru (neobligāti)#

Lai reģistrētu, kuru no jūsu numuriem zvanītājs sastādīja, nosūtiet to INVITE pieprasījumā X-Original-To galvenē (piemēram, X-Original-To: +14155550142) vai standarta Diversion galvenē. ThunderPhone to saglabā kā zvana galamērķi.

Galamērķis tiek izvēlēts šādā secībā: to_number, kas norādīts, reģistrējot katra zvana URI, pēc tam numurs no X-Original-To, pēc tam numurs no Diversion. Ja neviens no šiem avotiem nenorāda numuru, galapunktam tiek rādīts sip:agent-12-jhxmginwjx (galapunkta adrese), bet katra zvana URI tiek rādīts sip:call.

Izmantojot Twilio, galveni varat pievienot SIP URI: sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tcp?X-Original-To=%2B14155550142.

Ierobežojiet avota IP adreses (neobligāti)#

Iestatiet allowed_source_cidrs, lai papildus lietotājvārdam un parolei pieņemtu zvanus tikai no jūsu pašu signalizācijas adresēm:

curl -X PATCH https://api.thunderphone.com/v1/sip-endpoints/7 \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"allowed_source_cidrs": ["203.0.113.0/28"]}'

Zvani no jebkuras citas adreses tiek noraidīti, pirms tie sasniedz balss aģentu. Izmantojiet adreses, no kurām jūsu sistēma sūta SIP signalizāciju (tādam operatoram kā Twilio — tā publicētos signalizācijas IP diapazonus), nevis savas multivides adreses.

Ko redz zvanītāji un jūsu sistēma#

• Zvanītāja ID: From galvenes lietotāja daļa tiek saglabāta kā zvanītājs. Tālruņa numurs (cipari, pēc izvēles ar +, atstarpēm, domuzīmēm, punktiem vai iekavām) tiek normalizēts E.164 formātā; viss pārējais, piemēram, SIP lietotājvārds, tiek saglabāts nosūtītajā veidā. Tiek saglabātas ne vairāk kā 32 rakstzīmes, un trūkstošs zvanītājs tiek saglabāts kā anonymous.
• Noraidītie zvani: nezināms vai beidzies URI katram zvanam saņem SIP 404 Not Found. Jau izmantots URI katram zvanam, atspējots galapunkts vai avots ārpus atļauto saraksta (tostarp jebkurš UDP zvans uz galapunktu ar atļauto sarakstu) tiek atvienots, pirms sāk darbu balss aģents: jūsu sistēmā zvans var būt redzams kā neveiksmīgs vai savienoties un pēc tam uzreiz beigties. Šādi noraidījumi nerada ierakstu zvanu vēsturē. Ja jūsu organizācijai ir beidzies kredīts vai tā ir sasniegusi tēriņu limitu, zvans tiek noraidīts un zvanu vēsturē tiek rādīts kā neveiksmīgs zvans bez maksas. Lai atkārtotu mēģinājumu ar URI katram zvanam, izveidojiet jaunu URI.
• Pārsūtīšana: balss aģenta aklā pārsūtīšana darbojas (ThunderPhone nosūta SIP REFER, kas jūsu sistēmai ir jāpieņem). Siltā pārsūtīšana nav pieejama zvaniem uz SIP adresēm, jo otrajam savienojuma posmam nav ThunderPhone numura, ko rādīt kā zvanītāja ID. Izmantojot Twilio, iepriekš minētais TwiML savieno balss aģentu, bet neapstrādā pārsūtīšanu: pievienojiet referUrl="https://YOUR_SERVER/sip-transfer" elementam <Dial> un iestatiet šo webhook nolasīt ReferTransferTarget un atgriezt TwiML, kas sastāda pārsūtīšanas galamērķi (skatiet Twilio SIP REFER ceļvedi).
• Īsziņas: SIP adrese un sastādītais numurs nevar sūtīt īsziņas. Balss aģents var sūtīt īsziņas SIP adreses zvana laikā tikai tad, ja tam īsziņu sūtīšanai ir iestatīts atsevišķs SMS atbalstošs numurs; pretējā gadījumā tā SMS rīks nav pieejams.
• Reģistrācija: ThunderPhone nepieņem SIP REGISTER. Sūtiet zvanus uz adresi; nereģistrējieties tajā.

Cenas#

Zvani uz SIP adresēm tiek apmaksāti pēc balss aģenta parastās maksas par minūti. Par tālruņa numuru nav maksas, jo zvanu neapkalpo ThunderPhone numurs. Jūsu sakaru pakalpojumu sniedzējs par savu zvana daļu rēķinu izraksta kā parasti. Skatiet Cenas.

Izmēģiniet#

1. Izveidojiet URI katram zvanam vai galapunktu, kā aprakstīts iepriekš.
2. Sastādiet to no savas sistēmas vai no jebkura SIP programmatūras tālruņa (galapunktam ievadiet lietotājvārdu un paroli).
3. Pēc zvana beigšanas atveriet zvanu informācijas panelī sadaļā Zvani vai iegūstiet to ar GET /v1/calls/{call_id}. Tajā redzams zvanītājs, galamērķis (skatiet secību sadaļā “Nododiet sastādīto numuru”) un transkripts.

API informācija: SIP adrešu API atsauce.