İlk temsilcinizi oluşturun

Ön koşullar

Temsilcinizi oluşturun

Bu kılavuz, örnek bir uygulamayı kullanarak nasıl aracı oluşturacağınız konusunda size yol gösterir. Örnek, bir temsilcinin işlevselliğini keşfetmek için hızlı bir yol sağlar ve aracı geliştirme çalışmanızın başlangıç noktası olarak kullanılabilir. Mevcut bir uygulamayı bir aracı içerecek şekilde değiştirmek isterseniz örnek, uygulama mantığınız için iyi bir model sunar.

Bu hızlı başlangıç kılavuzunda aşağıdakileri yapacaksınız:

  • İş ortağı olarak kaydolun
  • Marka ve temsilci oluşturma
  • İsteğe bağlı olarak, Business Messages Yardımcı Bot'u ile görüşmedeki özellikleri keşfedin
  • Temsilcinizi mesaj gönderip alacak şekilde ayarlayın

Örneği kullanmadan bir temsilci oluşturmak için Temsilcinizi oluşturma başlıklı makaleyi inceleyin.

İş ortağı olarak kaydolun

  1. İş İletişimi Geliştirici Konsolu'nu açın.
  2. İşletme Mesajları 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 Business Messages hizmetini barındırmak istediğiniz bölge

  4. Business Messages Hizmet Şartları'nı inceleyip kabul edin.

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

Artık bir Business Messages iş ortağı olarak kaydolmuşsunuz. Business Messages ve Business Communications API'lerin etkinleştirildiği yeni bir Google Cloud projesi oluşturuldu. Bu projeye erişiminiz yok. Bu durum, mevcut Google Cloud projelerinizin hiçbirini etkilemez.

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

Hizmet hesabı oluşturma

  1. İş İletişimi Geliştirici Konsolu ana sayfasında İş ortağı hesabı ayarları'nı tıklayın.
  2. Sol gezinme menüsünde Hizmet hesabı'nı tıklayın.

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

    Tarayıcınız, hizmet hesabı anahtarını indirir. Bunları güvenli bir yerde depolayın. İleride bir web uygulaması dağıtmak ve ileride Business Messages ile Business Communication API'lerine erişmek için bu anahtara ihtiyacınız olacak.

Marka ve temsilci oluşturma

Temsilci, bir marka olan ve kullanıcıların etkileşimde bulunduğu konuşmaya dayalı varlıktır. İşletmenizi temsil edecek bir marka oluşturun ve tüketicilerin işletmenizle diyalog kurabilmesi için bir temsilci oluşturun.

  1. Business Communications Developer Console'u açın ve Business Messages Google hesabınızla oturum açın.
  2. Temsilci oluştur'u tıklayın.
  3. Temsilci türü olarak İşletme Mesajları'nı seçin.
  4. Marka adı ve Temsilci adı için değerler girin.
  5. Aşağıdakilerden birini yapın:
    • Temsilcinizle kullanılabilen özellikleri keşfedebileceğiniz bir görüşme yapmak için Business Messages yardımcı robotunu etkinleştir'i seçin.
    • Temsilcinizi özelleştirmek ve mesaj işleme sürecine hazırlamak için Business Messages yardımcı robotunu etkinleştirin seçeneğinin işaretini kaldırın.
  6. Temsilci oluştur'u tıklayın.

Business Messages yardımcı robotunu etkinleştirdiyseniz hemen bir görüşme başlatabilirsiniz. Aksi takdirde, aracınızı mesaj işlemeye ayarlayın.

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

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

Yardımcı robot sayesinde

  • Zengin özellikleri keşfedin
  • Özelliklerin nasıl uygulanacağını öğrenin
  • Temsilci kurulumu için kaynakları bulun

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 ayarlamadan veya Dialogflow'u etkinleştirmeden Yardımcı Bot'u 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şturma işleminden hemen sonra bir iletişim kutusu açılır.

Yardımcı robotla etkileşim kurmak için bu iletişim kutusundan aşağıdaki adımları uygulayın:

  1. Temsilcinin 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, temsilcinin 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. Mobil cihazınızda URL'yi açın. (iOS cihazlar için Google Haritalar uygulaması gerekir.)

Yardımcı Bot'u Devre Dışı Bırakma

Temsilcinizi özelleştirebilmek ve kullanıma hazırlayabilmek için Business Messages yardımcı robotunu devre dışı bırakmanız gerekir.

Yardımcı Bot'u devre dışı bırakmak için

  1. İş İletişimi Geliştirici Konsolu'nu açın.
  2. Temsilcinizi seçin.
  3. Sol gezinme menüsünde Entegrasyonlar'ı tıklayın.
  4. Yardımcı Bot için Devre dışı bırak'ı tıklayın.

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

