ThunderPhone v3 এখন লাইভ।নিজেই ব্যবহার শুরু করুন, 2¢/মিনিট থেকে।ঘোষণাটি পড়ুন

Contact centers

Genesys Cloud থেকে সংযোগ করুন

কথোপকথনের id এবং UUI সহ একটি BYOC Cloud ট্রাঙ্কের মাধ্যমে Genesys Cloud কল ThunderPhone এজেন্টের কাছে পাঠান, এবং UUI-তে হ্যান্ড-অফ সহ সেগুলো ফিরিয়ে নিন।

আপনার Architect ফ্লো কলারকে একটি BYOC Cloud ট্রাঙ্কের মাধ্যমে এজেন্টের কাছে পাঠায়, সঙ্গে থাকে conversation id এবং আপনার সেট করা যেকোনো UUI। কলারের কোনো ব্যক্তির প্রয়োজন হলে এজেন্ট একটি SIP REFER পাঠায়, Genesys কলটি ফিরিয়ে নেয় এবং hand-off id কলের UUI-তে পৌঁছায়।

শুরু করার আগে

  • একটি ThunderPhone এজেন্ট এবং একটি organization API key।
  • BYOC Cloud-সহ Genesys Cloud এবং একটি external trunk (ধরন BYOC Carrier বা PBX), যেখানে এই সেটিংসগুলো চালু আছে (external trunk settings):
    • Conversation Headers, যাতে Genesys তার conversation id x-inin-cnv-এ পাঠায়। এটি ডিফল্টভাবে বন্ধ থাকে।
    • UUI Passthrough, যেখানে header type User-To-User এবং encoding Hex।
    • Take Back and Transfer, যাতে Genesys এজেন্টের REFER গ্রহণ করে।

1. SIP endpoint তৈরি করুন

Genesys একটি digest challenge-এর উত্তর দেয়, তাই একটি standard endpoint ব্যবহার করুন:

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": "Genesys Cloud"}'

response থেকে password সঙ্গে সঙ্গে সংরক্ষণ করুন; এটি একবারই দেখানো হয়। ট্রাঙ্কে:

সেটিংমান
SIP serversip.thunderphone.com, port 5061
ProtocolTLS
Digest authenticationendpoint-এর username এবং password
CodecsPCMU, PCMA বা G.722

আপনার site-এর এমন একটি outbound route-এ ট্রাঙ্কটি যুক্ত করুন, যার number plan ফ্লোটি যে address-এ ডায়াল করে তা কভার করে।

2. context-সহ কল পাঠান

আপনার Architect ফ্লোতে:

  1. ঐচ্ছিকভাবে, এজেন্টের জন্য context-সহ একটি Set UUI Data action যোগ করুন, যেমন account=12345। Genesys 128 বা তার কম অক্ষর ব্যবহারের পরামর্শ দেয়।
  2. endpoint-এর sip_uri দিয়ে একটি Transfer to Number action যোগ করুন, উদাহরণস্বরূপ sip:agent-12-jhxmginwjx@sip.thunderphone.com।

Genesys x-inin-cnv-এ conversation id পাঠায়। ThunderPhone এটি কলের external_call_id হিসেবে সংরক্ষণ করে। UUI decoded অবস্থায় {{sip_uui}} হিসেবে prompt-এ পৌঁছায়।

Trunk custom header Genesys-এ static, তাই প্রতি-কলের মান UUI-তে রাখুন। Genesys নিজের জন্য x-inin, x-genesys, x-pcv এবং x-gcv header prefix সংরক্ষিত রাখে।

3. কলটি ফিরিয়ে নিন

এজেন্ট Genesys-এর একটি address-এ REFER দিয়ে transfer করে, যেখানে সেই address-এর ভেতরে hex UUI হিসেবে hand-off id থাকে। এই transfer number যোগ করুন (দেখুন transfer number যোগ করুন এবং transfer address-এর ভেতরের header):

{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

address-টি এমন একটি address দিয়ে প্রতিস্থাপন করুন যা কলারকে গ্রহণ করার queue বা flow-তে ফিরে route করে; এর format Genesys-এর সঙ্গে নিশ্চিত করুন। REFER-টি এ রকম দেখায়:

Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>

Take Back and Transfer চালু থাকলে, Genesys ট্রাঙ্ক থেকে কলটি ফিরিয়ে নেয় এবং সেটিকে ওই address-এ route করে। Genesys নথিভুক্ত করেছে যে incoming UUI Call.UUIData-তে আসে; take-back-এর জন্য এটি নথিভুক্ত করেনি, তাই Genesys-এর সঙ্গে বা একটি test call-এ নিশ্চিত করুন যে কলার গ্রহণকারী ফ্লো সেখানে hand-off id খুঁজে পায়। summary এবং intent পেতে, একটি Web Services Data Actions integration-এ Call Data Action দিয়ে hand-off lookup কল করুন:

  • Request: GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= এর পরে Call.UUIData থেকে পাওয়া id।
  • Credentials: আপনার API key, যা Authorization: Bearer sk_live_… হিসেবে পাঠানো হয়।
  • Output: handoff.summary এবং handoff.intent flow variable-এ map করুন।

দেখুন handed-off কল খুঁজুন।

এটি পরীক্ষা করুন

ফ্লোতে পৌঁছায় এমন একটি নম্বরে কল করুন, এজেন্টের কাছে একজন ব্যক্তিকে চান, এবং Genesys আপনার সেট করা ঠিকানায় কলটি পাঠায় কি না যাচাই করুন। সেই ফ্লোতে নিশ্চিত করুন যে Call.UUIData হ্যান্ড-অফ আইডিটি টেক্সট হিসেবে ধারণ করে (যদি এটি হেক্স ডিজিট দেখায়, ট্রাঙ্কের UUI এনকোডিং Hex কি না পরীক্ষা করুন)। তারপর GET /v1/calls/{call_id} দিয়ে কলটি খুলুন: external_call_id-এ কনভারসেশন আইডি থাকা উচিত।

সীমাবদ্ধতা

  • Get SIP Headers অ্যাকশনটি শুধু প্রাথমিক INVITE পড়ে, তাই এটি এজেন্টের REFER থেকে কিছু পড়তে পারে না। হ্যান্ড-অফ শুধু UUI-এর মাধ্যমে Genesys-এ পৌঁছায়।
  • একটি কলে একাধিক UUI হেডার থাকলে Genesys সব UUI বাদ দেয়।
  • ট্রান্সফার ঠিকানাটি 254 অক্ষরের মধ্যে রাখা হয়, তাই দীর্ঘ UUI কেটে মানানসই করা হয়। একটি হ্যান্ড-অফ আইডি সবসময় মানানসই হয়।