---
title: "NICE CXone'dan bağlanın"
description: "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ı](/tr/guides/api-keys).
- Ö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](/tr/guides/sip-addresses)):

```bash
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](/tr/guides/contact-centers/overview)):

```json
{"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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
