ThunderPhone v3 yayında.Hemen kendiniz kullanmaya başlayın; dakikası 2 sentten başlayan fiyatlarla.Duyuruyu okuyun

Contact centers

NICE CXone

NICE CXone çağrılarını, ContactID bir SIP üst bilgisinde olacak şekilde bir Studio betiğinden ThunderPhone ajanına gönderin ve betik devam ettiğinde ajanın aktarmasını sorgulayın.

CXone Studio betiğiniz, iletişim kimliğini ve diğer bağlam bilgilerini taşıyan SIP başlıklarıyla yapay zeka ajanını arar. Ajan işi bittiğinde çağrıyı kapatır ve betikteki bir REST API eylemi çağrı aktarımını getirir.

Başlamadan önce

  • Bir ThunderPhone ajanı ve bir kuruluş API anahtarı.
  • Özel başlıkları kabul eden bir CXone SIP trunk grubu. CXone bunları göndermeden önce NICE hesap temsilcinizin bu ayarı etkinleştirmesi gerekir.

1. SIP uç noktasını oluşturun

Placecall, bir SIP adresi yerine CXone trunk grubu üzerinden bir telefon numarasını arar. NICE bunun için SIP kimlik bilgilerini belgelemez ve başka bir yapay zeka sağlayıcısının CXone entegrasyonu, IP izin listesiyle TLS kullanır. Bu nedenle, betiğin arayacağı numarayı arama numarası olarak içeren bir ip_allowlist uç noktası oluşturun (bkz. Telefon numarası arayan platformlar):

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: NICE'ten alınan CXone kümenizin SIP sinyalleşme aralıkları. Her biri /16 veya daha dar bir genel IPv4 aralığı olmalıdır (IPv6 için /48 veya daha dar).
  • dial_in_numbers: Placecall'ın arayacağı, CXone'un gönderdiği biçimde yazılmış numara. Gerçek bir telefon numarası olmak zorunda değildir. ThunderPhone üzerinde telefon numarası olarak veya başka bir uç noktada zaten kullanılıyor olamaz; aksi durumda 409 döner.

CXone adresleri tüm müşterileri tarafından paylaşılır; bu nedenle numarayı arayan başka bir CXone müşterisi yapay zeka ajanınıza ulaşır. Numarayı seçtiğiniz yerde kimsenin tahmin edemeyeceği uzun bir numara seçin (en fazla 15 hane), CXone'un bunu telefon ağına çıkarmak yerine ThunderPhone'a gönderdiğinden emin olun ve numarayı yayımlamayın.

2. Çağrıları bağlamla gönderin

Studio betiğinizde, Placecall öncesinde:

  1. X-Call-ID başlığı ve ContactID değeriyle bir Sipputheader eylemi ekleyin. CXone kendi çağrı kimliği başlığını göndermez; ThunderPhone bunu çağrının external_call_id değeri olarak kaydeder.
  2. Ajanın bilmesi gereken diğer her değer için, örneğin support olarak ayarlanmış X-Skill için bir Sipputheader eylemi ekleyin. Bu değer isteme {{sip_x_skill}} olarak ulaşır. Sipputheader, User-to-User, tüm X- başlıklarını ve çoğu P- başlığını kabul eder; NICE, 256 karakter veya daha kısa değerler önerir.

Ardından, numarayı hem istek URI'sinde hem de To başlığında kullanarak, onu sip.thunderphone.com adresine gönderen bir trunk grubu üzerinden Placecall yapın. Uç nokta TLS'yi (5061 numaralı bağlantı noktası) veya TCP'yi (5060 numaralı bağlantı noktası) kabul eder ve UDP'yi reddeder. NICE trunk'ın aktarım türünü belgelemediğinden UDP olmadığından emin olun.

3. Çağrıyı geri alın

CXone SIP başlıklarını yalnızca INVITE ve onun nihai yanıtında okur; bu nedenle ajan çağrıyı geri döndürür: vedalaşır ve çağrıyı kapatır, ardından betiğiniz arayanı yeniden devralır. Bu aktarım numarasını ekleyin (bkz. Aktarım numarasını ekleyin):

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

NICE, başlatılan çağrı sona erdiğinde bir betiğin Placecall sonrasında devam ettiğini belgelemez. Diğer yapay zeka sağlayıcılarının CXone entegrasyonları bunun yerine, çağrıyı kapatmadan önce CXone'un Signal API'si (POST /interactions/{contactId}/signal) aracılığıyla betiğe sinyal gönderir; ThunderPhone bunu çağırmaz. Betiğinizin arayanı nasıl geri devraldığını NICE ile doğrulayın, ardından bir REST API eylemiyle çağrı aktarımı verilerini getirin:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= sonrasında ContactID.
  • Authorization: Bearer sk_live_… başlığı.
  • İletişimi yönlendirmek için yanıttan handoff.summary ve handoff.intent değerlerini okuyun.

Bkz. Aktarılan bir çağrıyı arayın.

Test edin

Komut dosyasını çalıştıran bir numarayı arayın, yapay zeka ajanından bir kişi isteyin ve komut dosyasının devam ettiğini ve REST API eyleminin aktarımı döndürdüğünü kontrol edin. Çağrı hiç yapay zeka ajanına ulaşmıyorsa CXone'un gönderdiği numarayı, kaynak adresinin allowed_source_cidrs içinde olduğunu ve çağrının TCP veya TLS üzerinden geldiğini kontrol edin. Ardından çağrıyı GET /v1/calls/{call_id} ile açın: sip_headers, x-call-id değerini listelemeli ve external_call_id, ContactID ile eşit olmalıdır.

Sınırlar

  • CXone, başlıkları yalnızca INVITE ve onun son 2xx yanıtında gönderir ve okur; bu nedenle yapay zeka ajanının BYE mesajındaki hiçbir şey komut dosyasına ulaşmaz.
  • NICE, yapay zeka ajanından gelen bir REFER isteğini kabul etmeyi belgelemez.
  • REST API eylemi varsayılan olarak 10 saniye sonra zaman aşımına uğrar (en fazla 90 saniye) ve 32 KB'a kadar yanıt okur.