Mesajlaşmanın kullanılabilirliğini ayarlayın

Kullanıcıların temsilcinizle görüşme başlatmaya başlayabilmesi için Business Messages'ta temsilcinizin mesajlaşma durumunuzu ayarlamanız gerekir.

Bir kullanıcı, uygun saatlerde temsilcinize mesaj gönderirse temsilciniz bir karşılama mesajı ve görüşmeler başlatan kullanıcıyı karşılar. Görüşme, uygun saatlerin dışında başlarsa kullanıcılar, temsilcinin çevrimdışı mesajını görür. Bu mesajlar hakkında daha fazla bilgi edinmek için Görüşmeyi başlatma bölümüne göz atın.

Bot ve insan müsaitlik durumu

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

Temsilciniz için mesaj oluşturan bir otomasyon varsa (otomasyon, kullanıcılara kuyruğa girmelerini söyleyen bir otomatik yanıtlayıcı, kullanıcı ayrıntılarına dinamik erişimi olan karmaşık bir doğal dil anlama aracı veya bunların arasında herhangi bir şey) bot mesajlaşma özelliğinin kullanılabilirliğini belirtin.

Konuma dayalı giriş noktaları ve yerel olmayan giriş noktaları (Google Ads hariç) dahil olmak üzere Google tarafından yönetilen giriş noktalarında bir temsilci başlatmak istiyorsanız insan müsaitlik durumu gereklidir. Müsaitlik durumu için yalnızca, haftanın hangi günlerinde ve soruları cevaplayabileceğiniz canlı saatleri belirtin.

Bot temsilcileri günde 24 saat hizmet veriyorsa ancak insan temsilcileri 08:00 ile 20:00 saatleri arasında hizmet veriyorsa bunları bağımsız olarak belirtebilirsiniz.

Ayrıca, hem bot hem de insan müsaitlik durumunu belirtirseniz bot temsilcileri ihtiyaçlarına cevap veremediğinde kullanıcılardan canlı müşteri isteğinde bulunmalarını istemek için canlı temsilci istek önerileri gönderebilirsiniz.

Mesajlaşmanın kullanılabilirliğini güncelleyin

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

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

Ön koşullar

Mesajlaşmanın kullanılabilirliğini güncellemeden önce aşağıdakilere ihtiyacınız vardır:

  • Geliştirme makinenizde GCP projenizin hizmet hesabı anahtarına giden yol

  • Temsilci name (örneğin, "markalar/12345/agents/67890")

    Temsilcinin name bilgilerini bilmiyorsanız Marka için tüm temsilcileri listeleme bölümüne bakın.

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

  • İnsan müsaitlik durumu saat dilimleri, haftanın günleri ve saatler

Mevcut primaryAgentInteraction ve additionalAgentInteractions değerlerini bilmiyorsanız Temsilci bilgilerini alma bölümüne göz atın.

Güncelleme isteğini gönder

Temsilciyi güncellemek için aşağıdaki komutu çalıştırın. Değişkenleri Ön koşullar'da tanımladığınız değerlerle değiştirin.

Hem bot hem de insan mesajlaşma özelliğini kullanıyorsanız primaryAgentInteraction ile botların kullanılabilirliğini ve additionalAgentInteractions bir örneğini kullanın.

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"
              }
            ]
          }
        }
      }
    ]
  }
}'
update-agent-bm-agentInteractions-bot-and-human.sh

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"
            }
          ]
        }
      }
    }
  }
}'
update-agent-bm-agentInteractions-bot.sh

Yalnızca insan 


# 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"
            }
          ]
        }
      }
    }
  }
}'
update-agent-bm-agentInteractions-human.sh

Biçimlendirme ve değer seçenekleri için brands.agents.patch ve SupportedAgentInteraction sayfalarına bakın.