Mesaj işleme için temsilcinizi ayarlayın

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

Echo Bot, mesajları kullanıcıya tekrar yansıtması için örnek bir uygulamadır. Bu sayede, temsilcinizle yapılan görüşmelerde önerilen işlemler ve zengin kartlar gibi zengin özelliklerle denemeler yapabilirsiniz. Temsilcinizi geliştirmek için başlangıç noktası olarak Echo Bot'u da kullanabilirsiniz.

Aşağıdaki adımları tamamlayabilirsiniz:

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

Bu kılavuzun sonunda, temsilciniz mesaj gönderip 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. Mesaj almak için halihazırda bir web altyapınız varsa söz konusu web hizmetinde yeni bir webhook oluşturabilirsiniz. Ancak mantığı sizin yapılandırmanız gerekir. Ayrıntılar için İş ortağı düzeyinde webhook'unuzu ayarlama başlıklı makaleye bakın.

Cloud ortamı oluşturma

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

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

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

    Daha önce hiç Google Cloud projesi oluşturmadıysanız Hükümler ve Hizmetleri 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, projenizin potansiyel konumlarını görüntülemek için Göz at'ı tıklayın. Google Workspace kuruluşunuzu bulamıyorsanız bir Google Workspace hesabında oturum açmamışsınızdır. Kuruluş olmadan da proje oluşturabilirsiniz ancak bazı özellikler sınırlıdır. Daha fazla bilgi edinmek için Kuruluş kaynağının avantajları başlıklı makaleye bakın.

  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. Projeye yeni bir faturalandırma hesabı oluşturun veya mevcut bir faturalandırma hesabını ekleyin. Ödeme seçeneklerini anlamak için Google Cloud Ücretsiz Program Özellikleri'ne göz atın.

Echo Bot örneğini dağıtma

  1. gcloud KSA'yı yükleyin. Bunu kullanarak örnek kodu Google Cloud'a dağıtabilirsiniz.

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

  3. Hizmet hesabı oluşturma bölümünde indirdiğiniz JSON kimlik bilgisi 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 tam_örnek dizinine gidin.

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

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID, Cloud ortamı oluşturun 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, Cloud ortamı oluşturun 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, Cloud ortamı oluşturun bölümünde oluşturduğunuz projenin proje kimliğidir. Proje Kimliği, Google Cloud'daki proje kontrol panelinde listelenir.

  6. Son komutun sonucunda, dağıtılan uygulamanın URL'sini not edin. Webhook URL'nizin temeli şudur:

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

Webhook'unuzu ayarlayın

Yankı Bot'u dağıtıldığına göre mesaj almaya başlamak için webhook URL'si (operatör) 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. Business Messages webhook URL'si için Yapılandır'ı tıklayın.

  4. Webhook uç nokta URL'si için, uygulamanızın URL'sini + "/callback" değerini girin.

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

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

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

    Business Messages 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 bölümüne bakın.

Webhook'un, 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 girin

Temsilcinizin kurulumunu tamamlamak için bazı temel bilgileri sağlayın.

  1. İş İletişimi Geliştirici Konsolu'nu açın.
  2. Sol gezinme menüsünden Temsilci bilgileri'ni tıklayın.

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

    Alan Değer
    Karşılama mesajı Yankı Bot'u görüşmesine hoş geldiniz!
    Gizlilik politikası https://policies.google.com/privacy

  4. Kaydet'i tıklayın.

Görüşmeyi başlatın

Yankı Bot'u ile etkileşimde bulunmak için şu adımları uygulayın:

  1. İş İletişimi Geliştirici Konsolu'nu açın.
  2. Sol gezinme menüsünden Temsilci bilgileri'ni tıklayın.
  3. Temsilci test URL'leri bölümünde, Android veya iOS düğmesini tıklayın.

  4. İlgili mobil cihazla QR kodunu tarayın veya temsilcinin 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 de tıklayabilirsiniz.

  5. Mobil cihazınızda URL'yi açın. (iOS cihazlar için Google Haritalar uygulaması gereklidir.)

Temsilcinizin karşılama mesajı sizi karşılar. Bu noktada eko bot'la etkileşim kurabilirsiniz. Size gönderdiğiniz mesajları tekrarlar. Ayrıca, belirli özellikleri (ör. "bant", "kart", "çip") göndererek zengin özellikleri çağırabilirsiniz.

Sonraki adımlar

İlk temsilcinizi oluşturduğunuza göre Business Messages ve platformda başka neler yapabileceğiniz hakkında daha fazla bilgi edinin.