Open in
Twilio இலிருந்து இணைக்கவும்
CallSid உடன் Twilio அழைப்புகளை SIP வழியாக ThunderPhone ஏஜென்டிற்கு அனுப்பி, பரிமாற்ற முகவரியில் hand-off உடன் உங்கள் referUrl மூலம் அவற்றை மீண்டும் பெறுங்கள்.
உங்கள் TwiML, அழைப்பின் CallSid-ஐ ஒரு ஹெடரில் சேர்த்து ஏஜென்ட்டின் SIP முகவரியை டயல் செய்கிறது.
அழைப்பாளருக்கு ஒருவர் தேவைப்படும்போது, ஏஜென்ட் ஒரு SIP REFER-ஐ அனுப்புகிறது; Twilio, அதில் உள்ள ஒப்படைப்பு விவரத்துடன் பரிமாற்ற முகவரியை உங்கள் referUrl ஹேண்ட்லருக்கு அனுப்புகிறது, மேலும் உங்கள் ஹேண்ட்லர் திருப்பும் TwiML, அழைப்பாளர் எங்கு செல்ல வேண்டும் என்பதைத் தீர்மானிக்கிறது, உதாரணமாக ஒரு Flex வரிசைக்கு.
தொடங்குவதற்கு முன்
- ஒரு ThunderPhone ஏஜென்ட் மற்றும் ஒரு நிறுவனத்தின் API விசை.
- Twilio Programmable Voice, மேலும் TwiML மற்றும் ஒரு
referUrlஹேண்ட்லரை வழங்குவதற்கான இடம்: உங்கள் சொந்த சர்வர் அல்லது ஒரு TwiML Bin மற்றும் ஒரு Twilio Function. Flex விருப்பமானது.
1. SIP எண்ட்பாயிண்ட்டை உருவாக்கவும்
Twilio-வின் <Sip> ஒரு பயனர்பெயர் மற்றும் கடவுச்சொல்லைப் பெறுகிறது, எனவே ஒரு நிலையான எண்ட்பாயிண்ட்டைப் பயன்படுத்தவும்:
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": "Twilio"}'பதிலிலுள்ள password-ஐ உடனடியாகச் சேமிக்கவும்; அது ஒருமுறை மட்டுமே காட்டப்படும். Twilio-விலிருந்து மட்டும் அழைப்புகளை ஏற்கவும் விரும்பினால்,
மூல IP-களை வரம்பிடுக என்பதைப் பார்க்கவும்.
2. சூழலுடன் அழைப்புகளை அனுப்பவும்
ஏஜென்ட்டிடம் ஒப்படைக்க விரும்பும் அழைப்புக்காக இந்த TwiML-ஐத் திருப்பி அனுப்பவும்:
<Response>
<Dial answerOnBridge="true" referUrl="https://YOUR_SERVER/thunderphone-refer">
<Sip username="tp409667538f83" password="YOUR_ENDPOINT_PASSWORD">sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls?X-Call-ID={{CallSid}}</Sip>
</Dial>
</Response>;transport=tlsமுக்கியமானது: வேறுவிதமாகக் கூறாவிட்டால் Twilio UDP-ஐப் பயன்படுத்தும்.X-Call-IDஎன்பதுCallSid-ஐக் கொண்டுள்ளது. Twilio தனக்கென ஒரு கால்-ID ஹெடரை ஆவணப்படுத்தவில்லை, எனவே இதைச் சேர்க்கவும்: ThunderPhone இதை அழைப்பின்external_call_idஆகச் சேமிக்கிறது.{{CallSid}}ஒரு TwiML Bin-இல் செயல்படும்; உங்கள் சொந்த சர்வரிலிருந்து வழங்கும்போது, உள்வரும் கோரிக்கையின்CallSid-ஐ எழுதவும்.&X-Account-Id=12345போன்ற கூடுதல் சூழலை இதே முறையில் சேர்க்கவும். TwiML-இல்,&-ஐ&என எழுதவும், ஏனெனில் தனியான&தவறான XML ஆகும். ஒவ்வொன்றும் prompt-ஐ ஒரு மாறியாக அடையும்; இங்கு அது{{sip_x_account_id}}. Twilio,x-ஹெடர்கள் மற்றும்User-to-User-ஐ அனுமதிக்கிறது; அவை சதவீத-குறியாக்கப்பட்டதாக இருக்க வேண்டும்; முழு URI 255 எழுத்துகளுக்குக் குறைவாகவும் ஹெடர்கள் 1,024 எழுத்துகளுக்குக் குறைவாகவும் இருக்க வேண்டும்.referUrl, ஏஜென்ட்டின்REFER-ஐ Twilio ஏற்க அனுமதிக்கிறது; இது இல்லையெனில் பரிமாற்றம் பிழை 13802 உடன் தோல்வியடையும்.answerOnBridge="true"புதிய இலக்கு பதிலளிக்கும் வரை அழைப்பாளரை இணைத்தே வைத்திருக்கும்; எனவே தோல்வியடைந்த பரிமாற்றம் மாற்று வழிக்குச் செல்லலாம்.
Studio-வின் அழைப்பை இதனுடன் இணைக்கவும் விட்ஜெட் தனிப்பயன் ஹெடர்கள் அல்லது
referUrl-ஐ ஆவணப்படுத்தவில்லை; எனவே Studio-விலிருந்து அழைப்பை இந்த TwiML-க்கு ஒப்படைக்கவும், உதாரணமாக ஒரு
TwiML வழிமாற்று விட்ஜெட்டைப் பயன்படுத்தி.
3. அழைப்பை மீண்டும் பெறுக
ஏஜென்ட், கையளிப்பு அடையாளம் மற்றும் நோக்கத்தைக் கொண்ட பரிமாற்ற முகவரியுடன் REFER மூலம் மாற்றுகிறது. இந்தப் பரிமாற்ற எண்ணைச் சேர்க்கவும் (பார்க்கவும்
பரிமாற்ற எண்ணைச் சேர்க்கவும்
மற்றும் பரிமாற்ற முகவரிக்குள் உள்ள தலைப்புகள்):
{
"name": "Twilio support",
"number": "sip:support@acme.sip.twilio.com",
"headers": {"X-Handoff-Id": "{{handoff_id}}", "X-Handoff-Intent": "{{handoff_intent}}"},
"headers_in_uri": true
}Twilio முழு முகவரியையும் உங்கள் referUrl-க்கு ReferTransferTarget ஆக அனுப்புகிறது, உதாரணமாக <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>.
உங்கள் ஹேண்ட்லர் அதிலிருந்து தலைப்புகளைப் படித்து, அழைப்பாளர் அடுத்து செல்ல வேண்டிய இடத்திற்கான TwiML-ஐ வழங்குகிறது. முகவரியின் பயனர் பகுதியை (support) நீங்கள் தேர்ந்தெடுக்கலாம்; எனவே ஒவ்வொரு இலக்கிற்கும் ஒரு பரிமாற்ற எண்ணைச் சேர்த்து, அதன் அடிப்படையில் வழிமாற்றலாம்.
இந்த Twilio செயல்பாடு, கையளிப்பை பணி பண்புக்கூறுகளாகக் கொண்டு அழைப்பாளரை Flex வரிசையில் சேர்க்கிறது மற்றும் கையளிப்பு அடையாளத்தின் மூலம் சுருக்கத்தைத் தேடுகிறது. Studio-வின் HTTP Request விட்ஜெட்டால் Authorization தலைப்பை அனுப்ப முடியாததால், தேடல் ஒரு செயல்பாட்டில் இயங்குகிறது:
exports.handler = async (context, event, callback) => {
const target = (event.ReferTransferTarget || "").replace(/^<|>$/g, "");
const params = new URLSearchParams(target.split("?")[1] || "");
const handoffId = params.get("X-Handoff-Id") || "";
const attributes = { handoff_id: handoffId, intent: params.get("X-Handoff-Intent") || "" };
if (handoffId) {
const response = await fetch(
"https://api.thunderphone.com/v1/calls/handoff?handoff_id=" + encodeURIComponent(handoffId),
{ headers: { Authorization: "Bearer " + context.THUNDERPHONE_API_KEY } }
);
if (response.ok) {
const call = await response.json();
attributes.summary = (call.handoff && call.handoff.summary) || "";
}
}
const twiml = new Twilio.twiml.VoiceResponse();
twiml.enqueue({ workflowSid: context.FLEX_WORKFLOW_SID }).task({}, JSON.stringify(attributes));
callback(null, twiml);
};API விசையை செயல்பாட்டின் சூழல் மாறிகளில் வைத்திருங்கள். மற்ற புலங்களுக்கு கையளிக்கப்பட்ட அழைப்பைத் தேடுக பார்க்கவும்.
இதைச் சோதிக்கவும்
மேலுள்ள TwiML-ஐ வழங்கும் Twilio எண்ணை அழைக்கவும், ஒரு நபருடன் பேச ஏஜென்ட்டிடம் கேட்கவும், உங்கள் referUrl ஹேண்ட்லர் இரண்டு தலைப்புகளுடனும் ReferTransferTarget-ஐப் பெறுகிறதா மற்றும் அழைப்பாளர் வரிசையை அடைகிறாரா என்பதைச் சரிபார்க்கவும். பின்னர் GET /v1/calls/{call_id} மூலம் அழைப்பைத் திறக்கவும்: external_call_id, CallSid ஆக இருக்க வேண்டும்.
வரம்புகள்
- Twilio,
Refer-To-வை 256 எழுத்துகளுக்கு வரம்பிடுகிறது. ThunderPhone முகவரியை 254 எழுத்துகளுக்குள் வைத்துக்கொண்டு, பொருந்தாத தலைப்பை விடுத்துவிடுகிறது; எனவே தலைப்புப் பெயர்களையும் மதிப்புகளையும் சுருக்கமாக வைத்திருங்கள். BYE-இல் தலைப்புகளைப் படிப்பதை Twilio ஆவணப்படுத்தவில்லை; எனவே திரும்பும் அழைப்பு கையளிப்பை மீண்டும் Twilio-க்கு எடுத்துச் செல்ல முடியாது. மேலே உள்ளபடிREFERபயன்படுத்தவும்.<Conference>அல்லது<Queue>மூலம் இணைக்கப்பட்ட அழைப்பில் TwilioREFER-ஐ ஏற்காது; எனவே மேலே உள்ளபடி<Dial><Sip>மூலம் ஏஜென்ட்டை அழைக்கவும்.