İlk temsilcinizi oluşturun

Ön koşullar

Temsilcinizi oluşturun

Bu kılavuz, örnek bir uygulama kullanarak aracı oluşturma konusunda size yol gösterir. Örnek, bir aracının işlevlerini keşfetmenin hızlı bir yolunu sunar ve temsilci geliştirme süreciniz için bir başlangıç noktası olarak kullanılabilir. Mevcut bir uygulamayı bir aracı içerecek şekilde değiştirmek istiyorsanız bu ö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 aracı oluşturma
  • Dilerseniz Business Messages ile bir görüşmedeki özellikleri keşfedebilirsiniz. Yardımcı Bot
  • Mesaj göndermek ve almak için temsilcinizi ayarlayın

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

İş ortağı olarak kaydolun

  1. Şunu açın: Business Communications Developer Console.
  2. Business Messages altında İş 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. Şu belgeyi inceleyin ve kabul edin: Business Messages Hizmet Şartları.

  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 oluşturuldu. Bu projeye erişiminiz yok ve mevcut Google Cloud projelerinizi engellemeyecek.

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. Sol gezinme menüsünde Hizmet hesabı.

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

    Tarayıcınız hizmet hesabı anahtarını indirir. Verilerinizi güvenli bir konum. Daha sonra bir web uygulamasını dağıtmak ve Business Messages ve Business Communications API'lerine erişebileceksiniz.

Marka ve aracı oluşturma

Temsilci, bir markayı (konuşmaya dayalı varlık) temsil eder. daha fazla bilgi sağlar. İşletmeyi temsil edecek bir marka oluşturuyorsunuz Tüketicilerin diyaloğa dayalı olarak bağlantı kurabilmesi için bir temsilci oluşturmalıdır.

  1. Business Communications Developer'u (İşletme İletişimi Geliştirici) açın. Konsol ve Business Messages Google hesabınızla oturum açın.
  2. Temsilci oluştur'u tıklayın.
  3. Temsilci türü olarak Business Messages'ı seçin.
  4. Marka adı ve Temsilci adı için değerler girin.
  5. Aşağıdakilerden birini yapın:
    • Temsilcinizle görüşme yapmak için Business Messages yardımcı robotunu etkinleştir'i seçin.
    • Temsilcinizi özelleştirmek ve mesaj işlemeye hazırlamak için temsilcinin seçimini kaldırın. Business Messages yardımcı robotunu etkinleştirin.
  6. Temsilci oluştur'u tıklayın.

Business Messages yardımcı robotunu etkinleştirdiyseniz hemen görüşme başlatabilirsiniz. Aksi halde Mesaj işleme için temsilcinizi ayarlama bölümüne gidin.

Business Messages yardımcı robotu ile özellikleri keşfedin

Business Messages yardımcı robotu, müşterilerinizle hızlıca görüşme yardımcı oluyorum. Böylece platformun sunduğu olanakları deneyimleyebilirsiniz. Yardımcıyı etkinleştirme Bot isteğe bağlıdır ancak ilk aracınızı oluştururken kesinlikle önerilir.

Yardımcı robot sayesinde

  • Zengin özellikleri keşfedin
  • Özellikleri nasıl uygulayacağınızı öğrenin
  • Aracı kurulumu için kaynaklar bulun

Yardımcı robot etkinleştirildiğinde temsilciniz için mesaj gönderip alır; bunun için web kancası gerekmez. Yardımcı bot'u devre dışı bırakmanız gerekir. bir webhook ayarlamadan veya Dialogflow'u etkinleştirmeden önce kullanıcı mesajlarını işleyebilir.

Yardımcı robot ile görüşme başlatın

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

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

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

    • Android düğmesini veya iOS düğmesini tıklayın. Ardından QR kodunu tarayın açın ve Başlat'ı tıklayın. Alternatif olarak, kopyalamak için Android URL'sini kopyala veya iOS URL'sini kopyala'yı tıklayın. müşteri temsilcisinin test URL'si.
    • 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 cihazları için Google Haritalar app.)

Yardımcı Bot'u devre dışı bırak

Temsilcinizi özelleştirip lansmana hazırlamadan önce şunları yapmanız gerekir: Business Messages yardımcı robotunu devre dışı bırakın.

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

  1. Business Communications Developer'u (İşletme İletişimi Geliştirici) açın. Konsol.
  2. Temsilcinizi seçin.
  3. Sol gezinme menüsünde Integrations'ı (Entegrasyonlar) tıklayın.
  4. Yardımcı Bot için Devre dışı bırak'ı tıklayın.

