ThunderPhone v3 уже доступен.Самостоятельный запуск — от 2 ¢/мин.Читать анонс

Contact centers

Подключение из NICE CXone

Направляйте звонки NICE CXone агенту ThunderPhone из скрипта Studio, передавая ContactID в заголовке SIP, и находите передачу разговора агентом при продолжении скрипта.

Ваш сценарий CXone Studio совершает вызов агенту с SIP-заголовками, содержащими идентификатор контакта и любой другой контекст. Когда агент завершает вызов, действие REST API в сценарии получает данные передачи.

Перед началом работы

  • Агент ThunderPhone и ключ API организации.
  • Группа SIP-транков CXone, принимающая пользовательские заголовки. Ваш представитель NICE должен включить этот параметр, прежде чем CXone начнёт их отправлять.

1. Создайте SIP-конечную точку

Placecall набирает номер телефона через группу транков CXone, а не SIP-адрес. NICE не документирует SIP-учётные данные для него, а интеграция CXone другого поставщика ИИ использует TLS со списком разрешённых IP-адресов. Поэтому создайте конечную точку ip_allowlist с номером, который будет набирать сценарий, в качестве номера для входящих вызовов (см. Платформы, набирающие номер телефона):

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": "NICE CXone",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
  • allowed_source_cidrs: диапазоны SIP-сигнализации вашего кластера CXone, предоставленные NICE. Каждый должен быть общедоступным диапазоном IPv4 /16 или уже (IPv6 /48 или уже).
  • dial_in_numbers: номер, который будет набирать Placecall, записанный так, как его отправляет CXone. Это не обязательно должен быть реальный номер телефона. Он не может уже использоваться в ThunderPhone — как номер телефона или в другой конечной точке: в этом случае возвращается 409.

Адреса CXone используются всеми его клиентами, поэтому любой другой клиент CXone, который наберёт этот номер, попадёт к вашему агенту. Выберите длинный номер, который никто не сможет угадать (до 15 цифр), убедитесь, что CXone отправляет его в ThunderPhone, а не в телефонную сеть, и не публикуйте его.

2. Отправляйте вызовы с контекстом

В сценарии Studio перед Placecall:

  1. Добавьте действие Sipputheader с заголовком X-Call-ID и значением ContactID. CXone не отправляет собственный заголовок идентификатора вызова; ThunderPhone сохраняет этот заголовок как external_call_id вызова.
  2. Добавьте действие Sipputheader для каждого другого значения, которое должен знать агент, например X-Skill со значением support. Оно попадает в промпт как {{sip_x_skill}}. Sipputheader принимает User-to-User, любой заголовок X- и большинство заголовков P-; NICE рекомендует использовать значения длиной не более 256 символов.

Затем выполните Placecall на этот номер через группу транков, которая отправляет его на sip.thunderphone.com с номером и в URI запроса, и в заголовке To. Конечная точка принимает TLS (порт 5061) или TCP (порт 5060) и отклоняет UDP, а NICE не документирует транспорт транка, поэтому убедитесь, что это не UDP.

3. Получите вызов обратно

CXone считывает SIP-заголовки только в INVITE и его окончательном ответе, поэтому агент возвращает вызов: прощается и завершает вызов, а ваш сценарий снова получает звонящего. Добавьте этот номер перевода (см. Добавьте номер перевода):

{"name": "NICE CXone", "action": "return"}

NICE не документирует, что сценарий продолжается после Placecall, когда завершается совершённый вызов. Вместо этого интеграции CXone других поставщиков ИИ перед завершением вызова отправляют сигнал сценарию через Signal API CXone (POST /interactions/{contactId}/signal); ThunderPhone его не вызывает. Уточните у NICE, как ваш сценарий возвращает звонящего, затем получите данные передачи с помощью действия REST API:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= с последующим ContactID.
  • Заголовок Authorization: Bearer sk_live_….
  • Прочитайте из ответа handoff.summary и handoff.intent, чтобы направить контакт.

См. Поиск переданного вызова.

Проверьте

Позвоните на номер, который запускает сценарий, попросите агента соединить с человеком и убедитесь, что сценарий продолжается, а действие REST API возвращает передачу вызова. Если вызов так и не достигает агента, проверьте номер, который отправляет CXone, наличие его адреса-источника в allowed_source_cidrs, а также то, что вызов поступил по TCP или TLS. Затем откройте вызов с помощью GET /v1/calls/{call_id}: в sip_headers должен быть указан x-call-id, а external_call_id должен быть равен ContactID.

Ограничения

  • CXone отправляет и считывает заголовки только в INVITE и его окончательном 2xx, поэтому ничего из BYE агента не попадает в сценарий.
  • NICE не документирует поддержку REFER от агента.
  • Действие REST API по умолчанию завершается по тайм-ауту через 10 секунд (максимум — менее 90) и считывает ответы размером до 32 КБ.