---
title: "Hubungkan dari Five9"
description: "Kirim panggilan Five9 ke agen ThunderPhone melalui SIP dengan AI Agent Connect, lalu terima kembali dengan header perutean yang dibaca skrip IVR Anda."
---

Skrip IVR Five9 Anda mengirim penelepon ke agen beserta detail panggilan
Five9. Setelah agen selesai, agen mengakhiri panggilan dengan header perutean pada SIP
`BYE`, yang dibaca skrip ke dalam variabel panggilan untuk merutekan penelepon.

## Sebelum memulai

- Agen ThunderPhone dan [kunci API](/id/guides/api-keys) organisasi.
- Add-on **AI Agent Connect** Five9. Five9 membatasinya pada penyedia AI yang
  telah diakreditasi, dan tim implementasi Five9 menyiapkannya: tim mengimpor
  template skrip IVR penyedia, membuat variabel panggilan, dan mengarahkan modul
  **Transfer Pihak Ketiga** skrip ke penyedia. ThunderPhone belum ada dalam
  daftar terakreditasi Five9: tanyakan kepada tim akun Five9 atau dukungan
  ThunderPhone sebelum Anda mengandalkannya dalam perencanaan.

## 1. Buat endpoint SIP

Modul Transfer Pihak Ketiga Five9 menghubungi nomor telepon, bukan alamat SIP,
dan integrasi Five9 dari penyedia lain mengautentikasi Five9 berdasarkan alamat
sumber, bukan kata sandi. Jadi, buat endpoint `ip_allowlist` dengan nomor yang
akan dihubungi Five9 sebagai nomor dial-in (lihat
[Platform yang menghubungi nomor telepon](/id/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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: rentang pensinyalan SIP pusat data Five9 Anda, dari
  Five9. Masing-masing harus berupa rentang IPv4 publik `/16` atau lebih sempit
  (IPv6 `/48` atau lebih sempit).
- `dial_in_numbers`: nomor yang akan dihubungi skrip Five9, ditulis dengan cara
  Five9 mengirimkannya. Nomor ini tidak harus berupa nomor telepon nyata. Nomor
  ini tidak boleh sudah digunakan di ThunderPhone, sebagai nomor telepon atau
  pada endpoint lain: kondisi tersebut mengembalikan `409`.

Alamat Five9 digunakan bersama oleh semua pelanggannya, sehingga pelanggan
Five9 lain yang menghubungi nomor tersebut akan tersambung ke agen Anda. Saat
memilih nomor, pilih nomor panjang yang tidak akan ditebak siapa pun (hingga
15 digit), pastikan Five9 mengirimkannya ke ThunderPhone, bukan ke jaringan
telepon, dan jangan publikasikan nomor tersebut.

## 2. Kirim panggilan dengan konteks

Minta tim implementasi Five9 untuk:

- Mengirim panggilan dari modul **Transfer Pihak Ketiga** ke
  `sip:+14155550188@sip.thunderphone.com`, dengan nomor tersebut dalam URI
  permintaan dan header `To`. Modul ini menerima nomor tersebut, dengan domain
  SIP penyedia dalam header.
- Mengirimkannya melalui TLS (port 5061) atau TCP (port 5060). Endpoint menolak
  UDP, dan Five9 tidak memublikasikan transport yang digunakannya, jadi
  pastikan transport tersebut bukan UDP.
- Mengaktifkan **Kembali Setelah Panggilan Pihak Ketiga**, agar skrip berlanjut
  saat agen mengakhiri panggilan (Five9 mengizinkan hingga 3.600 detik untuk
  panggilan pihak ketiga).

Panduan Five9 mencantumkan nilai yang dikirimnya (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` dan lainnya), bukan nama
headernya. Integrasi Five9 dari penyedia AI lain mendokumentasikannya dalam transmisi
sebagai `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
dan `X-AgentID`; periksa semuanya pada panggilan uji pertama Anda. Masing-masing masuk ke Prompt sebagai variabel, seperti
`{{sip_x_callcampaign}}`. `X-CallID` disimpan sebagai
`external_call_id` panggilan.

## 3. Kembalikan panggilan

Agen mengembalikan panggilan: agen mengucapkan selamat tinggal dan menutup panggilan, lalu `BYE` membawa
empat header yang dibaca skrip Five9. Tambahkan nomor transfer ini (lihat
[Tambahkan nomor transfer](/id/guides/contact-centers/overview)):

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` dan `X-RouteValue` memberi tahu skrip ke mana harus mengirim penelepon,
  dalam hal ini ke skill Support. Nilai untuk `X-RouteType` yang didokumentasikan oleh penyedia lain mencakup
  `SkillTransfer`, `PhoneTransfer`, `Hangup`, dan `DispositionOnly`; sepakati
  nilainya dengan pihak yang memelihara skrip. Untuk beberapa tujuan, tambahkan satu
  return per tujuan dengan nama dan `X-RouteValue` yang berbeda.
- `X-RouteReason` membawa label intent agen, seperti `billing_dispute`.
- `X-CustomMetaData` membawa ID handoff. `BYE` juga membawanya sebagai
  `X-TP-Handoff-Id`, yang tidak dibaca oleh Five9.

Skrip Five9 memetakan keempat header ke dalam variabel panggilan. Untuk ringkasan
agen, minta skrip memanggil pencarian handoff dengan modul IVR **Kueri**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` diikuti oleh
`call.call_id`, dengan Profil Otorisasi yang mengirimkan
`Authorization: Bearer` dan kunci API Anda. Lihat
[Cari panggilan yang dialihkan](/api-reference/calls#look-up-a-handed-off-call).

## Uji

Hubungi skrip IVR, minta agen menghubungkan Anda ke seseorang, lalu periksa bahwa skrip
merutekan penelepon dengan variabel panggilan terisi. Jika panggilan tidak pernah sampai ke
agen, periksa bahwa nomor dalam URI permintaan dan header `To` cocok dengan
nomor dial-in, bahwa alamat sumber Five9 ada dalam `allowed_source_cidrs`, dan
bahwa panggilan datang melalui TCP atau TLS. Kemudian buka panggilan dengan
`GET /v1/calls/{call_id}`: `sip_headers` harus mencantumkan `x-callid`, dan
`external_call_id` harus cocok dengan `call.call_id` di Five9.

## Batasan

- Panduan Five9 mendokumentasikan data perutean pada `BYE` dan tidak menyebutkan
  penerimaan `REFER`, sehingga pengembalian dilakukan sebagai transfer dingin oleh skrip.
- Five9 membaca `X-RouteType`, `X-RouteValue`, `X-RouteReason`, dan
  `X-CustomMetaData`, bukan `User-to-User`. ThunderPhone mengirim setiap nilai header
  dengan panjang maksimal 256 byte.
- Five9 merekomendasikan untuk membatasi header kustom hingga sekitar sepuluh agar menghindari
  fragmentasi paket.