Yardımcı robot devre dışı bırakıldığında artık aşağıdakiler için mesaj gönderip almaz. temsilcinize gönderin. Artık şu işlemleri yapması için temsilcinizi ayarlayabilirsiniz: mesaj akışı sağlanıyor.

Mesaj işleme için temsilcinizi ayarlayın

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

Echo Bot, mesajları kullanıcıya tekrarlayan örnek bir uygulamadır. Google izleme ve raporlama gibi zengin özelliklerle denemeler yapmanıza olanak tanır. önerilen işlemler ve zengin kartlar görüşmeniz gerekebilir. Echo Bot'u başlangıç olarak da kullanabilirsiniz: tek noktanız budur.

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
  • 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ı bir webhook'a yönlendirir kontrol edebilirsiniz. Bu kılavuzda Yankı Bot örneğini dağıtacaksınız önceden yapılandırılmış bir webhook'a dönüştürmenizi sağlar. Web altyapınız varsa web kancası üzerinden yeni bir webhook oluşturabilirsiniz. hizmeti kullanmaya devam edebilirsiniz, ancak mantığı kendiniz yapılandırmanız gerekir. Görüntüleyin İş ortağı düzeyinde webhook'unuzu ayarlama inceleyebilirsiniz.

Cloud ortamı oluşturma

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

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

  1. Şunu açın: Google Cloud Console Proje Seçici.

    Daha önce 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ın altında görünür.
    • Konum alanında, projenizin olası 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ız demektir. 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. 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 sayfasına bakın.

Yankı Bot örneğini dağıtma

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

  2. Yankı Bot örneğini indirme ve ayıklama (Node.js, Java, Python) içerir.

  3. İndirdiğiniz JSON kimlik bilgileri dosyasını kopyalayın. Örneğin kaynaklar klasöründe bir hizmet hesabı oluşturun 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. Terminalde örneğin full_sample dizinine gidin.

  5. Örneği dağıtmak için bir 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, şurada oluşturduğunuz projenin kimliğidir: Bir bulut ortamı oluşturun. 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, şurada oluşturduğunuz projenin kimliğidir: Bir bulut ortamı oluşturun. 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, şurada oluşturduğunuz projenin kimliğidir: Bir bulut ortamı oluşturun. Proje kimliği, Google Cloud'daki proje kontrol panelinde listelenir.

  6. Dağıtılan uygulamanın URL'sini, son komutun çıkışında not edin. Bu, webhook URL'nizin temelini oluşturur:

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

Webhook'unuzu ayarlama

Yankı Bot'u dağıtıldığına göre, bir webhook URL'si belirtmeniz ( çalıştırma) ileti alma hakkında daha fazla bilgi edinin.

  1. Şunu açın: Hesap ayarları Business Communications Developer Console'da bulabilirsiniz.
  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 ve "/callback"i girin.

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

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

  5. Geliştirici Konsolu'nda 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 bkz. Örnek: Webhook URL'sini güncelleme.

Business Messages test çerçevesini kullanabilirsiniz. webhook'unuzun Business Messages yüküne başarılı şekilde yanıt verip vermediğini test edin.

Temsilci bilgilerini girin

Temsilci kurulumunuzu tamamlamak için bazı temel bilgileri girin.

  1. Business Communications Developer'u (İşletme İletişimi Geliştirici) açın. Konsol.
  2. Soldaki gezinme panelinde Temsilci 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.

İletişime geçin

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

  1. Business Communications Developer'u (İşletme İletişimi Geliştirici) açın. Konsol.
  2. Soldaki gezinme panelinde Temsilci bilgileri'ni tıklayın.
  3. Aracı test URL'leri bölümünde Android düğmesini veya iOS düğmesini tıklayın.

  4. QR kodunu ilgili mobil cihazla tarayın veya Kopyala Aracının test URL'sini kopyalamak için Android URL'si 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. URL'yi mobil cihazınızda açın. (iOS cihazları için Google Haritalar uygulaması için geçerlidir.)

Temsilcinizin karşılama mesajı sizi karşılıyor. Bu aşamada, sizinle iletişime yardımcı oluyor. Size gönderdiğiniz mesajları tekrarlar. Ayrıca, Belirli dizeler göndererek zengin özellikleri çağırmak için: "bant", "kart", "çipler".

Sonraki adımlar

İlk temsilcinizi oluşturduğunuza göre Business Messages hakkında daha fazla bilgi edinebilirsiniz başka neler yapabileceğinizi öğrenin.