Botunuzu otomatik olarak konuşmayı başlatacak şekilde yapılandırma

Burada kullandığınız Power Virtual Agents sürümünü seçin:

Varsayılan olarak Power Virtual Agents ile oluşturulmuş ve bir web sitesine yayımlanmış sohbet botları selamlama olmadan yüklenir ve pasif bir şekilde, kullanıcının konuşmayı başlatmasını bekler.

Ancak bot yüklendiğinde konuşmayı otomatik olarak başlatması için özel CSS ve JavaScript kodunu kullanabilirsiniz.

Örneğin, botunuzun yüklenir yüklenmez "Merhaba, Ben Roboti, sanal temsilciniz" demesini sağlayabilirsiniz.

Öncelikle, selamlamayı tetikleyen bağımsız değişkenleri içeren bir özel tuval dağıtmanız gerekir. Varsayılan olarak, özel tuval varsayılan sistem selamlama konusunu çağırır. Ancak varsayılan sistem selamlama konusunu yeni konuya yönlendirmeniz gerekse de selamlama olarak kullanılmak üzere yeni bir konu oluşturabilirsiniz.

Özelleştirilmiş selamlamayı botun görünümüne ait özelleştirmeyle birleştirebilirsiniz.

Önemli

Konuşmayı başlatabilen bot analizlerinizde yer alır ve oturum sayınızı artırır. Botunuzun kullanıcısı botla etkileşime geçmezse (örneğin, sayfayı yükler ancak bota soru sormazsa) oturum etkileşimsiz oturum olarak işaretlenir. Bu, analizlerinizi etkileyebilir.

Ön koşullar

Önemli

Yalnızca Microsoft Power Virtual Agents ürünüyle kullanım için bu belgelerde yer alan örnek kodları yükleyip kullanabilirsiniz. Örnek kod "olduğu gibi" lisanslanır ve tüm servis düzeyi sözleşmelerinden veya destek hizmetlerinden hariç tutulur. Kullanım riski size aittir. Microsoft hiçbir açık garanti veya koşul sunmaz ve satılabilirlik, belirli bir amaca uygunluk ve hak ihlali bulunmaması dahil olmak üzere tüm zımni garantileri açık bir şekilde reddeder.

Bot kimliği ayrıntılarını alma

Selamlamayı özelleştirmek için Bot Kimliğinizi bilmeniz gerekir.

Bot Kimliğini Kanallar altındaki Mobil uygulama öğesine giderek öğrenebilirsiniz.

Botunuz için özel bir tuval dağıtma

