Open in
Twilio
Twilio çağrılarını CallSid ile SIP üzerinden bir ThunderPhone yapay zeka ajanına gönderin ve aktarım adresindeki devirle referUrl
TwiML'niz, çağrının CallSid değerini bir üst bilgide taşıyarak ajanın SIP adresini arar.
Arayanın bir insana ihtiyacı olduğunda ajan bir SIP REFER gönderir, Twilio aktarım
adresini aktarım bilgisiyle birlikte referUrl işleyicinize iletir ve işleyicinizin
döndürdüğü TwiML, arayanın örneğin bir Flex kuyruğu gibi nereye yönlendirileceğini belirler.
Başlamadan önce
- Bir ThunderPhone yapay zeka ajanı ve bir kuruluş API anahtarı.
- Twilio Programmable Voice ve TwiML ile bir
referUrlişleyicisi sunabileceğiniz bir ortam: kendi sunucunuz veya bir TwiML Bin ve Twilio Function. Flex isteğe bağlıdır.
1. SIP uç noktasını oluşturun
Twilio'nun <Sip> öğesi bir kullanıcı adı ve parola alır; bu nedenle standart bir uç nokta kullanın:
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"}'Yanıttaki password değerini hemen saklayın; yalnızca bir kez gösterilir. Ayrıca
yalnızca Twilio'dan gelen çağrıları kabul etmek için
Kaynak IP'leri kısıtlama bölümüne bakın.
2. Çağrıları bağlamla gönderin
Ajana devretmek istediğiniz çağrı için bu TwiML'yi döndürün:
<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=tlsönemlidir: Twilio aksi belirtilmedikçe UDP kullanır.X-Call-ID,CallSiddeğerini taşır. Twilio kendi çağrı kimliği üst bilgisini belgelemez; bu nedenle bunu ekleyin: ThunderPhone bunu çağrınınexternal_call_iddeğeri olarak saklar.{{CallSid}}bir TwiML Bin içinde çalışır; kendi sunucunuzdan gönderiyorsanız gelen isteğinCallSiddeğerini yazın.&X-Account-Id=12345gibi daha fazla bağlamı aynı şekilde ekleyin. TwiML içinde&karakterini&olarak yazın; çünkü yalın bir&geçersiz XML'dir. Her biri isteme burada{{sip_x_account_id}}olarak bir değişken şeklinde ulaşır. Twilio, URI'nin tamamı 255 karakterin ve üst bilgilerin toplamı 1.024 karakterin altında olduğu sürece, yüzde kodlamalıx-üst bilgilerine veUser-to-Userdeğerine izin verir.referUrl, Twilio'nun ajanınREFERisteğini kabul etmesini sağlar; bu olmadan aktarım 13802 hatasıyla başarısız olur.answerOnBridge="true", yeni hedef yanıt verene kadar arayanı bağlı tutar; böylece başarısız bir aktarım için geri dönüş uygulanabilir.
Studio'nun Çağrıyı Şuna Bağla bileşeni özel üst bilgileri veya referUrl değerini
belgelemez; bu nedenle Studio'dan çağrıyı, örneğin bir TwiML Yönlendirmesi bileşeniyle
bu TwiML'ye aktarın.
3. Aramayı geri alın
Sesli AI ajanı, aktarım adresinde aktarma kimliği ve niyetini taşıyan bir REFER
ile aktarır. Bu aktarım numarasını ekleyin (bkz.
Aktarım numarasını ekleme
ve Aktarım adresindeki üstbilgiler):
{
"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, tüm adresi ReferTransferTarget olarak referUrl adresinize gönderir;
örneğin <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>.
İşleyiciniz üstbilgileri bu adresten okur ve arayanın sonraki adımda nereye
gideceğine ilişkin TwiML'yi döndürür. Adresin kullanıcı bölümü (support)
sizin seçiminizdir; böylece her hedef için bir aktarım numarası ekleyebilir ve
buna göre yönlendirme yapabilirsiniz.
Bu Twilio Function, aktarma bilgilerini görev öznitelikleri olarak kullanarak
arayanı Flex kuyruğuna ekler ve özeti aktarma kimliğine göre arar. Arama işlemi
bir Function içinde çalışır; çünkü Studio'nun HTTP Request bileşeni
Authorization üstbilgisini gönderemez:
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);
};API anahtarını Function'ın ortam değişkenlerinde tutun. Diğer alanlar için aktarılmış bir aramayı arama bölümüne bakın.
Test edin
Yukarıdaki TwiML'yi döndüren bir Twilio numarasını arayın, ajandan bir insanla
konuşmayı isteyin ve referUrl işleyicinizin her iki üstbilgiyle birlikte
ReferTransferTarget aldığını ve arayanın kuyruğa ulaştığını kontrol edin.
Ardından aramayı GET /v1/calls/{call_id} ile açın: external_call_id,
CallSid olmalıdır.
Sınırlar
- Twilio,
Refer-Todeğerini 256 karakterle sınırlar. ThunderPhone adresi 254 karakterle sınırlar ve sığmayan üstbilgiyi dahil etmez; bu nedenle üstbilgi adlarını ve değerlerini kısa tutun. - Twilio, bir
BYEüzerindeki üstbilgilerin okunmasını belgelemez; bu nedenle geri dönüş, aktarma bilgisini Twilio'ya geri taşıyamaz. Yukarıdaki gibi birREFERkullanın. - Twilio,
<Conference>veya<Queue>üzerinden bağlanan bir aramadaREFERkabul etmez; bu nedenle yukarıdaki gibi ajanı<Dial><Sip>ile arayın.