Open in
Microsoft Dynamics 365-ൽ നിന്ന് കണക്റ്റ് ചെയ്യുക
X-headers ഉപയോഗിച്ച് നിങ്ങളുടെ SBC വഴി Dynamics 365 Contact Center, Copilot Studio കോളുകൾ ThunderPhone ഏജന്റിലേക്ക് അയയ്ക്കുക, കൂടാതെ HTTP വഴി ഏജന്റിന്റെ ഹാൻഡ്-ഓഫ് പരിശോധിക്കുക.
Dynamics 365 Contact Center, സംഭാഷണ ഐഡി ഉൾപ്പെടെ പരമാവധി അഞ്ച് X-ഹെഡറുകളോടെ, നിങ്ങളുടെ സെഷൻ ബോർഡർ കൺട്രോളർ (SBC) വഴി വിളിക്കുന്നയാളെ ഏജന്റിലേക്ക് അയയ്ക്കുന്നു. ഏജന്റിന്റെ ജോലി പൂർത്തിയായാൽ, അത് കോൾ വിച്ഛേദിക്കുന്നു, നിങ്ങളുടെ SBC വിളിക്കുന്നയാളെ Dynamics 365-ലേക്ക് തിരികെ കൊണ്ടുവരുന്നു, തുടർന്ന് ഒരു HTTP Request നോഡ് കൈമാറ്റം ലഭ്യമാക്കുന്നു.
ആരംഭിക്കുന്നതിന് മുമ്പ്
- ഒരു ThunderPhone ഏജന്റും ഒരു ഓർഗനൈസേഷൻ API കീ.
- നിങ്ങൾ പ്രവർത്തിപ്പിക്കുന്ന SBC-യിലേക്ക് Azure Communication Services ഡയറക്ട് റൂട്ടിംഗ് വഴി കണക്റ്റ് ചെയ്ത Dynamics 365 Contact Center വോയ്സ് ചാനൽ (SBC ആവശ്യകതകൾ): പബ്ലിക് സർട്ടിഫിക്കറ്റുള്ള പിന്തുണയ്ക്കുന്ന SBC, പോർട്ട് 5061-ൽ TLS 1.2, കൂടാതെ Microsoft-ലേക്കുള്ള SRTP.
- സംഭാഷണം കൈമാറുക നോഡിലെ SIP X-ഹെഡർ പിന്തുണ (Copilot Studio). ഇത് നിങ്ങളുടെ എൻവയോൺമെന്റിൽ ലഭ്യമാണെന്ന് സ്ഥിരീകരിക്കുക.
Dynamics 365 ഒരു ഫോൺ നമ്പറിലേക്കു മാത്രമേ കൈമാറൂ, കൂടാതെ Microsoft ഡയറക്ട് റൂട്ടിംഗ് പാസ്വേഡ് ഉപയോഗിച്ചല്ല, സർട്ടിഫിക്കറ്റ് ഉപയോഗിച്ചാണ് ഓതന്റിക്കേറ്റ് ചെയ്യുന്നത്. നിങ്ങളുടെ SBC, Microsoft-നും ThunderPhone-നും ഇടയിൽ സ്ഥിതിചെയ്ത് ആ നമ്പറിനെ ഏജന്റിന്റെ SIP വിലാസമാക്കി മാറ്റുന്നു.
1. SIP എൻഡ്പോയിന്റ് സൃഷ്ടിക്കുക
കോൾ നിങ്ങളുടെ SBC-യിൽ നിന്ന് ThunderPhone-ലേക്ക് എത്തുന്നതിനാൽ, SBC ഉപയോഗിക്കുന്നതിന് ഒരു സ്റ്റാൻഡേർഡ് എൻഡ്പോയിന്റ് സൃഷ്ടിക്കുക:
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": "Dynamics 365 SBC"}'റെസ്പോൺസിൽ നിന്നുള്ള password ഉടൻ തന്നെ സൂക്ഷിക്കുക; അത് ഒരിക്കൽ മാത്രമേ കാണിക്കൂ, നിങ്ങളുടെ
SBC അതുപയോഗിച്ച് ThunderPhone-ന്റെ ചലഞ്ചിനോട് പ്രതികരിക്കുന്നു. നിങ്ങളുടെ SBC-ക്ക് digest
authentication ചെയ്യാൻ കഴിയുന്നില്ലെങ്കിൽ, പകരം auth ip_allowlist ആയി സജ്ജമാക്കിയും നിങ്ങളുടെ
SBC-യുടെ പബ്ലിക് വിലാസം നൽകിയും എൻഡ്പോയിന്റ് സൃഷ്ടിക്കുക; കാണുക
സോഴ്സ് IP ഉപയോഗിച്ച് ഓതന്റിക്കേറ്റ് ചെയ്യുന്ന പ്ലാറ്റ്ഫോമുകൾ.
2. കോൺടെക്സ്റ്റോടെ കോളുകൾ അയയ്ക്കുക
- നിങ്ങളുടെ SBC-യിൽ ഏജന്റിനായി ഒരു ഫോൺ നമ്പർ തിരഞ്ഞെടുക്കുക, ഉദാഹരണത്തിന്
+14155550188. - SBC-യിൽ, ആ നമ്പറിലേക്കുള്ള കോളുകൾ എൻഡ്പോയിന്റിന്റെ
sip_uri-ലേക്ക് റൂട്ട് ചെയ്യുക, ഉദാഹരണത്തിന് TLS ഉപയോഗിച്ച് പോർട്ട്5061-ലെsip:agent-12-jhxmginwjx@sip.thunderphone.com. ThunderPhone എൻഡ്പോയിന്റിനെ യൂസർ ഭാഗം ഉപയോഗിച്ച് കണ്ടെത്തുന്നു (agent-12-jhxmginwjx); ഇത് റിക്വസ്റ്റ് URI-യിലുംToഹെഡറിലും ഉണ്ടായിരിക്കണം. X-ഹെഡറുകൾ മാറ്റമില്ലാതെ കൈമാറുക. - Copilot Studio-യിൽ, ആ നമ്പറിലേക്കുള്ള ബാഹ്യ ഫോൺ നമ്പർ കൈമാറ്റം ഉപയോഗിച്ച് ഒരു
സംഭാഷണം കൈമാറുക നോഡ് ചേർക്കുക, തുടർന്ന് X-ഹെഡറുകൾ ചേർക്കുക:
X-Call-ID: Dynamics 365 സംഭാഷണ ഐഡി. ഒരു Microsoft ഹെഡറും ഇത് ഉൾക്കൊള്ളുന്നില്ല, അതിനാൽ ഇത് ഇവിടെ ചേർക്കുക; ThunderPhone ഇത് കോളിന്റെexternal_call_idആയി സംഭരിക്കുന്നു. സംഭാഷണ ഐഡി ഏത് വേരിയബിളിലാണ് ഉള്ളതെന്ന് Copilot Studio-യിൽ സ്ഥിരീകരിക്കുക.X-Customer-Tierപോലെയുള്ള പരമാവധി നാല് എണ്ണം കൂടി.
Microsoft പരമാവധി അഞ്ച് X-ഹെഡറുകൾ അയയ്ക്കുന്നു; പേരുകൾക്ക് പരമാവധി 64 പ്രതീകങ്ങളും
മൂല്യങ്ങൾക്ക് പരമാവധി 256 പ്രതീകങ്ങളും, = ; . ! % * _ + ~ - ഉൾപ്പെടെയുള്ള അക്ഷരങ്ങളും
അക്കങ്ങളും ഉപയോഗിച്ചാണ്. ഇത് പ്രിഫിക്സ് ചെറിയ അക്ഷരത്തിലുള്ള x- ആയി എഴുതുന്നു;
ThunderPhone ഹെഡർ പേരുകൾ കേസ് പരിഗണിക്കാതെ പൊരുത്തപ്പെടുത്തുന്നു, അതിനാൽ
x-customer-tier prompt-ൽ {{sip_x_customer_tier}} ആയി എത്തുന്നു.
പകരം Azure Communication Services Call Automation ഉപയോഗിച്ച് നിങ്ങൾ കോൾ നിർമ്മിക്കുകയാണെങ്കിൽ,
AddSipX ഡിഫോൾട്ടായി X-MS-Custom- പേരുകൾ എഴുതുന്നു. X-Call-ID അതിന്റെ പേര് നിലനിർത്താൻ
SipHeaderPrefix.X നൽകുക
(ഇഷ്ടാനുസൃത കോൺടെക്സ്റ്റ്).
3. കോൾ തിരികെ നേടുക
ഏജന്റ് കോൾ തിരികെ കൈമാറുന്നു: അത് വിടപറഞ്ഞ് കോൾ അവസാനിപ്പിക്കുന്നു. ഈ ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക (കാണുക ട്രാൻസ്ഫർ നമ്പർ ചേർക്കുക):
{"name": "Dynamics 365", "action": "return"}കോളറെ Dynamics 365-ലേക്ക് തിരികെ എത്തിക്കുന്നത് നിങ്ങളുടെ SBCയുടെ ചുമതലയാണ്. കോൺടെക്സ്റ്റോടുകൂടിയ ഒരു കോളിനുള്ള പ്രവേശന മാർഗം Microsoft രേഖപ്പെടുത്തുന്നു: നിങ്ങൾ
വർക്ക്സ്ട്രീമുകൾ → വിപുലമായ ക്രമീകരണങ്ങൾ എന്നതിൽ സജ്ജീകരിച്ച കോൺടെക്സ്റ്റ് വേരിയബിളുകളുമായി കീസുകൾ പൊരുത്തപ്പെടുന്ന UUI ഉൾപ്പെടെ, SBC വഴി Dynamics 365-ൽ രജിസ്റ്റർ ചെയ്ത ഒരു നമ്പറിലേക്കുള്ള പുതിയ കോൾ
(മൂന്നാം കക്ഷി IVR ട്രാൻസ്ഫർ).
ThunderPhone കോൾ അവസാനിപ്പിക്കുമ്പോൾ കോളർ ആ നമ്പറിലെത്തുന്നത് എങ്ങനെയെന്ന് നിങ്ങളുടെ SBC വെണ്ടറുമായി തീരുമാനിക്കുക, കൂടാതെ ഫ്ലോയ്ക്ക് കോൾ കണ്ടെത്താനായി നിങ്ങൾ X-Call-ID-ൽ അയച്ച സംഭാഷണ ഐഡി കൈമാറുക.
തുടർന്ന് Copilot Studio HTTP Request നോഡ് ഉപയോഗിച്ച് കൈമാറ്റ വിവരങ്ങൾ നേടുക:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=എന്നതിനുശേഷം സംഭാഷണ ഐഡി ചേർക്കുക.- ഹെഡർ
Authorization: Bearer sk_live_…. - പ്രതികരണം ഒരു വേരിയബിളിലേക്ക് പാഴ്സ് ചെയ്ത്
handoff.summary,handoff.intentഎന്നിവ ഉപയോഗിക്കുക.
കാണുക കൈമാറിയ കോൾ തിരയുക.
ഇത് പരിശോധിക്കുക
ട്രാൻസ്ഫർ നോഡിലെത്തുന്ന ഒരു Dynamics 365 നമ്പറിലേക്ക് കോൾ ചെയ്യുക, ഒരു വ്യക്തിയുമായി സംസാരിക്കാൻ ഏജന്റിനോട് ആവശ്യപ്പെടുക, കോളർ Dynamics 365-ലേക്ക് തിരികെ എത്തുന്നുണ്ടോ എന്ന് പരിശോധിക്കുക. തുടർന്ന് GET /v1/calls/{call_id} ഉപയോഗിച്ച് കോൾ തുറക്കുക: sip_headers-ൽ x-call-id പട്ടികപ്പെടുത്തണം, കൂടാതെ
external_call_id സംഭാഷണ ഐഡി ആയിരിക്കണം. കോൾ ഒരിക്കലും ഏജന്റിലെത്താതിരിക്കുകയും നിങ്ങളുടെ SBC SIP 404 രേഖപ്പെടുത്തുകയും ചെയ്യുന്നുവെങ്കിൽ, അതിന്റെ റിക്വസ്റ്റ് URI അല്ലെങ്കിൽ To ഹെഡറിൽ എൻഡ്പോയിന്റിന്റെ യൂസർ ഭാഗം ഉൾപ്പെട്ടിട്ടില്ല.
പരിധികൾ
- ഒരു SBC ആവശ്യമാണ്. Microsoft-ന് SIP വിലാസത്തിലേക്ക് ഡയൽ ചെയ്യാനോ ഡൈജസ്റ്റ് ചലഞ്ചിന് മറുപടി നൽകാനോ കഴിയില്ല.
- Microsoft പരമാവധി അഞ്ച് X-ഹെഡറുകൾ അയയ്ക്കുന്നു, കൂടാതെ അകത്തേക്ക് വരുന്ന കോളിൽ ആദ്യത്തെ അഞ്ച് മാത്രമേ സൂക്ഷിക്കൂ. Dynamics 365 പരമാവധി 128 പ്രതീകങ്ങളുള്ള UUI സ്വീകരിക്കുന്നു.
BYE-യിലെ ഹെഡറുകൾ വായിക്കുന്നതിനെക്കുറിച്ച് Microsoft രേഖപ്പെടുത്തുന്നില്ല, അതിനാൽ കൈമാറ്റ വിവരങ്ങൾ തിരയലിലൂടെ മാത്രമേ തിരികെ ലഭിക്കൂ.