SIP மூலம் இணைக்கவும் (தொலைபேசி எண் தேவையில்லை)

ஒவ்வொரு அழைப்புக்கும் ஒருமுறை பயன்படுத்தும் SIP URI அல்லது நிரந்தர SIP முகவரியைப் பயன்படுத்தி, உங்கள் PBX, கேரியர் அல்லது SIP பயன்பாட்டிலிருந்து நேரடியாக ThunderPhone ஏஜென்டுக்கு அழைப்புகளை அனுப்புங்கள்.

உங்கள் சொந்த அமைப்பு ஏற்கனவே தொலைபேசி எண்களைக் கையாளுகிறதெனில் (PBX, தொடர்பு மையத் தளம் அல்லது எண்களை மாற்றிப் பயன்படுத்தும் கேரியர் கணக்கு), சாதாரண SIP மூலம் அழைப்புகளை ThunderPhone ஏஜென்ட்டுக்கு அனுப்பலாம். ThunderPhone-இல் நீங்கள் எண்ணை இறக்குமதி செய்யவோ வாங்கவோ தேவையில்லை. உங்கள் அமைப்பு SIP முகவரியை டயல் செய்யும், ஏஜென்ட் பதிலளிக்கும்.

SIP முகவரிகளில் இரண்டு வகைகள் உள்ளன:

இரண்டு வகைகளும் உங்கள் நிறுவனத்தில் உள்ள ஒரு ஏஜென்ட்டுக்கே வழிமாற்றப்படும்; இரண்டுமே மற்ற உள்வரும் அழைப்புகளைப் போல அழைப்பு வரலாற்றில் தோன்றும்.

ஒவ்வொரு அழைப்புக்குமான SIP URI#

1. அழைப்பைப் பதிவு செய்யுங்கள்#

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 (விருப்பமானது) என்பது அழைப்பாளர் உங்கள் பக்கத்தில் டயல் செய்த எண். அது அழைப்பு வரலாற்றில் அழைப்பின் இலக்காகச் சேமிக்கப்படும்; ஏஜென்ட் அதை தனது சொந்த எண்ணாகக் காணும்.
• variables (விருப்பமானது) ஏஜென்ட்டின் prompt-இல் உள்ள {{placeholders}}-ஐ வெளிச்செல்லும் அழைப்புகள் போலவே நிரப்பும்.
• call_id என்பது அழைப்பு இணைந்த பிறகு அழைப்பு வரலாற்றில் இருக்கும் அழைப்பின் id (GET /v1/calls/{call_id}) ஆகும்.

2. URI-ஐ டயல் செய்யுங்கள்#

5 நிமிடங்களுக்குள் அழைப்பை sip_uri-க்கு அனுப்புங்கள். URI ஒரு அழைப்புக்கு மட்டுமே செயல்படும்: ஒரு அழைப்பு அதைப் பயன்படுத்தியவுடன், அந்த அழைப்பு விரைவாக முடிந்தாலும் அது பயன்படுத்தப்பட்டதாகிவிடும்.

உதாரணமாக, Twilio-வில் நீங்கள் ஒப்படைக்க விரும்பும் அழைப்புக்கு இந்த TwiML-ஐ வழங்குங்கள்:

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

PBX-இலிருந்து, URI-ஐ SIP இலக்காக டயல் செய்யுங்கள். பயனர்பெயரோ கடவுச்சொல்லோ தேவையில்லை; டோக்கனே சான்றாகும். எனவே அது பயன்படுத்தப்படும் வரை URI-ஐ கடவுச்சொல் போலக் கையாளுங்கள்.

SIP எண்ட்பாயிண்ட் (நிரந்தர முகவரி)#

1. எண்ட்பாயிண்ட்டை உருவாக்கவும்#

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. உங்கள் சிஸ்டத்தை அதனுடன் இணைக்கவும்#

பின்வருவனவற்றுடன் ஒரு SIP டிரங்க் அல்லது இலக்கை கட்டமைக்கவும்:

இந்த டிரான்ஸ்போர்ட் மற்றும் கோடெக் அமைப்புகள் ஒவ்வொரு அழைப்புக்கான URI-களுக்கும் பொருந்தும். இரண்டு வகை முகவரிகளுக்கும் பின்வரும் இரண்டு நெட்வொர்க் விவரங்கள் முக்கியம்:

