İlk temsilcinizi oluşturun

Ön koşullar

Ajanınızı oluşturma

Bu kılavuzda, örnek bir uygulama kullanarak nasıl aracı oluşturacağınız açıklanmaktadır. Örnek, bir temsilcinin işlevselliğini keşfetmek için hızlı bir yol sunar ve temsilci geliştirme süreciniz için başlangıç noktası olarak kullanılabilir. Mevcut bir uygulamayı temsilci içerecek şekilde değiştirmek istiyorsanız örnek, uygulama mantığınız için iyi bir model sunar.

Bu hızlı başlangıç kılavuzunda şunları yapacaksınız:

  • İş ortağı olarak kaydolma
  • Marka ve temsilci oluşturma
  • İsteğe bağlı olarak, Business Messages yardımcı robotuyla görüşme yaparak özellikleri keşfedin.
  • Temsilcinizi mesaj gönderip alacak şekilde ayarlama

Örneği kullanmadan aracı oluşturmak için Aracınızı oluşturma başlıklı makaleyi inceleyin.

İş ortağı olarak kaydolma

  1. Business Communications Developer Console'u açın.
  2. Business Messages bölümünde İş ortağı hesabı oluştur'u tıklayın.

  3. İş ortağı bilgilerinizi girin:

    Alan Değer
    Adınız Tam adınız
    İş ortağının adı Kuruluşunuzun adı
    İş ortağı web sitesi Kuruluşunuzun web sitesi
    Bölge İş Mesajları hizmetini barındırmak istediğiniz bölge

  4. İş Mesajları Hizmet Şartları'nı inceleyip kabul edin.

  5. Oluştur'u tıklayın.

Artık Business Messages iş ortağı olarak kayıtlısınız. Business Messages ve Business Communications API'lerinin etkinleştirildiği yeni bir Google Cloud projesi sizin için oluşturuldu. Bu projeye erişiminiz yoktur ve mevcut Google Cloud projelerinizden hiçbirini etkilemez.

Artık Business Messages ve Business Communications API'lerine erişebilirsiniz.

Hizmet hesabı oluşturma

  1. Business Communications Developer Console ana sayfasında İş ortağı hesabı ayarları'nı tıklayın.
  2. Soldaki gezinme menüsünde Hizmet hesabı'nı tıklayın.

  3. Anahtar oluştur'u ve Oluştur'u tıklayın.

    Tarayıcınız, hizmet hesabı anahtarını indirir. Güvenli bir konumda saklayın. Bu anahtarı daha sonra bir web uygulaması dağıtmak ve gelecekte Business Messages ile Business Communications API'lerine erişmek için kullanmanız gerekir.

Marka ve temsilci oluşturma

Temsilci, markayı yazılı olarak temsil eder. Kullanıcıların etkileşimde bulunduğu yazılı varlıktır. İşletmeyi temsil eden bir marka oluşturur ve tüketicilerin bu markayla sohbet ederek bağlantı kurabilmesi için bir temsilci oluşturursunuz.

  1. İşletme İletişimleri Geliştirici Konsolu'nu açın ve Business Messages Google Hesabınızla oturum açın.
  2. Create agent'ı (Ajan oluştur) tıklayın.
  3. Aracı türü için İş Mesajları'nı seçin.
  4. Marka adı ve Aracı adı için değerler girin.
  5. Aşağıdakilerden birini yapın:
    • Temsilcinizle görüşme yaparak mevcut özellikleri keşfetmek için Business Messages yardımcı robotunu etkinleştir'i seçin.
    • Temsilcinizi özelleştirmek ve mesaj işlemeye hazırlamak için Business Messages yardımcı robotunu etkinleştir seçeneğinin işaretini kaldırın.
  6. Create agent'ı (Ajan oluştur) tıklayın.

Business Messages yardımcı robotunu etkinleştirdiyseniz hemen görüşme başlatabilirsiniz. Aksi takdirde, temsilcinizi mesaj işleme için ayarlamaya devam edin.

Business Messages yardımcı robotuyla özellikleri keşfetme

Business Messages yardımcı robotu sayesinde temsilcinizle hemen görüşme başlatarak platformun sunduğu özellikleri deneyimleyebilirsiniz. Yardımcı Bot'u etkinleştirmek isteğe bağlıdır ancak ilk temsilcinizi oluştururken kesinlikle önerilir.

Yardımcı robot ile şunları yapabilirsiniz:

  • Zengin özellikleri keşfedin
  • Özellikleri nasıl uygulayacağınızı öğrenin
  • Aracı kurulumuyla ilgili kaynakları bulma

Yardımcı robot etkinleştirildiğinde temsilciniz için mesaj gönderip alır ve webhook kullanılması gerekmez. Kullanıcı mesajlarını işlemek için webhook ayarlayabilmeniz veya Dialogflow'u etkinleştirebilmeniz için yardımcı robotu devre dışı bırakmanız gerekir.

