Эта страница переведена с помощью Cloud Translation API.

Установить доступность обмена сообщениями

Прежде чем пользователи смогут начать общение с вашим агентом, вам необходимо настроить доступность обмена сообщениями вашего агента в Business Messages.

Если пользователь отправляет сообщение вашему агенту в доступные часы, ваш агент приветствует пользователя приветственным сообщением и начинает разговор. Если беседа начинается в нерабочее время, пользователи увидят сообщение агента в автономном режиме. Дополнительные сведения об этих сообщениях см. в разделе Начало беседы .

Доступность ботов и людей

Вы можете указать отдельную доступность бота и представителя человека.

Если у вас есть какая-либо автоматизация, составляющая сообщения для вашего агента — будь то автоматизация, сообщающая пользователям их место в очереди, сложный агент, понимающий естественный язык, который имеет динамический доступ к сведениям о пользователе, или что-то среднее — укажите бота доступность обмена сообщениями.

Доступность человека обязательна, если вы хотите запустить агент в точках входа, управляемых Google, включая точки входа на основе местоположения и нелокальные точки входа (кроме Google Ads). Для доступности людей укажите только дни недели и часы, когда у вас есть живые агенты, которые могут ответить на вопросы.

Если представители ботов доступны 24 часа в сутки, а представители людей доступны с 8:00 до 20:00, вы можете указать их независимо.

Кроме того, если вы укажете доступность как для бота, так и для человека, вы можете отправлять предложения по запросам активных агентов, чтобы предлагать пользователям запрашивать активных агентов, если представители ботов не могут удовлетворить их потребности.

Обновление доступности обмена сообщениями

Чтобы обновить доступность обмена сообщениями, вы делаете запрос PATCH с API Business Communications для обновления полей primaryAgentInteraction и additionalAgentInteractions агента.

Когда вы обновляете эти поля, вы должны включать значения для всех полей в объекте SupportedAgentInteraction. Запросы на обновление перезаписывают содержимое всех полей, которые вы редактируете, включая любые дочерние поля. Например, если вы делаете запрос на добавление экземпляра в hours , вам также необходимо включить все предыдущие экземпляры hours , иначе ваше обновление перезапишет их.

Предпосылки

Перед обновлением доступности обмена сообщениями вам потребуются следующие элементы:

Путь к ключу сервисной учетной записи вашего проекта GCP на вашем компьютере для разработки
name агента (например, «brands/12345/agents/67890»)
Если вы не знаете name агента, см. Список всех агентов для бренда .
Часовые пояса доступности ботов, дни недели и часы
Часовые пояса доступности людей, дни недели и часы

Если вы не знаете текущие primaryAgentInteraction и additionalAgentInteractions , см. раздел Получение информации об агенте .

Отправить запрос на обновление

Чтобы обновить агент, выполните следующую команду. Замените переменные значениями, указанными в предварительных требованиях .

Если у вас есть возможность обмена сообщениями как с ботом, так и с человеком, укажите доступность для бота в primaryAgentInteraction и доступность для человека в экземпляре additionalAgentInteractions .

Бот и человек


# 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

только для ботов


# 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

Только для человека


# 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

Параметры форматирования и значений см. brands.agents.patch и SupportedAgentInteraction .