• Record-Route-ஐப் பின்பற்றவும். முதல் INVITE-க்குப் பிறகு, அழைப்பின் மீதமுள்ள சிக்னலிங் (ACK, அழைப்பு முடித்தல், பரிமாற்றங்கள்) பதிலளித்த குறிப்பிட்ட ThunderPhone சர்வருக்குச் செல்லும்; அந்த சர்வர் Record-Route ஹெடரில் (sip-1.thunderphone.com அல்லது sip-2.thunderphone.com, அல்லது அதன் IP முகவரி) குறிப்பிடப்பட்டிருக்கும். நீங்கள் வெளிச்செல்லும் SIP-ஐக் கட்டுப்படுத்தினால், sip.thunderphone.com உடன் இந்த ஹோஸ்ட்களையும் அனுமதிக்கவும்: 172.170.39.202 (sip), 13.86.104.121 (sip-1) மற்றும் 20.80.98.90 (sip-2).
• ஆடியோ வேறிடத்திற்குச் செல்லும். sip.thunderphone.com சிக்னலிங்கை மட்டுமே ஏந்துகிறது. SDP பதிலில் உள்ள முகவரிகள் மற்றும் போர்ட்களுக்கு மீடியா (RTP) அணுகலை அனுமதிக்கவும்.

முகவரிக்கான ஒவ்வொரு அழைப்பும், உங்கள் தரப்பில் அழைப்பாளர் எந்த எண்ணை டயல் செய்திருந்தாலும், எண்ட்பாயிண்ட்டின் ஏஜென்ட்டை அடையும். நீங்கள் எண்களை இறக்குமதி செய்வதில்லை; எனவே உங்கள் தரப்பில் அவற்றை மாற்றுவதற்கு ThunderPhone-இல் எந்த மாற்றமும் தேவையில்லை.

டயல் செய்யப்பட்ட எண்ணை அனுப்பவும் (விருப்பத்தேர்வு)#

அழைப்பாளர் உங்கள் எண்களில் எதை டயல் செய்தார் என்பதைப் பதிவுசெய்ய, INVITE-இல் X-Original-To ஹெடரில் (எடுத்துக்காட்டாக X-Original-To: +14155550142) அல்லது நிலையான Diversion ஹெடரில் அதை அனுப்பவும். ThunderPhone அதை அழைப்பின் இலக்காகச் சேமிக்கும்.

இலக்கு இந்த வரிசையில் தேர்ந்தெடுக்கப்படுகிறது: ஒவ்வொரு அழைப்புக்கான URI பதிவுசெய்யப்பட்டபோது வழங்கப்பட்ட to_number, பின்னர் X-Original-To-வில் உள்ள எண், அதன் பிறகு Diversion-இல் உள்ள எண். இவற்றில் எதிலும் எண் கிடைக்கவில்லை என்றால், எண்ட்பாயிண்ட்டுக்கு sip:agent-12-jhxmginwjx (எண்ட்பாயிண்ட்டின் முகவரி) அல்லது ஒவ்வொரு அழைப்புக்கான URI-க்கு sip:call எனக் காட்டப்படும்.

Twilio மூலம் SIP URI-யில் ஹெடரைச் சேர்க்கலாம்: sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tcp?X-Original-To=%2B14155550142.

மூல IP-களைக் கட்டுப்படுத்தவும் (விருப்பத்தேர்வு)#

பயனர்பெயர் மற்றும் கடவுச்சொல்லுடன் கூடுதலாக, உங்கள் சொந்த சிக்னலிங் முகவரிகளிலிருந்து வரும் அழைப்புகளை மட்டுமே ஏற்க allowed_source_cidrs-ஐ அமைக்கவும்:

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

வேறு எந்த முகவரியிலிருந்தும் வரும் அழைப்புகள் ஏஜென்ட்டை அடைவதற்கு முன்பே நிராகரிக்கப்படும். உங்கள் மீடியா முகவரிகளை அல்லாமல், உங்கள் சிஸ்டம் SIP சிக்னலிங்கை அனுப்பும் முகவரிகளைப் பயன்படுத்தவும் (Twilio போன்ற கேரியருக்கு, அதன் வெளியிடப்பட்ட சிக்னலிங் IP வரம்புகள்).

அழைப்பாளர்களும் உங்கள் அமைப்பும் பார்ப்பவை#

