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

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

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

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

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

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

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

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

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

Обновить доступность сообщений

Чтобы обновить доступность обмена сообщениями, вы отправляете запрос PATCH с помощью API бизнес-коммуникаций, чтобы обновить поля 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 .