Консоль разработчика бизнес-коммуникаций

Business Messages предоставляет пользовательский веб-интерфейс, называемый Консолью разработчика Business Communications . Вы используете эту консоль для создания, управления и запуска агентов.

Консоль разработчика бизнес-коммуникаций отличается от Google Cloud Platform . (GCP) Консоль. Вы используете консоль разработчика Business Communications для управления агентами Business Messages, а консоль GCP — для управления специфическими настройками GCP (например, выставлением счетов и API) и другими ресурсами GCP.

Хотя вы можете использовать консоль разработчика Business Communications для создания агентов и управления ими, вы также можете использовать API Business Communications для создания и управления агентами для расширенных сценариев, таких как интеграция в ваш собственный продукт.

Краткое руководство и практические руководства проведут вас через этапы использования как консоли, так и API. На этой странице представлена ​​общая информация о макете пользовательского интерфейса и о том, для чего используется консоль.

Как используется консоль

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

Главный экран консоли

При первоначальной загрузке консоли вы увидите экран выбора агента. На этой странице ссылка «Настройки учетной записи партнера» открывает страницу настроек вашей учетной записи партнера.

Кроме того, главный экран используется для:

  • Выберите существующий агент.
  • Создайте новых агентов.
  • Сортировать агентов.
  • Фильтр агентов по учетной записи партнера.

По умолчанию агенты отображаются в карточке. Агенты упорядочены по дате последнего обновления. Чтобы перейти к представлению в виде списка, используйте параметры «Просмотр как» справа. В представлении списка агенты можно сортировать по имени, типу, статусу и дате последнего обновления.

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

Настройки учетной записи

На странице настроек вы можете обновить:

  • Наименование фирмы
  • Отображаемое имя
  • Технический контактный пункт
  • Вебхук

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

Управление торговой маркой

Бренд — это бизнес, организация или группа. Агент — это разговорное представление бренда.

Используйте эту страницу для добавления, редактирования и удаления брендов. При удалении бренда также удаляются все связанные с ним агенты. Бренд нельзя удалить, если он связан с запущенным агентом.

Управление пользователями

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

Добавить пользователя

Чтобы добавить пользователя, введите его адрес электронной почты в поле ввода адреса электронной почты и выберите роль.

Новые пользователи могут иметь роли Менеджера или Читателя . Роль менеджера имеет доступ ко всем функциям консоли, а роль читателя обеспечивает доступ только для чтения к агенту и информации о местоположении.

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

Адрес электронной почты, на который первоначально была зарегистрирована учетная запись партнера, имеет роль владельца .

Удалить пользователя

Чтобы удалить пользователя:

  1. Найдите в списке пользователя, которого хотите удалить.
  2. Нажмите кнопку .
  3. Выберите Удалить пользователя.
  4. Подтвердите удаление.

Пользователь, которого вы удалили, получает уведомление по электронной почте о том, что у него больше нет доступа к учетной записи.

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

Изменить роль пользователя

Чтобы обновить роль пользователя:

  1. Найдите пользователя, которого хотите обновить.
  2. Нажмите кнопку .
  3. Выберите Изменить роль.
  4. Выберите новую роль из раскрывающегося списка.
  5. Щелкните Сохранить.

Сервисные аккаунты

Когда вы совершаете вызовы к API-интерфейсам Business Communications и Business Messages, вы аутентифицируете вызовы с помощью ключа сервисной учетной записи. Ключи сервисной учетной записи позволяют вам создавать и управлять брендами, агентами и местоположениями, а также отправлять сообщения и запросы в качестве вашего агента.

Чтобы сгенерировать ключ служебной учетной записи, выберите «Учетные записи служб» на боковой панели навигации. Откроется консоль GCP для проекта GCP, связанного с текущей выбранной учетной записью партнера.

Чтобы создать учетную запись службы и ключ:

  1. Щелкните Создать сервисный аккаунт .
  2. В поле «Имя учетной записи службы» введите имя своего агента, затем нажмите «Создать» .
  3. Щелкните Готово .
  4. Найдите новый сервисный аккаунт в таблице, затем нажмите > Создать ключ .
  5. Выберите JSON и нажмите «Создать» .

Ваш браузер загружает ключ сервисной учетной записи.

Выбор агента

После выбора агента вы попадете на страницу обзора для выбранного агента.

В обзоре отображаются:

  • Имя бренда
  • Имя агента
  • Учетная запись партнера, в которой был создан агент
  • Идентификатор бренда
  • Идентификатор агента
  • Тестовые URL-адреса агента, которые позволяют вам увидеть, как диалог с этим агентом выглядит для пользователей, и дают вам возможность проверить вашу инфраструктуру обмена сообщениями.
  • Статус проверки агента
  • Предварительный просмотр агента
  • Места, связанные с агентом
  • Ссылки на соответствующую документацию

Левая навигация позволяет получить доступ к следующему:

Информация об агенте

Используйте страницу информации об агенте для обновления свойств агента.

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

Используйте правый столбец, чтобы получить тестовые URL-адреса для своего агента и просмотреть предварительный просмотр того, как ваш агент выглядит на устройстве пользователя.

Управление местоположением

Используйте эту страницу для добавления местоположений , получения тестовых URL-адресов для местоположений предприятий и проверки местоположений после проверки агента .

Интеграции

Используйте эту страницу для интеграции с Dialogflow и настройки бота для ответов на часто задаваемые вопросы.

Опросы

Используйте эту страницу, чтобы настроить опрос клиентов вашего агента.

Журналы

Используйте эту страницу для устранения проблем с доставкой сообщений. Журналы доступны в течение 14 дней. Фильтруйте по идентификатору разговора, идентификатору сообщения, отметке времени, направлению или статусу, чтобы найти журналы, относящиеся к проблемам пользователей. Вы также можете проверить эту страницу, чтобы убедиться, что вы не отправляете недопустимые сообщения непреднамеренно.

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

Некоторые события, например индикаторы ввода, не имеют уведомлений о доставке, и их статус отображается как «Отправлено».

Журнал отладки, показывающий статусы «Доставлено» и «Не удалось»

Проверка

Используйте эту страницу, чтобы отправить своего агента на проверку .

Запуск

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