Open in
Hubungkan dari Twilio
Kirim panggilan Twilio ke agen ThunderPhone melalui SIP dengan CallSid, lalu kembalikan melalui referUrl Anda dengan hand-off di alamat transfer.
TwiML Anda memanggil alamat SIP agen dengan CallSid panggilan dalam sebuah header.
Saat penelepon membutuhkan seseorang, agen mengirimkan REFER SIP, Twilio meneruskan
alamat transfer beserta serah-terima di dalamnya ke handler referUrl Anda, dan
TwiML yang dikembalikan handler Anda menentukan ke mana penelepon dialihkan, seperti antrean Flex.
Sebelum memulai
- Agen ThunderPhone dan kunci API organisasi.
- Twilio Programmable Voice, serta tempat untuk menyajikan TwiML dan handler
referUrl: server Anda sendiri, atau TwiML Bin dan Twilio Function. Flex bersifat opsional.
1. Buat endpoint SIP
<Sip> Twilio menggunakan nama pengguna dan kata sandi, jadi gunakan endpoint standar:
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": "Twilio"}'Simpan password dari respons segera; nilai ini hanya ditampilkan sekali. Untuk
menerima panggilan hanya dari Twilio juga, lihat
Batasi IP sumber.
2. Kirim panggilan dengan konteks
Kembalikan TwiML ini untuk panggilan yang ingin Anda serahkan kepada agen:
<Response>
<Dial answerOnBridge="true" referUrl="https://YOUR_SERVER/thunderphone-refer">
<Sip username="tp409667538f83" password="YOUR_ENDPOINT_PASSWORD">sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls?X-Call-ID={{CallSid}}</Sip>
</Dial>
</Response>;transport=tlspenting: Twilio menggunakan UDP kecuali diberi tahu sebaliknya.X-Call-IDmembawaCallSid. Twilio tidak mendokumentasikan header call-id miliknya sendiri, jadi tambahkan header ini: ThunderPhone menyimpannya sebagaiexternal_call_idpanggilan.{{CallSid}}berfungsi dalam TwiML Bin; dari server Anda sendiri, tuliskanCallSiddari permintaan masuk.- Tambahkan konteks lainnya dengan cara yang sama, seperti
&X-Account-Id=12345. Di dalam TwiML, tuliskan&sebagai&, karena&tanpa escape bukan XML yang valid. Masing-masing mencapai Prompt sebagai variabel, di sini{{sip_x_account_id}}. Twilio mengizinkan headerx-danUser-to-User, yang dienkode persen, dengan seluruh URI di bawah 255 karakter dan header di bawah 1.024. referUrlmemungkinkan Twilio menerimaREFERdari agen; tanpa itu transfer gagal dengan error 13802.answerOnBridge="true"menjaga penelepon tetap terhubung hingga tujuan baru menjawab, sehingga transfer yang gagal dapat menggunakan fallback.
Widget Hubungkan Panggilan Ke Studio tidak mendokumentasikan header khusus atau
referUrl, jadi dari Studio serahkan panggilan ke TwiML ini, misalnya dengan widget
Pengalihan TwiML.
3. Dapatkan panggilan kembali
Agen mentransfer dengan REFER yang alamat transfernya membawa
id dan intent serah-terima. Tambahkan nomor transfer ini (lihat
Tambahkan nomor transfer
dan Header di dalam alamat transfer):
{
"name": "Twilio support",
"number": "sip:support@acme.sip.twilio.com",
"headers": {"X-Handoff-Id": "{{handoff_id}}", "X-Handoff-Intent": "{{handoff_intent}}"},
"headers_in_uri": true
}Twilio mengirimkan seluruh alamat ke referUrl Anda sebagai ReferTransferTarget, misalnya
<sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>.
Handler Anda membaca header dari alamat tersebut dan mengembalikan TwiML untuk tujuan
penelepon selanjutnya. Bagian pengguna alamat tersebut (support) dapat Anda tentukan,
sehingga Anda dapat menambahkan satu nomor transfer per tujuan dan merutekannya berdasarkan nomor tersebut.
Twilio Function ini memasukkan penelepon ke antrean Flex dengan serah-terima sebagai
atribut tugas dan mencari ringkasan berdasarkan id serah-terima. Pencarian dijalankan di
Function karena widget HTTP Request Studio tidak dapat mengirim header Authorization:
exports.handler = async (context, event, callback) => {
const target = (event.ReferTransferTarget || "").replace(/^<|>$/g, "");
const params = new URLSearchParams(target.split("?")[1] || "");
const handoffId = params.get("X-Handoff-Id") || "";
const attributes = { handoff_id: handoffId, intent: params.get("X-Handoff-Intent") || "" };
if (handoffId) {
const response = await fetch(
"https://api.thunderphone.com/v1/calls/handoff?handoff_id=" + encodeURIComponent(handoffId),
{ headers: { Authorization: "Bearer " + context.THUNDERPHONE_API_KEY } }
);
if (response.ok) {
const call = await response.json();
attributes.summary = (call.handoff && call.handoff.summary) || "";
}
}
const twiml = new Twilio.twiml.VoiceResponse();
twiml.enqueue({ workflowSid: context.FLEX_WORKFLOW_SID }).task({}, JSON.stringify(attributes));
callback(null, twiml);
};Simpan API key di variabel lingkungan Function. Lihat Cari panggilan yang diserahterimakan untuk field lainnya.
Uji
Hubungi nomor Twilio yang mengembalikan TwiML di atas, minta agen menyambungkan Anda ke seseorang,
dan pastikan handler referUrl Anda menerima ReferTransferTarget dengan kedua
header serta penelepon masuk ke antrean. Kemudian buka panggilan dengan
GET /v1/calls/{call_id}: external_call_id harus berupa CallSid.
Batasan
- Twilio membatasi
Refer-Tohingga 256 karakter. ThunderPhone mempertahankan alamat hingga 254 karakter dan mengabaikan header yang tidak muat, jadi gunakan nama dan nilai header yang singkat. - Twilio tidak mendokumentasikan pembacaan header pada
BYE, sehingga transfer balik tidak dapat membawa serah-terima kembali ke Twilio. GunakanREFERseperti di atas. - Twilio tidak menerima
REFERpada panggilan yang terhubung melalui<Conference>atau<Queue>, jadi hubungi agen dengan<Dial><Sip>seperti di atas.