Open in
Свързване от Five9
Изпращайте обаждания от Five9 към агент на ThunderPhone през SIP с AI Agent Connect и ги получавайте обратно с маршрутизиращи заглавки, които вашият IVR скрипт чете.
Вашият IVR скрипт във Five9 изпраща обаждащия се към агента с данните за обаждането от Five9. Когато агентът приключи, той затваря разговора със заглавки за маршрутизиране в SIP BYE, които скриптът прочита в променливи на обаждането, за да насочи обаждащия се.
Преди да започнете
- Агент на ThunderPhone и API ключ за организацията.
- Добавката Свързване с AI агент на Five9. Five9 я ограничава до доставчици на AI, които е акредитирала, а екипът по внедряване на Five9 я настройва: той импортира шаблона за IVR скрипт на доставчика, създава променливите на обаждането и насочва модула Прехвърляне към трета страна на скрипта към доставчика. ThunderPhone все още не е в списъка с акредитирани доставчици на Five9: обърнете се към екипа за вашия акаунт във Five9 или към поддръжката на ThunderPhone, преди да го включите в плановете си.
1. Създайте SIP крайна точка
Модулът за прехвърляне към трета страна на Five9 набира телефонен номер, а не SIP адрес, а интеграциите на Five9 на други доставчици удостоверяват Five9 по адреса на източника, а не с парола. Затова създайте крайна точка ip_allowlist, като зададете номера, който Five9 ще набира, като номер за входящо набиране (вижте
Платформи, които набират телефонен номер):
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": "Five9",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: диапазоните за SIP сигнализация на вашите центрове за данни на Five9, предоставени от Five9. Всеки трябва да е публичен IPv4 диапазон с/16или по-тесен (IPv6/48или по-тесен).dial_in_numbers: номерът, който скриптът на Five9 ще набира, изписан по начина, по който Five9 го изпраща. Не е необходимо да бъде реален телефонен номер. Не може вече да се използва в ThunderPhone като телефонен номер или в друга крайна точка: в такъв случай се връща409.
Адресите на Five9 се споделят от всички негови клиенти, така че всеки друг клиент на Five9, който набере номера, достига до вашия агент. Когато избирате номера, изберете дълъг номер, който никой не би познал (до 15 цифри), уверете се, че Five9 го изпраща към ThunderPhone, а не към телефонната мрежа, и не го публикувайте.
2. Изпращайте обаждания с контекст
Помолете екипа по внедряване на Five9 да:
- Изпраща обаждането от модула Прехвърляне към трета страна към
sip:+14155550188@sip.thunderphone.com, като номерът присъства както в URI на заявката, така и в заглавкатаTo. Модулът използва номера с SIP домейна на доставчика в заглавка. - Изпраща го през TLS (порт 5061) или TCP (порт 5060). Крайната точка отказва UDP, а Five9 не публикува кой транспорт използва, затова се уверете, че не е UDP.
- Включи Връщане след обаждане към трета страна, така че скриптът да продължи, когато агентът затвори разговора (Five9 позволява до 3 600 секунди за обаждането към трета страна).
Ръководството на Five9 изброява стойностите, които изпраща (call.ANI, call.DNIS,
call.call_id, call.session_id, call.campaign_name и други), но не и имената на техните заглавки. Интеграциите на Five9 на други доставчици на AI ги документират в сигнализацията като X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
и X-AgentID; проверете ги при първото си тестово обаждане. Всяка от тях достига до подканата като променлива, например
{{sip_x_callcampaign}}. X-CallID се съхранява като
external_call_id на обаждането.
3. Върнете обаждането
Агентът връща обаждането: казва довиждане и затваря, а BYE съдържа
четирите заглавки, които скриптът на Five9 чете. Добавете този номер за прехвърляне (вижте
Добавяне на номер за прехвърляне):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeиX-RouteValueуказват на скрипта къде да изпрати обаждащия се, тук — към умението Support. Стойностите, които други доставчици документират заX-RouteType, включватSkillTransfer,PhoneTransfer,HangupиDispositionOnly; съгласувайте стойностите с човека, който поддържа скрипта. За няколко дестинации добавете по едно връщане за всяка дестинация с различно име иX-RouteValue.X-RouteReasonсъдържа етикета за намерението на агента, напримерbilling_dispute.X-CustomMetaDataсъдържа идентификатора на предаването.BYEсъщо го съдържа катоX-TP-Handoff-Id, който Five9 не чете.
Скриптът на Five9 преобразува четирите заглавки в променливи за обаждането. За обобщението
на агента настройте скрипта да извиква справката за предаването с IVR модул Заявка:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= последвано от
call.call_id, с профил за оторизация, който изпраща
Authorization: Bearer и вашия API ключ. Вижте
Търсене на предадено обаждане.
Тествайте
Обадете се на IVR скрипта, поискайте от агента човек и проверете дали скриптът
насочва обаждащия се с попълнени променливи за обаждането. Ако обаждането никога не достига
до агента, проверете дали номерът в URI на заявката и заглавката To съответства на
номера за входящи обаждания, дали изходният адрес на Five9 е в allowed_source_cidrs и
дали обаждането е дошло по TCP или TLS. След това отворете обаждането с
GET /v1/calls/{call_id}: sip_headers трябва да съдържа x-callid, а
external_call_id трябва да съответства на call.call_id във Five9.
Ограничения
- Ръководството на Five9 документира данни за маршрутизиране в
BYEи не споменава приемане наREFER, така че връщането е студено прехвърляне от скрипта. - Five9 чете
X-RouteType,X-RouteValue,X-RouteReasonиX-CustomMetaData, а неUser-to-User. ThunderPhone изпраща всяка стойност на заглавка с дължина най-много 256 байта. - Five9 препоръчва да поддържате персонализираните заглавки до около десет, за да избегнете фрагментиране на пакети.