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

Contact centers

Five9

Five9 çağrılarını AI Agent Connect ile SIP üzerinden bir ThunderPhone yapay zeka ajanına gönderin ve IVR betiğinizin okuduğu yönlendirme başlıklarıyla geri alın.

Five9 IVR betiğiniz, arayanı Five9'un çağrı ayrıntılarıyla ajana gönderir. Ajan işi tamamladığında, SIP BYE üzerindeki yönlendirme başlıklarıyla çağrıyı sonlandırır; betik de arayanı yönlendirmek için bunları çağrı değişkenlerine okur.

Başlamadan önce

  • Bir ThunderPhone ajanı ve bir kuruluş API anahtarı.
  • Five9'un AI Agent Connect eklentisi. Five9 bunu akredite ettiği yapay zeka sağlayıcılarıyla sınırlar ve Five9'un uygulama ekibi kurulumu yapar: sağlayıcının IVR betik şablonunu içe aktarır, çağrı değişkenlerini oluşturur ve betiğin Üçüncü Taraf Aktarımı modülünü sağlayıcıya yönlendirir. ThunderPhone henüz Five9'un akredite listesinde değildir: buna göre plan yapmadan önce Five9 hesap ekibinize veya ThunderPhone desteğine danışın.

1. SIP uç noktasını oluşturun

Five9'un Üçüncü Taraf Aktarımı modülü SIP adresini değil, bir telefon numarasını arar ve diğer sağlayıcıların Five9 entegrasyonları Five9'u parola yerine kaynak adresiyle doğrular. Bu nedenle, Five9'un arayacağı numarayı arama numarası olarak içeren bir ip_allowlist uç noktası oluşturun (telefon numarası arayan platformlar bölümüne bakı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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
  • allowed_source_cidrs: Five9'dan alınan, Five9 veri merkezlerinizin 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: Five9 betiğinin arayacağı, Five9'un gönderdiği biçimde yazılmış numara. Gerçek bir telefon numarası olması gerekmez. ThunderPhone üzerinde telefon numarası olarak veya başka bir uç noktada zaten kullanılıyor olamaz: aksi durumda 409 döner.

Five9'un adresleri tüm müşterileri tarafından paylaşıldığından, numarayı arayan başka herhangi bir Five9 müşterisi ajanınıza ulaşır. Numarayı seçebildiğiniz yerde, kimsenin tahmin edemeyeceği uzun bir numara seçin (en fazla 15 hane), Five9'un bunu telefon ağına yönlendirmek yerine ThunderPhone'a gönderdiğinden emin olun ve numarayı yayımlamayın.

2. Çağrıları bağlamla gönderin

Five9'un uygulama ekibinden şunları isteyin:

  • Çağrıyı Üçüncü Taraf Aktarımı modülünden, numara hem istek URI'sinde hem de To başlığında olacak şekilde sip:+14155550188@sip.thunderphone.com adresine gönderin. Modül, sağlayıcının SIP alan adıyla birlikte numarayı bir başlıkta alır.
  • TLS (5061 numaralı bağlantı noktası) veya TCP (5060 numaralı bağlantı noktası) üzerinden gönderin. Uç nokta UDP'yi reddeder ve Five9 hangi taşıma yöntemini kullandığını yayımlamaz; bu nedenle UDP olmadığından emin olun.
  • Ajan çağrıyı sonlandırdığında betiğin devam etmesi için Üçüncü Taraf Çağrısından Sonra Dön seçeneğini etkinleştirin (Five9, üçüncü taraf çağrısında en fazla 3.600 saniyeye izin verir).

Five9'un kılavuzu, gönderdiği değerleri (call.ANI, call.DNIS, call.call_id, call.session_id, call.campaign_name ve diğerleri) listeler; başlık adlarını değil. Diğer yapay zeka sağlayıcılarının Five9 entegrasyonları bunları ağ üzerinde X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign ve X-AgentID olarak belgeler; ilk test çağrınızda bunları kontrol edin. Her biri, örneğin {{sip_x_callcampaign}} gibi bir değişken olarak isteme ulaşır. X-CallID, çağrının external_call_id değeri olarak saklanır.

3. Aramayı geri alın

Ajan çağrıyı geri döndürür: vedalaşır ve kapatır; BYE, Five9 betiğinin okuduğu dört başlığı taşır. Bu aktarım numarasını ekleyin (bkz. Aktarım numarasını ekleme):

{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
  • X-RouteType ve X-RouteValue, betiğe arayanı nereye göndereceğini, burada Support yeteneğine yönlendireceğini belirtir. Diğer sağlayıcıların X-RouteType için belgelediği değerler arasında SkillTransfer, PhoneTransfer, Hangup ve DispositionOnly bulunur; değerleri betiği yöneten kişiyle kararlaştırın. Birden fazla hedef için, her hedefe farklı ad ve X-RouteValue değeriyle bir geri dönüş ekleyin.
  • X-RouteReason, billing_dispute gibi ajanın amaç etiketini taşır.
  • X-CustomMetaData, aktarma kimliğini taşır. BYE bunu ayrıca X-TP-Handoff-Id olarak taşır; Five9 bunu okumaz.

Five9 betiği dört başlığı çağrı değişkenlerine eşler. Ajan özetini almak için, betiğin bir IVR Sorgu modülüyle aktarma sorgusunu çağırmasını sağlayın: GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ardından call.call_id; Authorization: Bearer ve API anahtarınızı gönderen bir Yetkilendirme Profili kullanın. Bkz. Aktarılan bir çağrıyı sorgulama.

Test edin

IVR betiğini arayın, yapay zeka ajanından bir insan isteyin ve betiğin arayanı çağrı değişkenleri doldurulmuş şekilde yönlendirdiğini doğrulayın. Çağrı hiçbir zaman ajana ulaşmazsa istek URI'sindeki ve To başlığındaki numaranın erişim numarasıyla eşleştiğini, Five9 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-callid değerini listelemeli ve external_call_id, Five9 içindeki call.call_id ile eşleşmelidir.

Sınırlar

  • Five9 kılavuzu yönlendirme verilerini BYE üzerinde belgeler ve bir REFER kabulünden bahsetmez; bu nedenle geri aktarma, betik tarafından yapılan soğuk bir aktarmadır.
  • Five9, User-to-User yerine X-RouteType, X-RouteValue, X-RouteReason ve X-CustomMetaData değerlerini okur. ThunderPhone her başlık değerini en fazla 256 bayt uzunluğunda gönderir.
  • Five9, paket parçalanmasını önlemek için özel başlıkların sayısını yaklaşık onla sınırlamayı önerir.