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

Contact centers

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 referUrl iş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, CallSid değerini taşır. Twilio kendi çağrı kimliği üst bilgisini belgelemez; bu nedenle bunu ekleyin: ThunderPhone bunu çağrının external_call_id değeri olarak saklar. {{CallSid}} bir TwiML Bin içinde çalışır; kendi sunucunuzdan gönderiyorsanız gelen isteğin CallSid değerini yazın.
  • &amp;X-Account-Id=12345 gibi daha fazla bağlamı aynı şekilde ekleyin. TwiML içinde & karakterini &amp; 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 ve User-to-User değerine izin verir.
  • referUrl, Twilio'nun ajanın REFER isteğ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-To değ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 bir REFER kullanın.
  • Twilio, <Conference> veya <Queue> üzerinden bağlanan bir aramada REFER kabul etmez; bu nedenle yukarıdaki gibi ajanı <Dial><Sip> ile arayın.