Bot yüklendiğinde varsayılan sistem selamlama konusunun görüntülenmesine neden olan bağımsız değişkenleri içeren özel bir tuvali dağıtmanız gerekir.

  1. Bot oluşturun ve yayımlayın.

  2. Aşağıdaki HTML kodunu kopyalayıp yapıştırın ve index.html olarak kaydedin.
    Aşağıdaki kodu kopyalayıp w3schools.com HTML deneme düzenleyicisine de yapıştırabilirsiniz. Yine de Bot Kimliğinizi eklemeniz gerekir.

      <!DOCTYPE html>
        <html>
        <head>
            <title>Contoso Sample Web Chat</title> 
            <!-- This styling is for the canvas demonstration purposes. It is recommended 
        that style is moved to separate file for organization in larger projects -->
            <style>
                html, body {
                    height: 100%;
                }
                body {
                    margin: 0;
                }
                h1 {
                    font-size: 16px;
                    font-family: Segoe UI;
                    line-height: 20px;
                    color: whitesmoke;
                    display: table-cell;
                    padding: 13px 0px 0px 20px;
                }
                .heading {
                    background-color: black;
                    height: 50px;
                }
                .main {
                    margin: 18px;
                    border-radius: 4px;
                }
    
                div[role="form"]{
                    background-color: black;
                }        
                #webchat {
                    position: fixed;
                    height: calc(100% - 50px);
                    width: 100%;
                    top: 50px;
                    overflow: hidden;
                }
              </style>
        </head>
        <body>
            <div>
                <div class="heading">
    
                    <!-- Change the h1 text to change the bot name -->    
                    <h1>Contoso Bot Name</h1>
    
                </div>
                <div id="webchat" role="main"></div>
            </div>    
          <script src="https://cdn.botframework.com/botframework-webchat/latest/webchat.js"></script>
          <script>
                const styleOptions = {
                   // Add styleOptions to customize web chat canvas
                   hideUploadButton: true
                };
    
                // Add your BOT ID below
                var BOT_ID = "<ENTER YOUR BOT ID>"; 
    
                var theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
    
                const store = window.WebChat.createStore(
                   {},
                   ({ dispatch }) => next => action => {
                       if (action.type === "DIRECT_LINE/CONNECT_FULFILLED") {
                          dispatch({
                              meta: {
                                   method: "keyboard",
                               },
                               payload: {
                                   activity: {
                                         channelData: {
                                              postBack: true,
                                         },
                                          //Web Chat will show the 'Greeting' System Topic message which has a trigger-phrase 'hello'
                                          name: 'startConversation',
                                          type: "event"
                                     },
                                },
                                type: "DIRECT_LINE/POST_ACTIVITY",
                           });
                     }
                     return next(action);
                  }
               );
               fetch(theURL)
                    .then(response => response.json())
                    .then(conversationInfo => {
                        window.WebChat.renderWebChat(
                            {
                                directLine: window.WebChat.createDirectLine({
                                    token: conversationInfo.token,
                                }),
                                store: store,
                                styleOptions: styleOptions
                            },
                            document.getElementById('webchat')
                        );
                    })
                    .catch(err => console.error("An error occurred: " + err));
            </script>
          </body>
        </html>
    
  3. Oluşturduğunuz index.html dosyasında, Bot Kimliğinizi var BOT_ID = "<ENTER YOUR BOT ID>" satırına girin.

  4. Botu özel tuvalde açmak için modern bir tarayıcı (örneğin, Microsoft Edge) kullanarak index.html dosyasını açın.

  5. Botunuzdan yanıt aldığınızdan ve botun doğru çalıştığından emin olmak için botu test edin.
    Sorunlarla karşılaşırsanız botu yayımladığınızdan ve Bot Kimliğinizin doğru yere eklendiğinden emin olun. var BOT_ID satırındaki eşittir işaretinden (=) sonra olmalı ve iki tarafında çift tırnak (") bulunmalıdır.

Botun varsayılan selamını değiştirme

index.html dosyasındaki kod, bot yüklendiğinde bir konunun otomatik olarak çağrılmasına neden olur. Varsayılan olarak, sistem selamlama konusunu çağırır. Ayrıca yeni bir konu oluşturup varsayılan sistem selamlama konusunu bu yeni konuya yönlendirebilirsiniz.

Her iki durumda da çağırmak istediğiniz konuda her zamanki gibi değişiklikler yapabilirsiniz.

index.html kodunu düzenlemek zorunda kalmamak için sistem selamlama konusunu değiştirmenizi öneririz.

  1. Yan gezinti bölmesinde Konular'ı seçin.

  2. Sistem Konuları başlığında, Selamlama konusu satırındaki Yazma tuvaline git simgesini seçin.

    Vurgulanan Selamlama konusunu içeren Konular sayfası ekran görüntüsü

  3. İleti düğümlerinin içindeki metni düzenleyin. Ayrıca başka düğümler ekleyebilir veya silebilirsiniz.

  4. İletiyi düzenleme işleminiz bittiğinde, Kaydet'i seçin.

    İleti düğümlerinin düzenlenebileceğini gösteren sistem selamlama konusunun ekran görüntüsü

  5. Botunuzu yayımlayın.

    En son bot içeriğini yayımlama

Artık botunuzun özel tuvalini dağıttığınız web sayfasına giderek botunuzu test edebilirsiniz. Selamlama konusunu otomatik olarak göstererek botun konuşma başlattığını görürsünüz.

Yeni kullanıcı konusu oluşturma

Uyarı

Konuşma başlatmak için kullanıcı konusu kullanmak faturalanan oturumlarınızı artırır. Faturalanan oturum, bir müşteri ile bir bot arasındaki etkileşimdir ve bir birim tüketimi temsil eder. Faturalanan oturum, bir kullanıcı konusu tetiklendiğinde başlar. Daha fazla bilgi için Faturalanan oturum bilgilerini analiz etme konusuna bakın.

  1. Yan gezinti bölmesinde Konular'ı seçin.

  2. Yeni konu'yu seçip bu konuya bir ad verin.

  3. Yazma tuvaline git'i seçin.

  4. İleti düğümünün içine metin ekleyin.

  5. İletiyi düzenleme işleminiz bittiğinde Kaydet'i seçin.

  6. Yan gezinti menüsünde, Konular başlığını tekrar seçin.

  7. Sistem Konuları başlığında, Selamlama konusu satırındaki Yazma tuvaline git simgesini seçin.

  8. Selamlama konusundaki ileti düğümlerini silin.

  9. Botu bir kullanıcı konusuna otomatik olarak yönlendirmek için + öğesini seçerek bir düğüm ekleyin ve ardından Başka bir konuya gidin.

  10. Açılır menüde, yukarıda oluşturduğunuz kullanıcı konusunu seçin.

  11. İletiyi düzenleme işleminiz bittiğinde Kaydet'i seçin.

  12. Botunuzu yayımlayın.

Artık botunuzun özel tuvalini dağıttığınız web sayfasına giderek botunuzu test edebilirsiniz. Yeni konuyu otomatik olarak göstererek botun konuşma başlattığını görürsünüz.