Mesajlaşma kullanılabilirliğini ayarlama

Kullanıcıların temsilcinizle görüşme başlatabilmesi için Business Messages'da temsilcinizin mesajlaşma durumunu ayarlamanız gerekir.

Bir kullanıcı, müsaitlik saatleri içinde temsilcinize mesaj gönderirse temsilciniz kullanıcıyı karşılama mesajı ve sohbet başlatıcılarla karşılar. Sohbet, müsaitlik saatleri dışında başlarsa kullanıcılar temsilcinin çevrimdışı mesajını görür. Bu mesajlar hakkında daha fazla bilgi için Sohbeti başlatma bölümüne bakın.

Bot ve insan kullanılabilirliği

Ayrı bot ve insan temsilcisi kullanılabilirliği belirtebilirsiniz.

Otomasyon, kullanıcılara sıradaki yerlerini bildiren bir otomatik yanıtlayıcı, kullanıcı ayrıntılarına dinamik erişimi olan karmaşık bir doğal dil anlama aracısı veya bu ikisi arasında herhangi bir şey olsa da aracınız için mesaj oluşturan herhangi bir otomasyonunuz varsa bot mesajlaşma kullanılabilirliğini belirtin.

Google Ads hariç olmak üzere konuma dayalı giriş noktaları ve yerel olmayan giriş noktaları dahil olmak üzere Google tarafından yönetilen giriş noktalarında bir aracı başlatmak istiyorsanız insan kullanılabilirliği zorunludur. İnsanların müsaitlik durumu için yalnızca soruları yanıtlayabilecek canlı temsilcilerinizin olduğu günleri ve saatleri belirtin.

Bot temsilciler 24 saat, gerçek temsilciler ise 08:00-20:00 saatleri arasında hizmet veriyorsa bu saatleri ayrı ayrı belirtebilirsiniz.

Ayrıca, hem bot hem de müşteri temsilcisi kullanılabilirliğini belirtirseniz bot temsilcileri kullanıcıların ihtiyaçlarını karşılayamadığında kullanıcıları canlı müşteri temsilcisi isteğinde bulunmaya yönlendirmek için canlı müşteri temsilcisi isteği önerileri gönderebilirsiniz.

Mesajlaşma özelliğinin kullanılabilirliğini güncelleme

Mesajlaşma özelliğinin kullanılabilirliğini güncellemek için Business Communications API ile bir PATCH isteği göndererek temsilcinin primaryAgentInteraction ve additionalAgentInteractions alanlarını güncellersiniz.

Bu alanları güncellerken SupportedAgentInteraction nesnesindeki tüm alanların değerlerini eklemeniz gerekir. Güncelleme istekleri, alt alanlar da dahil olmak üzere düzenlediğiniz tüm alanların içeriğinin üzerine yazar. Örneğin, hours'ya bir örnek ekleme isteğinde bulunursanız önceki tüm hours örneklerini de eklemeniz gerekir. Aksi takdirde güncellemeniz bu örneklerin üzerine yazılır.

Ön koşullar

Mesajlaşma özelliğinin kullanılabilirliğini güncellemeden önce aşağıdaki öğelere ihtiyacınız vardır:

  • Geliştirme makinenizde GCP projenizin hizmet hesabı anahtarının yolu

  • Aracı name (örneğin, "brands/12345/agents/67890")

    Temsilcinin name bilmiyorsanız Bir marka için tüm temsilcileri listeleme başlıklı makaleyi inceleyin.

  • Botun kullanılabilir olduğu saat dilimleri, haftanın günleri ve saatler

  • Müşteri temsilcilerinin müsaitlik durumuna göre saat dilimleri, haftanın günleri ve saatler

Mevcut primaryAgentInteraction ve additionalAgentInteractions değerlerini bilmiyorsanız Aracı bilgilerini alma başlıklı makaleyi inceleyin.

Güncelleme isteğini gönderme

Aracıyı güncellemek için aşağıdaki komutu çalıştırın. Değişkenleri Ön koşullar bölümünde belirlediğiniz değerlerle değiştirin.

Hem bot hem de insan mesajlaşma uygunluğunuz varsa primaryAgentInteraction içinde bot uygunluğunu, additionalAgentInteractions örneğinde ise insan uygunluğunu belirtin.

Bot ve insan 

# This code updates the agent interaction of a bot and human representatives.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

# Replace the __BRAND_ID__ and __AGENT_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction,businessMessagesAgent.additionalAgentInteractions" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "BOT",
      "botRepresentative": {
        "botMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    },
    "additionalAgentInteractions": [
      {
        "interactionType": "HUMAN",
        "humanRepresentative": {
          "humanMessagingAvailability": {
            "hours": [
              {
                "startTime": {
                  "hours": 8,
                  "minutes": 0
                },
                "endTime": {
                  "hours": 20,
                  "minutes": 0
                },
                "timeZone": "America/Los_Angeles",
                "startDay": "MONDAY",
                "endDay": "SUNDAY"
              }
            ]
          }
        }
      }
    ]
  }
}'

Yalnızca bot 

# This code updates the primary agent interaction of a bot representative
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

# Replace the __BRAND_ID__ and __AGENT_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "BOT",
      "botRepresentative": {
        "botMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    }
  }
}'

Yalnızca insanlar 

# This code updates the primary agent interaction of a human representative
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

# Replace the __BRAND_ID__ and __AGENT_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "HUMAN",
      "humanRepresentative": {
        "humanMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    }
  }
}'

Biçimlendirme ve değer seçenekleri için brands.agents.patch ve SupportedAgentInteraction bölümlerine bakın.