Yardımcı robotla görüşme başlatma

Business Messages yardımcı robotunu etkinleştirdikten sonra görüşme başlatabilirsiniz. Başlamanıza yardımcı olmak için temsilci oluşturulduktan hemen sonra bir iletişim kutusu açılır.

Yardımcı Bot ile etkileşimde bulunmak için bu iletişim kutusunda aşağıdaki adımları uygulayın:

  1. Aracının test URL'lerine erişin. Bunu yapmanın birkaç yolu vardır:

    • Android veya iOS düğmesini tıklayın. Ardından, ilgili mobil cihazla QR kodunu tarayın ve Başlat'ı tıklayın. Alternatif olarak, aracının test URL'sini kopyalamak için Android URL'sini kopyala veya iOS URL'sini kopyala'yı tıklayın.
    • URL'leri e-posta adresinize göndermek için Gönder'i tıklayın.

  2. URL'yi mobil cihazınızda açın. (iOS cihazlarda Google Haritalar uygulaması gerekir.)

Yardımcı robotu devre dışı bırakma

Temsilcinizi özelleştirip başlatmaya hazırlamadan önce Business Messages yardımcı robotunu devre dışı bırakmanız gerekir.

Yardımcı robotu devre dışı bırakmak için:

  1. Business Communications Developer Console'u açın.
  2. Temsilcinizi seçin.
  3. Sol gezinme menüsünde Entegrasyonlar'ı tıklayın.
  4. Yardımcı Robot için Devre dışı bırak'ı tıklayın.

Yardımcı robot devre dışı bırakıldığında temsilciniz için artık mesaj gönderip almaz. Artık temsilcinizi mesajlaşma akışını yönetecek şekilde ayarlayabilirsiniz.

Mesaj işleme için temsilcinizi ayarlama

Bu kılavuzda, kullanıcı mesajlarını işlemek için tasarlanmış bir webhook ile Google Cloud Platform'a (GCP) bir Echo Bot dağıtacaksınız.

Echo Bot, iletileri kullanıcıya geri gönderen örnek bir uygulamadır. Bu sayede, temsilcinizle yaptığınız görüşmede önerilen işlemler ve zengin kartlar gibi zengin özelliklerle denemeler yapabilirsiniz. Ayrıca, temsilcinizi geliştirmek için başlangıç noktası olarak Echo Bot'u da kullanabilirsiniz.

Aşağıdaki adımları tamamlayacaksınız:

  • Echo Bot örneğini GCP'ye dağıtma
  • Business Messages iş ortağı hesabınız için webhook URL'sini yapılandırma
  • Ajanınızla ilgili temel bilgileri sağlama

Bu kılavuzun sonunda, aracınız mesaj göndermeye ve almaya hazır olacaktır.

Web uygulamasını GCP'ye dağıtma

Business Messages, kullanıcılardan gelen mesajları altyapınızdaki bir webhook'a yönlendirir. Bu kılavuzda, Echo Bot örnek kaynak kodunu önceden yapılandırılmış bir webhook'a dağıtacaksınız. İleti almak için kullanabileceğiniz bir web altyapınız varsa bu web hizmetinde yeni bir webhook oluşturabilirsiniz ancak mantığı kendiniz yapılandırmanız gerekir. Ayrıntılı bilgi için İş ortağı düzeyinde webhook'unuzu ayarlama başlıklı makaleyi inceleyin.

Cloud ortamı oluşturma

Echo Bot örneğini dağıtmak için bir bulut ortamına ihtiyacınız vardır.

Bulut ortamı olarak GCP projesi oluşturmak için aşağıdaki adımları uygulayın:

  1. Google Cloud Console Proje Seçici'yi açın.

    Daha önce hiç Google Cloud projesi oluşturmadıysanız Şartlar ve Hizmetler'i kabul etmeniz gerekir.

  2. Proje Oluştur'u tıklayın.

  3. Yeni projeniz için bir ad ve konum girin.

    • Proje kimliğiniz otomatik olarak oluşturulur ve proje adınızın altında görünür.
    • Konum alanında, projeniz için olası konumları görüntülemek üzere Göz at'ı tıklayın. Google Workspace kuruluşunuzu bulamıyorsanız Google Workspace hesabında oturum açmamışsınızdır. Kuruluş olmadan proje oluşturabilirsiniz ancak bazı özellikler sınırlıdır. Daha fazla bilgi için Kuruluş kaynağının avantajları başlıklı makaleyi inceleyin.

  4. Oluştur'u tıklayın.

  5. Menü'yü tıklayın.

  6. Faturalandırma'yı tıklayın.

  7. Faturalandırma Hesabı Bağla'yı tıklayın.

  8. Yeni bir faturalandırma hesabı oluşturun veya mevcut bir faturalandırma hesabını projeye ekleyin. Ödeme seçeneklerini öğrenmek için Google Cloud Ücretsiz Programı Özellikleri başlıklı makaleyi inceleyin.

