--- title: "Savienojiet, izmantojot SIP (bez tālruņa numura)" description: "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: | | **SIP URI katram zvanam** | **SIP galapunkts** | |---|---|---| | Izskatās kā | `sip:c-@sip.thunderphone.com` | `sip:agent--@sip.thunderphone.com` | | Izveido ar | `POST /v1/calls/register-sip`, vienreiz katram zvanam | `POST /v1/sip-endpoints`, vienreiz | | Autentifikācija | Vienreizējais marķieris adresē | SIP digest lietotājvārds + parole (un pēc izvēles avota IP adrešu atļauju saraksts) | | Piemērots | Lietotnēm, kas jau izsauc API pirms zvana pārsūtīšanas; mainīgie katram zvanam | PBX un operatoriem, kuriem vienkārši jānovirza maģistrāle uz ThunderPhone | | Derīgs | 5 minūtes, vienam zvanam | Līdz to izdzēšat | 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 ```bash 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"} }' ``` ```json { "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](/lv/guides/call-variables). - `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: ```xml sip:c-1790372992.Qm3xT8vLk2PzR7nYw4HbJa.uF6sD1gK9eW2cX5vB8nM0q@sip.thunderphone.com;transport=tcp ``` 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 ```bash 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"}' ``` ```json { "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" } ``` `password` tiek atgriezta tikai vienu reizi — kad galapunkts tiek izveidots. Nekavējoties saglabājiet to savā PBX vai operatora konfigurācijā. Ja to pazaudējat, nomainiet to ar `POST /v1/sip-endpoints/{id}/rotate-password`. ### 2. Norādiet uz to savā sistēmā Konfigurējiet SIP maģistrāli vai galamērķi ar šādiem iestatījumiem: | Iestatījums | Vērtība | |---|---| | SIP URI | galapunkta `sip_uri` | | Lietotājvārds / parole | `username` / `password` (digest autentifikācija; ThunderPhone pārbauda katru zvanu) | | Transports | TCP 5060. portā vai TLS 5061. portā (ieteicams), vai UDP 5060. portā | | Kodeki | G.711 (PCMU/PCMA) vai G.722 | Dodiet priekšroku TCP vai TLS. UDP darbojas no publiskām adresēm un lielākās daļas NAT, taču aiz „simetriska” NAT (tāda, kas katram galamērķim izmanto jaunu portu) balss aģenta nolikšanas un pārsūtīšanas pieprasījumi var nesasniegt jūsu sistēmu. Avota IP atļauju sarakstam (tālāk) arī nepieciešams TCP vai TLS. Izmantojot TLS, SIP signalizācija paliek šifrēta arī aiz `sip.thunderphone.com` — līdz pat serveriem, kas apstrādā zvanu. Š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: ```bash 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. Atļauju saraksts tiek pārbaudīts tikai zvaniem, kas tiek veikti, izmantojot TCP vai TLS. UDP avota adresi var viltot, tāpēc galapunkts ar atļauju sarakstu noraida katru zvanu, kas tiek saņemts, izmantojot UDP. Sūtiet zvanus uz to ar `;transport=tcp` (5060. ports) vai izmantojot TLS (5061. ports). ## 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 `` 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](https://www.twilio.com/docs/voice/api/refer-to-twilio)). - **Ī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](/lv/guides/pricing). ## 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](/api-reference/sip-addresses).