Open in
Свързване от Zoom Contact Center
Насочвайте обаждания от Zoom Contact Center към агент на ThunderPhone чрез конектор за гласов бот на трета страна и ги връщайте към човешки агент чрез SIP REFER.
Приспособление „Бот“ във вашия поток на Zoom Contact Center изпраща обаждащия се към агента с идентификатора на обаждането от Zoom. Когато обаждащият се има нужда от човек, агентът изпраща SIP REFER към адреса на Zoom за човешки агент, а вашият поток извлича прехвърлянето по идентификатора на обаждането.
Преди да започнете
- Агент на ThunderPhone и API ключ за организацията.
- Общо приложение в Zoom Marketplace, управлявано от вашия администратор и предоставено за Contact Center, с конектор за приспособлението „Бот“ (ръководството на Zoom за гласови ботове на трети страни).
- SIP магистрала от Zoom към доставчика на бота. Екипът на Zoom за ISV я изгражда на етапи (проучване, тестова магистрала, след това продукционна среда), а полето „Име на компанията“ на приложението трябва да съвпада точно със записа за магистралата. Тази настройка започва с поддръжката на ThunderPhone и Zoom, а не само във вашия акаунт в Zoom.
1. Създайте SIP крайна точка
Конекторът на Zoom набира 15-цифрен номер, започващ с 999, а не SIP
адрес. Записването на конектора генерира този номер. Магистралата на Zoom използва TLS 1.2
на порт 5061 със SRTP за аудио и е в списък с разрешени източници чрез подмрежите на Zoom, а не чрез парола. Затова създайте крайна точка ip_allowlist с номера на конектора като номер за набиране и със задължителен SRTP (вижте
Платформи, които набират телефонен номер):
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": "Zoom Contact Center",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["999123456789012"],
"srtp": "required"
}'allowed_source_cidrs: подмрежите за SIP сигнализация на Zoom, предоставени от Zoom. Всяка трябва да е публичен диапазон IPv4 с/16или по-тесен (IPv6/48или по-тесен).dial_in_numbers: номерът на конектора точно както Zoom го изпраща, без+.srtp:required, тъй като магистралата на Zoom винаги използва SRTP.
Адресите на Zoom се споделят от всички негови клиенти, така че всеки друг клиент на Zoom, който набере номера, достига до вашия агент. Zoom назначава номера; не го публикувайте.
2. Изпращайте обаждания с контекст
Добавете приспособление Бот към вашия поток и го свържете с конектора. Поискайте от екипа на Zoom за ISV
да насочи магистралата към sip.thunderphone.com, с TLS на порт 5061 и с
номера на конектора както в URI на заявката, така и в заглавката To. Крайната точка
отказва UDP, затова се уверете, че магистралата не преминава към него.
Zoom изпраща:
X-ZOOM-Call-Sid, съхраняван катоexternal_call_idна обаждането. Собствената страница на Zoom за съпоставяне на данни не го изброява; интеграцията с Zoom на друг доставчик на AI го документира, затова го проверете при първото си тестово обаждане.X-ZOOM-DNIS, номера, който обаждащият се е набрал, като{{sip_x_zoom_dnis}}.X-ZOOM-WEBHOOK, статичния URL на конектора.
3. Получете обратно обаждането
Агентът изпраща REFER до адреса на човешкия агент в SBC на Zoom. Добавете този
номер за прехвърляне (вижте
Добавяне на номера за прехвърляне),
с адреса на SBC, който Zoom ви предоставя:
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}Ръководството на Zoom описва два начина, по които бот предава контекст: POST към
статичния URL на конектора преди REFER (voicebot_metadata и подобни
събития), както и SIP заглавки, съпоставени под Входящо от бот. ThunderPhone
не изпраща данни към статичния URL. Ръководството на Zoom не уточнява дали чете
съпоставени заглавки от REFER; ако искате да опитате, добавете headers, като
"X-Handoff-Id": "{{handoff_id}}", към записа и проверете с тестово обаждане. Също
потвърдете със Zoom, че приема REFER без POST с метаданни преди него.
За да получите прехвърлянето, без да разчитате на нито един от двата начина, настройте потока си да го търси след уиджета Bot чрез уиджет HTTP Call или Script:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=последвано от SID на обаждането.- Заглавка
Authorization: Bearer sk_live_…. - Използвайте
handoff.summaryиhandoff.intent, за да насочите обаждащия се и да информирате човека, който приема обаждането.
Zoom не публикува документация на ниво поле за тези уиджети, затова потвърдете в
акаунта си, че уиджетът може да изпраща заглавка Authorization. Вижте
Търсене на прехвърлено обаждане.
Тествайте
Обадете се на номер, който достига до уиджета Bot, поискайте от агента човек и
проверете дали обаждащият се достига до човешки агент и уиджетът връща
прехвърлянето. След това отворете обаждането с GET /v1/calls/{call_id}:
sip_headers трябва да съдържа x-zoom-call-sid, а external_call_id трябва да
съответства на SID на обаждането, който използва вашият поток.
Ограничения
- ThunderPhone не изпраща данни към статичния URL на конектора, така че Zoom
получава прехвърлянето чрез търсенето или чрез съпоставени заглавки, ако тестът
ви покаже, че Zoom ги чете от
REFER. - Трънкът се изгражда от екипа на Zoom за ISV, така че не можете да го настроите или тествате самостоятелно.