Echo Bot örneğini dağıtma

  1. gcloud CLI'yı yükleyin. Bu aracı, örnek kodu Google Cloud'a dağıtmak için kullanacaksınız.

  2. Echo Bot örneğini (Node.js, Java, Python) indirip ayıklayın.

  3. Hizmet hesabı oluşturma bölümünde indirdiğiniz JSON kimlik bilgileri dosyasını, örneğin kaynaklar klasörüne kopyalayın ve kimlik bilgilerini "bm-agent-service-account-credentials.json" olarak yeniden adlandırın. Bu kimlik bilgileri dosyasının yolu, indirdiğiniz örneğe bağlıdır.

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. Bir terminalde, örneğin full_sample dizinine gidin.

  5. Örneği dağıtmak için terminalde aşağıdaki komutları çalıştırın:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID, Bulut ortamı oluşturma bölümünde oluşturduğunuz projenin proje kimliğidir. Proje kimliği, Google Cloud'daki proje kontrol panelinde listelenir.

    Java

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID, Bulut ortamı oluşturma bölümünde oluşturduğunuz projenin proje kimliğidir. Proje kimliği, Google Cloud'daki proje kontrol panelinde listelenir.

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID, Bulut ortamı oluşturma bölümünde oluşturduğunuz projenin proje kimliğidir. Proje kimliği, Google Cloud'daki proje kontrol panelinde listelenir.

  6. Son komutun çıktısında dağıtılan uygulamanın URL'sini not edin. Bu, webhook URL'nizin temelidir:

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

Webhook'unuzu ayarlama

Echo Bot dağıtıldıktan sonra mesaj almaya başlamak için webhook URL'si (sizin işlettiğiniz) belirtmeniz gerekir.

  1. Business Communications Developer Console'da Hesap ayarları'nı açın.
  2. Doğru iş ortağı hesabının seçildiğinden emin olun.
  3. İş Mesajları webhook URL'si için Yapılandır'ı tıklayın.

  4. Webhook uç nokta URL'si alanına uygulamanızın URL'si + "/callback" değerini girin.

    Uç noktanız şu biçimde olacaktır: "https://PROJECT_ID.appspot.com/callback".

    Bu uç nokta, GCP'ye dağıttığınız örneğin uygulama mantığında önceden tanımlanmıştır.

  5. Developer Console'da Doğrula'yı tıklayın.

    İşletme Mesajları, webhook'unuzu doğruladığında iletişim kutusu kapanır.

Webhook'unuzu Business Communications API ile yapılandırmak için Örnek: Webhook URL'sini güncelleme başlıklı makaleyi inceleyin.

Webhook'unuzun Business Messages yüklerine başarılı bir şekilde yanıt verip vermediğini test etmek için Business Messages test çerçevesini kullanabilirsiniz.

Temsilci bilgilerini girme

Ajan kurulumunuzu tamamlamak için bazı temel bilgileri sağlayın.

  1. Business Communications Developer Console'u açın.
  2. Soldaki gezinme menüsünde Aracı bilgileri'ni tıklayın.

  3. Değerleri istediğiniz gibi güncelleyin veya aşağıdaki önerileri kullanın:

    Alan Değer
    Karşılama mesajı Echo Bot sohbetine hoş geldiniz.
    Gizlilik politikası https://policies.google.com/privacy

  4. Kaydet'i tıklayın.

Sohbete başlayın

Echo Bot ile etkileşim kurmak için aşağıdaki adımları uygulayın:

  1. Business Communications Developer Console'u açın.
  2. Soldaki gezinme menüsünde Aracı bilgileri'ni tıklayın.
  3. Aracı test URL'leri bölümünde Android veya iOS düğmesini tıklayın.

  4. QR kodunu ilgili mobil cihazla tarayın veya aracının test URL'sini kopyalamak için Android URL'sini kopyala ya da iOS URL'sini kopyala'yı tıklayın.

    URL'leri e-posta adresinize göndermek için Gönder'i de tıklayabilirsiniz.

  5. URL'yi mobil cihazınızda açın. (iOS cihazlarda Google Haritalar uygulaması gerekir.)

Temsilcinizin karşılama mesajı sizi karşılar. Bu noktada Echo Bot ile etkileşim kurabilirsiniz. Gönderdiğiniz iletileri size geri gönderir. Ayrıca, "carousel", "card", "chips" gibi belirli dizeler göndererek zengin özellikleri de çağırabilirsiniz.

Sonraki adımlar

İlk temsilcinizi oluşturduğunuza göre, Business Messages ve platformda yapabileceğiniz diğer işlemler hakkında daha fazla bilgi edinin.