Yapay zeka ajanı kampanyası, giden aramaları bir insan yerine sanal bir ajanla yapar. Kuyruk yoktur ve masada oturan bir temsilci de yoktur: SESTEK AgenticCX kişiyi arar, aramayı sizin belirttiğiniz yapay zeka ajanı projesine bağlar ve sonucu kaydeder. Yapay zeka ajanı kampanyasını iki şekilde çalıştırabilirsiniz. Planlı kampanya, bir kişi listesini takvime göre tek tek arar. Anlık kampanya ise her zaman açıktır ve her arama için başka bir sistemin, örneğin bir web formunun ya da CRM uygulamanızın, istek göndermesini bekler.
Bu makale yapay zeka ajanı kampanyalarını insan temsilci kampanyalarından ayıran noktaları, Planlı ile Anlık kampanyanın karşılaştırmasını ve dış bir sistemin Anlık kampanyaya arama isteğini nasıl göndereceğini anlatır. Kampanya formunu adım adım doldurmak için Kampanya Oluşturma ve Düzenleme makalesine bakın.
Sol menüden Kampanyalar'ı açın.
Video anlatımı
Yapay zeka ajanı kampanyası insan temsilci kampanyasından nasıl ayrılır
| İnsan Temsilci kampanyası | Yapay Zeka Ajanı kampanyası | |
|---|---|---|
| Aramayı kim karşılar | Müşteri Temsilcisi Arayüzü'ndeki bir temsilci | Kampanyada adı yazılı yapay zeka ajanı projesi |
| Kuyruk | Zorunlu | Yok. Yapay zeka ajanı kampanyasına kuyruk atanamaz |
| Sonuç kodları | Kampanyada ve arama sonrasında temsilci tarafından seçilir | Yok |
| Çağrı öncesi ve çağrı sonrası çalışma | Var | Yok |
| Yapay zeka ajanı nerede belirlenir | Geçerli değil | Yapay Zeka Ajanı Proje Adı, zorunlu, en fazla 200 karakter |
| Kişi nasıl tamamlanır | Temsilci bir sonuç kodu seçer | Yanıtlanan arama kişiyi otomatik tamamlar |
Listede adın önündeki yıldız simgesi yapay zeka ajanı kampanyasını gösterir, Kuyruk / Yapay Zeka Ajanı sütununda ise kuyruklar yerine yapay zeka ajanı projesi görünür. Yalnızca yapay zeka ajanı kampanyalarını görmek için Filtreler'i seçin, Temsilci Tipi'ni açın ve Yapay Zeka Ajanı'nı işaretleyin.
Planlı mı, Anlık mı
| Planlı | Anlık | |
|---|---|---|
| Hangi kişilerin arandığına kim karar verir | Siz, kişi segmentlerini seçerek | Dış bir sistem, her seferinde tek bir arama isteğiyle |
| Başlangıç ve bitiş tarihi | Zorunlu | Kullanılmaz |
| Kişi segmentleri ve hedef kişi sayısı | Segment zorunlu, hedef isteğe bağlı | Kullanılmaz |
| Kendiliğinden tamamlanır mı | Evet: hedefe ulaşılınca, aranacak kişi kalmayınca ya da bitiş tarihi gelince | Hayır, hiçbir zaman. Yalnızca siz tamamlayabilirsiniz |
| İlerleme sütunu | Tamamlanan ve hedef kişi sayısını gösteren bir ilerleme çubuğu | Arama sayısı, örneğin 0 arama |
Tetikleme modunu kampanyayı oluştururken Tetikleme Modu alanından seçersiniz. Sonradan değiştirilemez.
Yapay zeka ajanı kampanyası oluşturma
Yeni Kampanya'yı seçin, Yapay Zeka Ajanı'nı işaretleyin ve İleri'yi seçin.
Temsilci tipi kampanya oluşturulduktan sonra değiştirilemez. Planlı form şunları ister: kampanya adı, başlangıç ve bitiş tarihi, yapay zeka ajanı proje adı, kişi segmentleri, isteğe bağlı bir hedef kişi sayısı ve bir giden numara. Açabileceğiniz Çağrı Penceresi ve Çağrı Kuralları bölümleri de vardır.
Tetikleme Modu'nu Anlık yaptığınızda tarihler, segmentler ve hedef kaybolur, formda Anlık kampanyaların sürekli açık ve hedefsiz olduğunu, her arama talebini dış bir form veya API'nin anlık olarak ilettiğini anlatan bir açıklama görünür.
| Alan | Zorunlu | Notlar |
|---|---|---|
| Kampanya Adı | Evet | En fazla 100 karakter |
| Yapay Zeka Ajanı Proje Adı | Evet | En fazla 200 karakter. Yalnızca boşluk kabul edilmez. {, } ve ' karakterlerini içeremez |
| Tetikleme Modu | Planlı (varsayılan) veya Anlık | |
| Giden Numara | Varsayılan numara önceden seçilidir. Temizleyebilirsiniz | |
| Çağrı Penceresi | Anlık kampanyada en az bir gün açık olmalı | Her günün bir başlangıç saati, bir bitiş saati ve bir anahtarı vardır. Varsayılan olarak Pazartesi'den Cuma'ya 09:00 ile 18:00 arası açıktır |
| Maksimum Deneme Sayısı | Anlık kampanyada evet | Varsayılan 5. Kişi başına en fazla kaç arama denemesi yapılacağını belirler |
| Çağrılar Arası Bekleme (dakika) | Anlık kampanyada evet | Varsayılan 30. Ardışık denemeler arasındaki en kısa bekleme süresidir |
Anlık kampanyada tüm günleri kapatırsanız form Anlık kampanya için en az bir açık arama penceresi gerekir. uyarısını gösterir ve Oluştur düğmesi pasif kalır. Maksimum Deneme Sayısı ya da Çağrılar Arası Bekleme (dakika) alanını boşaltırsanız form Bu alan zorunludur. der.
Anlık kampanyayı yönetme
Satırın sonundaki menü simgesini seçin.
| İşlem | Ne yapar |
|---|---|
| Duraklat | Kampanyanın arama yapmasını durdurur. Duraklatılmışken gönderdiğiniz istekler kabul edilmez |
| Tamamla | Kampanyayı kalıcı olarak bitirir |
| Düzenle | Kampanyayı değiştirir. Tetikleme Modu kilitlidir |
| Kopyala | Bu kampanyadan yeni bir kampanya başlatır |
Anlık kampanyayı tamamlamak geri alınamaz. Kampanya bir daha başlatılamaz ve Kampanya Kimliğini kullanan dış sistemler çalışmayı durdurur. Yalnızca ara vermek istiyorsanız Duraklat'ı kullanın.
Yapay zeka ajanı kampanyası, art arda çok sayıda arama denemesi sistem kaynaklı bir nedenle başarısız olursa, örneğin etkin bir giden numara tanımlı değilse, kendiliğinden duraklar. Kendiliğinden devam etmez: nedeni giderin, sonra kampanyayı yeniden başlatın.
Kampanya ayrıntı sayfası
Bir kampanyanın adını seçerek açın.
Üst bölümde durum, Yapay Zeka Ajanı ve Anlık rozetleri, Kampanya Kimliği, yapay zeka ajanı projesi, maksimum deneme sayısı, aramalar arası bekleme ve Toplam Arama sayısı yer alır. Altında üç sekme vardır.
- Kişiler, kampanyadaki kişileri durumları, deneme sayıları ve sıradaki uygunluk zamanlarıyla listeler. Anlık kampanyada liste, arama istekleri geldikçe dolar.
- İşlem Logu, kampanyanın ne yaptığını zaman, işlem, sonuç, kural ve ayrıntıyla kaydeder. Kayıtlar 90 gün saklanır.
- Arama hattı, her aramanın geçtiği dört aşamayı gösterir: Arama planlayıcı, Kuyruğa alma, Arama başlatma ve Arama sonucu. Altında mevcut durumu anlatan bir cümle bulunur, örneğin Bekleyen arama talebi yok; kampanya bir sonraki tetiklemeye hazır.
Başka bir sistemden arama isteği gönderme
Başlıktaki Kampanya Kimliği, entegrasyonunuzun kullandığı numaradır. Kampanyayı yeniden adlandırsanız da değişmez. Yanındaki </> simgesini seçerek cURL olarak kopyala (ext-api) penceresini açın. Pencere, dış API'nin beş kampanya ucunu listeler. Birini seçtiğinizde o ucun cURL komutu panonuza kopyalanır. Komutu çalıştırmadan önce açılı parantez içindeki yer tutucuları değiştirin.
Kimlik doğrulama
OAuth client credentials akışıyla, SESTEK'in size verdiği istemci kimliği ve gizli anahtarla, AgenticCXExternal kapsamında bir erişim jetonu alın. Jetonu her istekte Authorization: Bearer <YOUR_ACCESS_TOKEN> olarak gönderin. Kiracıyı göndermezsiniz: jetondan alınır.
Beş uç
| Yöntem | Yol | Ne yapar |
|---|---|---|
| GET | /ext-api/v1/campaign/{campaignId} | Kampanyayı döner |
| POST | /ext-api/v1/campaign/{campaignId}/call-requests | Bir veya daha çok arama isteği gönderir |
| GET | /ext-api/v1/campaign/{campaignId}/call-requests | Gönderilen isteklerin bir sayfasını, en yeniden başlayarak döner |
| GET | /ext-api/v1/campaign/{campaignId}/call-requests-summary | İstekleri kabul sonucuna ve arama durumuna göre sayar |
| GET | /ext-api/v1/campaign/{campaignId}/call-requests/{clientReferenceId} | Tek bir referansla ne gönderildiğini ve sonunda ne olduğunu döner |
Bir istek gövdesi en fazla 100 öğe taşır. Her öğe aranacak bir kişidir ve clientReferenceId sizin kendi anahtarınızdır (örneğin bir sipariş numarası). Aynı anahtarı yeniden göndermek ikinci bir arama oluşturmaz: ilk sonucu geri alırsınız.
| Alan | Zorunlu | Sınır |
|---|---|---|
items | Evet | 1 ile 100 öğe |
clientReferenceId | Evet | En fazla 128 karakter. /, \, %, ? veya # içeremez |
contact.phoneNumber | Evet | En fazla 30 karakter |
contact.name | Evet | En fazla 200 karakter |
contact.email | Hayır | Geçerli bir adres, en fazla 256 karakter |
locale | Hayır | En fazla 16 karakter |
parameters | Hayır | En fazla 20 anahtar ve değer çifti. Anahtar en fazla 64, değer en fazla 512 karakter, toplam 4.000 bayt |
Her isteğe ne olur
Yanıt her zaman başarılıdır ve her öğenin sonucu kendi status alanında yer alır.
| Durum | Anlamı |
|---|---|
Queued | Kişi kampanyaya katıldı. Arama kısa süre sonra yapılır |
Deferred | Kabul edildi ama çağrı penceresi kapalı. nextEligibleAtUtc aramanın ne zaman yapılabileceğini söyler |
Merged | O kişinin zaten bekleyen bir araması vardı, istek ona eklendi. İkinci bir arama yapılmaz |
Rejected | Kabul edilmedi. rejectionReason değeri ContactPhoneInvalid, AdmissionContended veya AdmissionFailed olur. Son ikisi yeniden gönderilebilir |
Bir isteğin kabul edilmesi aramanın başladığı anlamına gelmez. Arama, kampanyanın çağrı penceresine, maksimum deneme sayısına ve aramalar arası beklemesine göre yapılır ve genellikle yaklaşık 15 saniye içinde başlar.
Kampanya istekleri hiç kabul edemiyorsa gövdenin tamamı şu hata kodlarıyla reddedilir.
error.code | Anlamı |
|---|---|
AgenticCX:ExternalApi:CampaignNotFound | Kiracınızda bu kimlikle bir kampanya yok |
AgenticCX:ExternalApi:CampaignNotInstantTrigger | Kampanya Anlık bir kampanya değil |
AgenticCX:ExternalApi:CampaignNotActive | Kampanya duraklatılmış veya tamamlanmış |
AgenticCX:ExternalApi:CampaignOutsideDateWindow | Kampanya kendi başlangıç ve bitiş tarihlerinin dışında |
Bir aramanın durumu call.state alanında bildirilir: NotStarted, Scheduled, Dialing, Completed, Cancelled veya Failed. NotStarted, kabul ile ilk deneme arasındaki normal durumdur.
Örnekler, sayfalama, tarih filtreleri ve yeniden deneme önerileriyle adım adım bir kılavuz için Anlık Kampanyaları API ile Tetikleme makalesine bakın. Tam sözleşme, Teknik Belgeler altındaki External API makalesindedir.
Bilmekte fayda var
- Dış API her zamanı UTC olarak bildirir (
Utcile biten alanlar). - Zaten bekleyen bir aramanın olduğu kişi için gelen istek birleştirilir, bu yüzden birleştirilen isteğin
parametersdeğerleri o aramada kullanılmaz. - Platform şu anda dış API için bir istek hızı sınırı yayımlamıyor.
- Aramalar yalnızca çağrı penceresi içinde yapılır. Pencere dışında gönderilen istekler
Deferredolarak kabul edilir ve pencere açıldığında aranır.