• அழைப்பாளர் ID: From ஹெடரின் பயனர் பகுதி அழைப்பாளராகச் சேமிக்கப்படும். ஒரு தொலைபேசி எண் (எண்கள், விருப்பமாக +, இடைவெளிகள், கோடுகள், புள்ளிகள் அல்லது அடைப்புக்குறிகளுடன்) E.164 வடிவத்திற்குச் சீராக்கப்படும்; SIP பயனர்பெயர் போன்ற பிற அனைத்தும் அனுப்பியபடியே வைக்கப்படும். அதிகபட்சம் 32 எழுத்துகள் வைக்கப்படும், மேலும் அழைப்பாளர் இல்லையெனில் anonymous எனச் சேமிக்கப்படும்.
• நிராகரிக்கப்பட்ட அழைப்புகள்: அறியப்படாத அல்லது காலாவதியான ஒவ்வொரு-அழைப்புக்கான URI-க்கு SIP 404 Not Found கிடைக்கும். ஏற்கனவே பயன்படுத்தப்பட்ட ஒவ்வொரு-அழைப்புக்கான URI, முடக்கப்பட்ட எண்ட்பாயிண்ட், அல்லது அனுமதிப்பட்டியலுக்கு வெளியிலுள்ள மூலத்திலிருந்து வரும் அழைப்பு (அனுமதிப்பட்டியலுள்ள எண்ட்பாயிண்ட்டிற்கான எந்த UDP அழைப்பும் உட்பட) ஏஜென்ட் தொடங்குவதற்கு முன் துண்டிக்கப்படும்: உங்கள் அமைப்பில் அழைப்பு தோல்வியடைவதாகத் தோன்றலாம் அல்லது இணைந்தவுடன் உடனடியாக முடிவடையலாம். இந்த நிராகரிப்புகள் அழைப்பு வரலாற்றுப் பதிவை உருவாக்காது. உங்கள் நிறுவனத்தில் கிரெடிட் இல்லையெனில் அல்லது அதன் செலவு வரம்பை எட்டியிருந்தால், அழைப்பு நிராகரிக்கப்படும்; கட்டணமின்றி தோல்வியடைந்த அழைப்பாக அழைப்பு வரலாற்றில் காட்டப்படும். ஒவ்வொரு-அழைப்புக்கான முயற்சியை மீண்டும் செய்ய, புதிய URI-ஐப் பதிவு செய்யவும்.
• பரிமாற்றங்கள்: ஏஜென்ட்டின் கோல்டு பரிமாற்றங்கள் செயல்படும் (ThunderPhone ஒரு SIP REFER அனுப்பும்; அதை உங்கள் அமைப்பு ஏற்க வேண்டும்). இரண்டாவது கட்டத்திற்கான அழைப்பாளர் ID-ஆகக் காட்ட ThunderPhone எண் இல்லாததால், SIP முகவரி அழைப்புகளில் வார்ம் பரிமாற்றங்கள் கிடைக்காது. Twilio உடன், மேலே உள்ள TwiML ஏஜென்ட்டை இணைக்கும், ஆனால் பரிமாற்றங்களைக் கையாளாது: <Dial>-இல் referUrl="https://YOUR_SERVER/sip-transfer" ஐச் சேர்த்து, அந்த வெப்ஹுக் ReferTransferTarget ஐப் படித்து, பரிமாற்ற இலக்கிற்கு அழைக்கும் TwiML-ஐத் திருப்பி அனுப்புமாறு அமைக்கவும் (Twilio-வின் SIP REFER வழிகாட்டியைப் பார்க்கவும்).
• உரைச் செய்திகள்: SIP முகவரியும் அழைக்கப்பட்ட எண்ணும் உரைச் செய்திகளை அனுப்ப முடியாது. SIP முகவரி அழைப்பின்போது ஏஜென்ட் உரைச் செய்தி அனுப்புவது, உரைச் செய்திக்காகத் தனியாக SMS-திறனுள்ள எண் அமைக்கப்பட்டிருந்தால் மட்டுமே சாத்தியம்; இல்லையெனில் அதன் SMS கருவி கிடைக்காது.
• பதிவு: ThunderPhone SIP REGISTER ஐ ஏற்காது. அந்த முகவரிக்கு அழைப்புகளை அனுப்பவும்; அதில் பதிவு செய்ய வேண்டாம்.

விலை நிர்ணயம்#

SIP முகவரி அழைப்புகளுக்கு ஏஜென்ட்டின் வழக்கமான நிமிடக் கட்டணம் விதிக்கப்படும். அழைப்பை எந்த ThunderPhone எண்ணும் ஏற்காததால், தொலைபேசி எண் கட்டணம் இல்லை. உங்கள் சொந்த கேரியர் அழைப்பின் அதன் பகுதியை வழக்கம்போல் கட்டணமிடும். விலை நிர்ணயத்தைப் பார்க்கவும்.

சோதிக்கவும்#

1. மேலே குறிப்பிட்டபடி ஒவ்வொரு-அழைப்புக்கான URI அல்லது ஒரு எண்ட்பாயிண்ட்டை உருவாக்கவும்.
2. உங்கள் அமைப்பிலிருந்து அல்லது எந்த SIP சாஃப்ட்ஃபோனிலிருந்தும் அதை அழைக்கவும் (எண்ட்பாயிண்ட்டிற்கு, பயனர்பெயர் மற்றும் கடவுச்சொல்லை உள்ளிடவும்).
3. அழைப்பை முடித்த பிறகு, டாஷ்போர்டில் உள்ள அழைப்புகள் பகுதியில் அழைப்பைத் திறக்கவும் அல்லது GET /v1/calls/{call_id} மூலம் பெறவும். இதில் அழைப்பாளர், இலக்கு ("அழைக்கப்பட்ட எண்ணை அனுப்பவும்" என்பதன் கீழுள்ள வரிசையைப் பார்க்கவும்), மற்றும் உரையாடல் பதிவு காட்டப்படும்.

API விவரங்கள்: SIP முகவரிகள் API குறிப்பு.