ThunderPhone v3 లైవ్‌లోకి వచ్చింది.మీరే ప్రారంభించవచ్చు—నిమిషానికి 2¢ నుంచి.ప్రకటనను చదవండి

Contact centers

Microsoft Dynamics 365 నుండి కనెక్ట్ చేయండి

X-హెడర్‌లతో మీ SBC ద్వారా Dynamics 365 Contact Center మరియు Copilot Studio కాల్‌లను ThunderPhone ఏజెంట్‌కు పంపండి, అలాగే HTTP ద్వారా ఏజెంట్ హ్యాండ్-ఆఫ్‌ను పొందండి.

Dynamics 365 Contact Center కాలర్‌ను సంభాషణ idతో సహా గరిష్ఠంగా ఐదు X-హెడర్‌లతో మీ సెషన్ బోర్డర్ కంట్రోలర్ (SBC) ద్వారా ఏజెంట్‌కు పంపుతుంది. ఏజెంట్ పని పూర్తిచేసినప్పుడు, అది కాల్‌ను ముగిస్తుంది, మీ SBC కాలర్‌ను తిరిగి Dynamics 365లోకి తీసుకువస్తుంది, మరియు ఒక HTTP రిక్వెస్ట్ నోడ్ హ్యాండ్-ఆఫ్‌ను పొందుతుంది.

ప్రారంభించే ముందు

  • ఒక 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 డైజెస్ట్ ప్రామాణీకరణ చేయలేకపోతే, బదులుగా authను ip_allowlistగా మరియు మీ SBC పబ్లిక్ చిరునామాగా సెట్ చేసి ఎండ్‌పాయింట్‌ను సృష్టించండి; చూడండి మూల IP ద్వారా ప్రామాణీకరించే ప్లాట్‌ఫారమ్‌లు.

2. సందర్భంతో కాల్‌లను పంపండి

  1. మీ SBCలో ఏజెంట్ కోసం ఒక ఫోన్ నంబర్‌ను ఎంచుకోండి, ఉదాహరణకు +14155550188.
  2. SBCలో, ఆ నంబర్‌కు వచ్చే కాల్‌లను ఎండ్‌పాయింట్ sip_uriకు రూట్ చేయండి, ఉదాహరణకు sip:agent-12-jhxmginwjx@sip.thunderphone.com, పోర్ట్ 5061లో TLS ద్వారా. ThunderPhone యూజర్ భాగం ద్వారా ఎండ్‌పాయింట్‌ను కనుగొంటుంది (agent-12-jhxmginwjx), ఇది రిక్వెస్ట్ URI మరియు To హెడర్ రెండింటిలోనూ ఉండాలి. X-హెడర్‌లను మార్పులు లేకుండా పంపండి.
  3. Copilot Studioలో, ఆ నంబర్‌కు బాహ్య ఫోన్ నంబర్ బదిలీతో ఒక సంభాషణను బదిలీ చేయి నోడ్‌ను జోడించి, X-హెడర్‌లను జోడించండి:
    • X-Call-ID: Dynamics 365 సంభాషణ id. ఏ Microsoft హెడర్‌లోనూ ఇది ఉండదు, కాబట్టి దీన్ని ఇక్కడ జోడించండి; ThunderPhone దీన్ని కాల్ external_call_idగా నిల్వ చేస్తుంది. సంభాషణ idని ఏ వేరియబుల్ కలిగి ఉందో Copilot Studioలో నిర్ధారించండి.
    • X-Customer-Tier వంటి మరో నాలుగు వరకు.

Microsoft అక్షరాలు, అంకెలు మరియు = ; . ! % * _ + ~ - ఉపయోగించి, గరిష్ఠంగా 64 అక్షరాల పేర్లు మరియు గరిష్ఠంగా 256 విలువలతో ఐదు X-హెడర్‌ల వరకు పంపుతుంది. ఇది ఉపసర్గను చిన్న అక్షరాల 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 ఒక విధానాన్ని డాక్యుమెంట్ చేసింది: Dynamics 365లో నమోదు చేసిన నంబర్‌కు SBC ద్వారా కొత్త కాల్, మీరు వర్క్‌స్ట్రీమ్‌లు → అధునాతన సెట్టింగ్‌లు కింద సెట్ చేసిన సందర్భ వేరియబుల్‌లకు సరిపోలే కీలతో కూడిన UUI (థర్డ్-పార్టీ IVR బదిలీ). ThunderPhone కాల్‌ను ముగించినప్పుడు కాలర్ ఆ నంబర్‌కు ఎలా చేరుతారో మీ SBC విక్రేతతో నిర్ణయించండి, అలాగే మీరు X-Call-IDలో పంపిన సంభాషణ idని తీసుకెళ్లండి, తద్వారా ఫ్లో కాల్‌ను కనుగొనగలదు.

తర్వాత Copilot Studio HTTP అభ్యర్థన నోడ్‌తో హ్యాండ్-ఆఫ్‌ను పొందండి:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= తర్వాత సంభాషణ 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 సంభాషణ id అయి ఉండాలి. కాల్ ఏజెంట్‌కు ఎప్పుడూ చేరకపోయి మీ SBC లాగ్‌లు SIP 404 చూపిస్తే, దాని అభ్యర్థన URI లేదా To హెడర్‌లో ఎండ్‌పాయింట్ యూజర్ భాగం లేదు.

పరిమితులు

  • SBC అవసరం. Microsoft SIP చిరునామాకు డయల్ చేయలేదు లేదా డైజెస్ట్ ఛాలెంజ్‌కు సమాధానం ఇవ్వలేదు.
  • Microsoft గరిష్ఠంగా ఐదు X-హెడర్‌లను పంపుతుంది మరియు లోపలికి వచ్చే కాల్‌లో మొదటి ఐదింటినే ఉంచుతుంది. Dynamics 365 గరిష్ఠంగా 128 అక్షరాల UUIని తీసుకుంటుంది.
  • BYEలో హెడర్‌లను చదవడాన్ని Microsoft డాక్యుమెంట్ చేయలేదు, కాబట్టి హ్యాండ్-ఆఫ్ లుక్‌అప్ ద్వారా మాత్రమే తిరిగి వస్తుంది.