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

Contact centers

Zoom Contact Center

Zoom Contact Center çağrılarını üçüncü taraf sesli bot bağlayıcısıyla bir ThunderPhone yapay zeka ajanına yönlendirin ve SIP REFER ile yeniden bir insan ajana aktarın.

Zoom Contact Center akışınızdaki bir Bot bileşeni, arayanı Zoom'un çağrı sid'si ile sesli AI ajanına gönderir. Arayanın bir insana ihtiyacı olduğunda, ajan Zoom'un insan ajan adresine SIP REFER gönderir ve akışınız çağrı sid'si ile aktarmayı alır.

Başlamadan önce

  • Bir ThunderPhone ajanı ve kuruluşunuz için bir API anahtarı.
  • Yöneticiniz tarafından yönetilen ve Contact Center için kullanılabilir hale getirilen, Bot bileşeni için bir bağlayıcı içeren bir Zoom Marketplace Genel Uygulaması (Zoom'un üçüncü taraf ses botu kılavuzu).
  • Zoom'dan bot sağlayıcısına bir SIP trunk'ı. Zoom'un ISV ekibi bunu aşamalı olarak oluşturur (keşif, hazırlık trunk'ı ve ardından üretim) ve uygulamanın Şirket Adı, trunk kaydıyla tam olarak eşleşmelidir. Bu kurulum yalnızca Zoom hesabınızda değil, ThunderPhone desteği ve Zoom ile başlar.

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

Zoom'un bağlayıcısı, SIP adresi yerine 999 ile başlayan 15 haneli bir numarayı arar. Bağlayıcıyı kaydetmek bu numarayı oluşturur. Zoom'un trunk'ı, ses için SRTP ile 5061 numaralı bağlantı noktasında TLS 1.2 kullanır ve parola yerine Zoom'un alt ağları tarafından izin listesine alınır. Bu nedenle, bağlayıcının numarasını arama numarası olarak kullanarak ve SRTP'yi zorunlu tutarak bir ip_allowlist uç noktası oluşturun (bkz. Telefon numarası arayan platformlar):

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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
  • allowed_source_cidrs: Zoom'dan alınan Zoom SIP sinyalleşme alt ağları. Her biri /16 veya daha dar bir genel IPv4 aralığı (/48 veya daha dar IPv6) olmalıdır.
  • dial_in_numbers: + olmadan, Zoom'un gönderdiği biçimiyle bağlayıcının numarası.
  • srtp: Zoom'un trunk'ı her zaman SRTP kullandığı için required.

Zoom'un adresleri tüm müşterileri tarafından paylaşılır; bu nedenle numarayı arayan başka herhangi bir Zoom müşterisi ajanınıza ulaşır. Numarayı Zoom atar; yayımlamayın.

2. Aramaları bağlamla gönderin

Akışınıza bir Bot bileşeni ekleyin ve bunu bağlayıcıya bağlayın. Zoom'un ISV ekibinden trunk'ı, 5061 numaralı bağlantı noktasında TLS kullanarak sip.thunderphone.com adresine yönlendirmesini isteyin; bağlayıcının numarası hem istek URI'sinde hem de To başlığında bulunmalıdır. Uç nokta UDP'yi reddeder; bu nedenle trunk'ın UDP'ye geri dönmediğinden emin olun.

Zoom şunları gönderir:

  • Çağrının external_call_id alanı olarak depolanan X-ZOOM-Call-Sid. Zoom'un kendi veri eşleme sayfasında bu listelenmez; başka bir AI sağlayıcısının Zoom entegrasyonu bunu belgeliyor, bu yüzden ilk test aramanızda kontrol edin.
  • Arayanın çevirdiği numara olan X-ZOOM-DNIS, {{sip_x_zoom_dnis}} olarak.
  • Bağlayıcının Statik URL'si olan X-ZOOM-WEBHOOK.

3. Aramayı geri alın

Sesli AI ajanı, Zoom'un SBC'sindeki insan operatörü adresine bir REFER gönderir. Zoom'un size verdiği SBC adresiyle bu aktarım numarasını ekleyin (bkz. Aktarım numarasını ekleme):

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

Zoom'un kılavuzu, bir botun bağlamı iletmesinin iki yolunu açıklar: REFER öncesinde bağlayıcının Statik URL'sine yapılan bir POST (voicebot_metadata ve benzer olaylar) ve Bottan Gelen altında eşlenen SIP üst bilgileri. ThunderPhone, Statik URL'ye gönderim yapmaz. Zoom'un kılavuzu, bir REFER içindeki eşlenmiş üst bilgileri okuyup okumadığını belirtmez; denemek isterseniz girdiye "X-Handoff-Id": "{{handoff_id}}" gibi headers ekleyin ve bir test aramasında kontrol edin. Ayrıca, Zoom'un öncesinde meta veri POST'u olmadan bir REFER kabul ettiğini teyit edin.

Aktarımı bunların hiçbirine bağlı kalmadan almak için, akışınızın Bot bileşeninden sonra bir HTTP Çağrısı veya Komut Dosyası bileşeniyle sorgulama yapmasını sağlayın:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ve ardından arama sid'si.
  • Authorization: Bearer sk_live_… üst bilgisi.
  • Arayanı yönlendirmek ve aramayı alan kişiye özet bilgi vermek için handoff.summary ve handoff.intent kullanın.

Zoom, bu bileşenler için alan düzeyinde dokümantasyon yayımlamaz; bu nedenle bileşenin bir Authorization üst bilgisi gönderebildiğini hesabınızda teyit edin. Bkz. Aktarılan bir aramayı sorgulama.

Test edin

Bot bileşenine ulaşan bir numarayı arayın, sesli AI ajanından bir insana aktarılmayı isteyin ve arayanın bir insana ulaştığını ve bileşenin aktarımı döndürdüğünü kontrol edin. Ardından aramayı GET /v1/calls/{call_id} ile açın: sip_headers, x-zoom-call-sid değerini listelemeli ve external_call_id, akışınızın kullandığı arama sid'siyle eşleşmelidir.

Sınırlar

  • ThunderPhone, bağlayıcının Statik URL'sine gönderim yapmaz; bu nedenle Zoom, aktarımı sorgulama yoluyla veya testiniz Zoom'un bunları REFER içinden okuduğunu gösterirse eşlenmiş üst bilgileri aracılığıyla alır.
  • Trunk, Zoom'un ISV ekibi tarafından oluşturulur; bu nedenle onu kendiniz kuramaz veya test edemezsiniz.