Поделиться через

Viva Engage

Viva Engage является ведущей социальной сетью для бизнеса, чтобы получить работу сделать умнее и быстрее. Подключитесь к Viva Engage, чтобы получить доступ к беседам в корпоративной сети.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Стандарт Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Стандарт Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Microsoft
URL https://microsoft.com
Метаданные соединителя
Publisher Microsoft
Веб-сайт https://products.office.com/yammer/yammer-overview
Политика конфиденциальности https://privacy.microsoft.com
Категории Communication

Это важно

Проверка подлинности OAuth2 для Yammer (Viva Engage) будет прекращена в ближайшее время.

  • Новые подключения должны использовать проверку подлинности Entra ID с 1 сентября.
  • Существующие подключения OAuth2 будут продолжать работать до 15 ноября 2025 г.

Перед 15 ноября 2025 г. переключите подключения на проверку подлинности Идентификатора записи, чтобы избежать сбоев.

Известные проблемы и ограничения

Следующие действия и триггеры не гарантируют возврат всех сообщений из-за ограничений REST API Viva Engage:

  • Получение всех сообщений
  • Получение сообщений в группе
  • Получение сообщений в потоке
  • Получение сообщений из моего веб-канала "Ниже"
  • При наличии нового сообщения в группе
  • Когда в моем веб-канале появится новое сообщение

Следующее действие может возвращать не более 100 групп из-за ограничений REST API Viva Engage:

  • Получение групп

Замечание

API Viva Engage может ограничить количество возвращенных сообщений. Если это происходит, чтобы обойти это ограничение, обратитесь к разделу "Как получить все сообщения в группе Yammer" с помощью Microsoft Flow. Дополнительные сведения об ограничениях API Viva Engage см. в разделе об ограничениях частоты API Yammer.

Кроме того, следующие действия и триггеры могут не работать со всеми группами компаний из-за ограничений REST API Viva Engage:

  • Получение сообщений в группе
  • Получение сообщений в группе (версия 2)
  • При наличии нового сообщения в группе

В конфигурации Yammer необходимо включить функцию сторонних приложений. Ответ действия, например "Ответ не находится в формате JSON", обычно означает, что эта функция отключена.

Следующие действия позволяют создать запись "Объявление" с заголовком после настройки соответствующих дополнительных параметров, однако эта запись не сможет быть изменена в пользовательском интерфейсе Viva Engage. Viva Engage знает об этой проблеме и будет решать эту проблему в будущем обновлении.

  • PostMessage
  • PostMessageV2

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
Вход с помощью идентификатора Microsoft Entra Вход с помощью идентификатора Microsoft Entra Все регионы Недоступен для совместного использования
По умолчанию [не рекомендуется] Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. Все регионы Недоступен для совместного использования

Вход с помощью идентификатора Microsoft Entra

Идентификатор проверки подлинности: entraIDUserLogin

Применимо: все регионы

Вход с помощью идентификатора Microsoft Entra

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

По умолчанию [не рекомендуется]

Применимо: все регионы

Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.

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

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд
Частота опросов триггеров 1 15 секунд

Действия

Как сообщение

Эта операция используется для такого сообщения, как указанное сообщение.
Получение всех сообщений (версия 2) [НЕ РЕКОМЕНДУЕТСЯ]

Это действие устарело. Вместо этого используйте команду Get all messages (V3).

Эта операция возвращает все общедоступные сообщения в сети Viva Engage пользователя. Соответствует беседам "Все" в веб-интерфейсе Viva Engage.
Получение всех сообщений (версия 3)

Эта операция возвращает все общедоступные сообщения в сети Viva Engage пользователя. Соответствует беседам "Все" в веб-интерфейсе Viva Engage.
Получение всех сообщений [DEPRECATED]

Это действие устарело. Вместо этого используйте команду Get all messages (V3).

Эта операция возвращает все общедоступные сообщения в сети Viva Engage пользователя. Соответствует беседам "Все" в веб-интерфейсе Yammer.
Получение групп

Возвращает все группы. Если мина = 1, получите только группы, к которым принадлежит пользователь
Получение сведений о пользователе

Эта операция возвращает сведения о профиле пользователя.
Получение сетей

Возвращает все сети, к которым принадлежит пользователь.
Получение сообщений в группе (V2) [DEPRECATED]

Это действие устарело. Вместо этого используйте команду Get messages in a group (V3).

Эта операция возвращает сообщения, размещенные в группе.
Получение сообщений в группе (V3)

Эта операция возвращает сообщения, размещенные в группе.
Получение сообщений в группе [DEPRECATED]

Это действие устарело. Вместо этого используйте команду Get messages in a group (V3).

Эта операция возвращает сообщения, размещенные в группе.
Получение сообщений в потоке (версия 2) [DEPRECATED]

Это действие устарело. Вместо этого используйте get messages in a thread (V3).

Эта операция возвращает сообщения, размещенные в потоке.
Получение сообщений в потоке (версия 3)

Эта операция возвращает сообщения, размещенные в потоке.
Получение сообщений в потоке [DEPRECATED]

Это действие устарело. Вместо этого используйте get messages in a thread (V3).

Эта операция возвращает сообщения, размещенные в потоке.
Получение сообщений из моего веб-канала "Ниже" (версия 2) [DEPRECATED]

Это действие устарело. Вместо этого используйте сообщения из моего веб-канала ниже (версии 3 ).

Эта операция возвращает сообщения из канала "Далее", который представляет собой беседы, связанные с людьми, группами и разделами, которые пользователь выполняет.
Получение сообщений из моего веб-канала "Ниже" [DEPRECATED]

Это действие устарело. Вместо этого используйте сообщения из моего веб-канала ниже (версии 3 ).

Эта операция возвращает сообщения из канала "Далее", который представляет собой беседы, связанные с людьми, группами и разделами, которые пользователь выполняет.
Получение сообщений из моего веб-канала ниже (версия 3)

Эта операция возвращает сообщения из канала "Далее", который представляет собой беседы, связанные с людьми, группами и разделами, которые пользователь выполняет.
Сообщение о публикации (версия 2)

Эта операция используется для публикации сообщения в группу или весь веб-канал компании. Если указан идентификатор группы, сообщение будет опубликовано в указанной группе, оно будет размещено во всех каналах компании.
Сообщение о публикации [DEPRECATED]

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

Как сообщение

Идентификатор операции:
LikeMessage

Эта операция используется для такого сообщения, как указанное сообщение.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сообщения
 message_id True string

Уникальный идентификатор сообщения.

Получение всех сообщений (версия 2) [НЕ РЕКОМЕНДУЕТСЯ]

Идентификатор операции:
GetAllMessagesV2

Это действие устарело. Вместо этого используйте команду Get all messages (V3).

Эта операция возвращает все общедоступные сообщения в сети Viva Engage пользователя. Соответствует беседам "Все" в веб-интерфейсе Viva Engage.

Параметры

Имя Ключ Обязательно Тип Описание
Уникальный идентификатор сети
 network_id string

Идентификатор сети
Срок давности
 older_than integer

Возвращает сообщения старше идентификатора сообщения, указанного в виде числовой строки. Это полезно для разбиения сообщений на страницы. Например, если вы просматриваете 20 сообщений и самый старый номер 2912, вы можете добавить "?older_than=2912" в запрос, чтобы получить 20 сообщений до тех, которые вы видите.
Более новые, чем
 newer_than integer

Возвращает сообщения, более новые, чем идентификатор сообщения, указанный в виде числовой строки. Это следует использовать при опросе новых сообщений. Если вы просматриваете сообщения, и последнее возвращенное сообщение равно 3516, вы можете запросить запрос с параметром "?newer_than=3516", чтобы убедиться, что на странице не будут повторяться копии сообщений.
Тип потоков сообщений
 threaded string

Threaded=true возвращает только начальный поток (первое сообщение) для каждого потока. Этот параметр предназначен для приложений, которые должны отображать свернутые потоки сообщений. threaded=extended возвращает начальные сообщения потока и два последних сообщения, упорядоченные по действиям, так как они отображаются в представлении по умолчанию на веб-интерфейсе Viva Engage.
Лимит
 limit integer

Возвращает только указанное количество сообщений.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
PageableMessageList

Получение всех сообщений (версия 3)

Идентификатор операции:
GetAllMessagesV3

Эта операция возвращает все общедоступные сообщения в сети Viva Engage пользователя. Соответствует беседам "Все" в веб-интерфейсе Viva Engage.

Параметры

Имя Ключ Обязательно Тип Описание
Уникальный идентификатор сети
 network_id string

Идентификатор сети
Срок давности
 older_than integer

Возвращает сообщения старше идентификатора сообщения, указанного в виде числовой строки. Это полезно для разбиения сообщений на страницы. Например, если вы просматриваете 20 сообщений и самый старый номер 2912, вы можете добавить "?older_than=2912" в запрос, чтобы получить 20 сообщений до тех, которые вы видите.
Более новые, чем
 newer_than integer

Возвращает сообщения, более новые, чем идентификатор сообщения, указанный в виде числовой строки. Это следует использовать при опросе новых сообщений. Если вы просматриваете сообщения, и последнее возвращенное сообщение равно 3516, вы можете запросить запрос с параметром "?newer_than=3516", чтобы убедиться, что на странице не будут повторяться копии сообщений.
Тип потоков сообщений
 threaded string

Threaded=true возвращает только начальный поток (первое сообщение) для каждого потока. Этот параметр предназначен для приложений, которые должны отображать свернутые потоки сообщений. threaded=extended возвращает начальные сообщения потока и два последних сообщения, упорядоченные по действиям, так как они отображаются в представлении по умолчанию на веб-интерфейсе Viva Engage.
Лимит
 limit integer

Возвращает только указанное количество сообщений.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
PageableMessageListV2

Получение всех сообщений [DEPRECATED]

Идентификатор операции:
GetAllMessages

Это действие устарело. Вместо этого используйте команду Get all messages (V3).

Эта операция возвращает все общедоступные сообщения в сети Viva Engage пользователя. Соответствует беседам "Все" в веб-интерфейсе Yammer.

Параметры

Имя Ключ Обязательно Тип Описание
Уникальный идентификатор сети
 network_id string

Идентификатор сети
Срок давности
 older_than integer

Возвращает сообщения старше идентификатора сообщения, указанного в виде числовой строки. Это полезно для разбиения сообщений на страницы. Например, если вы просматриваете 20 сообщений и самый старый номер 2912, вы можете добавить "?older_than=2912" в запрос, чтобы получить 20 сообщений до тех, которые вы видите.
Более новые, чем
 newer_than integer

Возвращает сообщения, более новые, чем идентификатор сообщения, указанный в виде числовой строки. Это следует использовать при опросе новых сообщений. Если вы просматриваете сообщения, и последнее возвращенное сообщение равно 3516, вы можете запросить запрос с параметром "?newer_than=3516", чтобы убедиться, что на странице не будут повторяться копии сообщений.
Лимит
 limit integer

Возвращает только указанное количество сообщений.
Страница
 page integer

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

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
MessageList

Получение групп

Идентификатор операции:
GetGroups

Возвращает все группы. Если мина = 1, получите только группы, к которым принадлежит пользователь

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Идентификатор сети
шахта
 mine integer

Используется для получения групп, которые являются частью пользователя
Показать всю группу компаний
 showAllCompanyGroup integer

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

Возвращаемое значение

response
array of YammmerEntity

Получение сведений о пользователе

Идентификатор операции:
GetUserDetailsById

Эта операция возвращает сведения о профиле пользователя.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя
 user_id True integer

Уникальный идентификатор пользователя.

Возвращаемое значение

Свойства пользователя Viva Engage.

User
User

Получение сетей

Идентификатор операции:
GetNetworks

Возвращает все сети, к которым принадлежит пользователь.

Возвращаемое значение

response
array of Network

Получение сообщений в группе (V2) [DEPRECATED]

Идентификатор операции:
GetMessagesInGroupV2

Это действие устарело. Вместо этого используйте команду Get messages in a group (V3).

Эта операция возвращает сообщения, размещенные в группе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Уникальный идентификатор сети.
Идентификатор группы
 group_id True integer

Уникальный идентификатор группы.
Срок давности
 older_than integer

Возвращает сообщения старше идентификатора сообщения, указанного в виде числовой строки. Это полезно для разбиения сообщений на страницы. Например, если вы просматриваете 20 сообщений и самый старый номер 2912, вы можете добавить "?older_than=2912" в запрос, чтобы получить 20 сообщений до тех, которые вы видите.
Более новые, чем
 newer_than integer

Возвращает сообщения, более новые, чем идентификатор сообщения, указанный в виде числовой строки. Это следует использовать при опросе новых сообщений. Если вы просматриваете сообщения, и последнее возвращенное сообщение равно 3516, вы можете запросить запрос с параметром "?newer_than=3516", чтобы убедиться, что на странице не будут повторяться копии сообщений.
Тип потоков сообщений
 threaded string

Threaded=true возвращает только начальный поток (первое сообщение) для каждого потока. Этот параметр предназначен для приложений, которые должны отображать свернутые потоки сообщений. threaded=extended возвращает начальные сообщения потока и два последних сообщения, упорядоченные по действиям, так как они отображаются в представлении по умолчанию на веб-интерфейсе Viva Engage.
Лимит
 limit integer

Возвращает только указанное количество сообщений.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
PageableMessageList

Получение сообщений в группе (V3)

Идентификатор операции:
GetMessagesInGroupV3

Эта операция возвращает сообщения, размещенные в группе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Уникальный идентификатор сети.
Идентификатор группы
 group_id True integer

Уникальный идентификатор группы.
Срок давности
 older_than integer

Возвращает сообщения в потоках, где последнее сообщение потока старше указанного идентификатора сообщения. Любой поток с последним идентификатором сообщения, который является более новым или равным указанному идентификатору, не будет иметь никаких сообщений, возвращаемых этим запросом.
Более новые, чем
 newer_than integer

Возвращает сообщения в потоках, где последнее сообщение потока является более новым, чем указанный идентификатор сообщения. Любой поток с последним идентификатором сообщения, который старше указанного идентификатора или равен указанному идентификатору, не будет иметь никаких сообщений, возвращаемых этим запросом.
Тип потоков сообщений
 threaded string

Threaded=true возвращает только начальный поток (первое сообщение) для каждого потока. Этот параметр предназначен для приложений, которые должны отображать свернутые потоки сообщений. threaded=extended возвращает начальные сообщения потока и два последних сообщения, упорядоченные по действиям, так как они отображаются в представлении по умолчанию на веб-интерфейсе Viva Engage.
Лимит
 limit integer

Возвращает только указанное количество сообщений.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
PageableMessageListV2

Получение сообщений в группе [DEPRECATED]

Идентификатор операции:
GetMessagesInGroup

Это действие устарело. Вместо этого используйте команду Get messages in a group (V3).

Эта операция возвращает сообщения, размещенные в группе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Уникальный идентификатор сети.
Идентификатор группы
 group_id True integer

Уникальный идентификатор группы.
Срок давности
 older_than integer

Возвращает сообщения старше идентификатора сообщения, указанного в виде числовой строки. Это полезно для разбиения сообщений на страницы. Например, если вы просматриваете 20 сообщений и самый старый номер 2912, вы можете добавить "?older_than=2912" в запрос, чтобы получить 20 сообщений до тех, которые вы видите.
Более новые, чем
 newer_than integer

Возвращает сообщения, более новые, чем идентификатор сообщения, указанный в виде числовой строки. Это следует использовать при опросе новых сообщений. Если вы просматриваете сообщения, и последнее возвращенное сообщение равно 3516, вы можете запросить запрос с параметром "?newer_than=3516", чтобы убедиться, что на странице не будут повторяться копии сообщений.
Лимит
 limit integer

Возвращает только указанное количество сообщений.
Страница
 page integer

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

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
MessageList

Получение сообщений в потоке (версия 2) [DEPRECATED]

Идентификатор операции:
GetMessagesInThreadV2

Это действие устарело. Вместо этого используйте get messages in a thread (V3).

Эта операция возвращает сообщения, размещенные в потоке.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор потока
 thread_id True integer

Уникальный идентификатор потока.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
PageableMessageList

Получение сообщений в потоке (версия 3)

Идентификатор операции:
GetMessagesInThreadV3

Эта операция возвращает сообщения, размещенные в потоке.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор потока
 thread_id True integer

Уникальный идентификатор потока.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
PageableMessageListV2

Получение сообщений в потоке [DEPRECATED]

Идентификатор операции:
GetMessagesInThread

Это действие устарело. Вместо этого используйте get messages in a thread (V3).

Эта операция возвращает сообщения, размещенные в потоке.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор потока
 thread_id True integer

Уникальный идентификатор потока.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
MessageList

Получение сообщений из моего веб-канала "Ниже" (версия 2) [DEPRECATED]

Идентификатор операции:
GetMessagesFollowingV2

Это действие устарело. Вместо этого используйте сообщения из моего веб-канала ниже (версии 3 ).

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Уникальный идентификатор сети.
Срок давности
 older_than integer

Возвращает сообщения старше идентификатора сообщения, указанного в виде числовой строки. Это полезно для разбиения сообщений на страницы. Например, если вы просматриваете 20 сообщений и самый старый номер 2912, вы можете добавить "?older_than=2912" в запрос, чтобы получить 20 сообщений до тех, которые вы видите.
Более новые, чем
 newer_than integer

Возвращает сообщения, более новые, чем идентификатор сообщения, указанный в виде числовой строки. Это следует использовать при опросе новых сообщений. Если вы просматриваете сообщения, и последнее возвращенное сообщение равно 3516, вы можете запросить запрос с параметром "?newer_than=3516", чтобы убедиться, что на странице не будут повторяться копии сообщений.
Тип потоков сообщений
 threaded string

Threaded=true возвращает только начальный поток (первое сообщение) для каждого потока. Этот параметр предназначен для приложений, которые должны отображать свернутые потоки сообщений. threaded=extended возвращает начальные сообщения потока и два последних сообщения, упорядоченные по действиям, так как они отображаются в представлении по умолчанию на веб-интерфейсе Viva Engage.
Лимит
 limit integer

Возвращает только указанное количество сообщений.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
PageableMessageList

Получение сообщений из моего веб-канала "Ниже" [DEPRECATED]

Идентификатор операции:
GetMessagesFollowing

Это действие устарело. Вместо этого используйте сообщения из моего веб-канала ниже (версии 3 ).

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Уникальный идентификатор сети.
Срок давности
 older_than integer

Возвращает сообщения старше идентификатора сообщения, указанного в виде числовой строки. Это полезно для разбиения сообщений на страницы. Например, если вы просматриваете 20 сообщений и самый старый номер 2912, вы можете добавить "?older_than=2912" в запрос, чтобы получить 20 сообщений до тех, которые вы видите.
Более новые, чем
 newer_than integer

Возвращает сообщения, более новые, чем идентификатор сообщения, указанный в виде числовой строки. Это следует использовать при опросе новых сообщений. Если вы просматриваете сообщения, и последнее возвращенное сообщение равно 3516, вы можете запросить запрос с параметром "?newer_than=3516", чтобы убедиться, что на странице не будут повторяться копии сообщений.
Лимит
 limit integer

Возвращает только указанное количество сообщений.
Страница
 page integer

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

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
MessageList

Получение сообщений из моего веб-канала ниже (версия 3)

Идентификатор операции:
GetMessagesFollowingV3

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Уникальный идентификатор сети.
Срок давности
 older_than integer

Возвращает сообщения старше идентификатора сообщения, указанного в виде числовой строки. Это полезно для разбиения сообщений на страницы. Например, если вы просматриваете 20 сообщений и самый старый номер 2912, вы можете добавить "?older_than=2912" в запрос, чтобы получить 20 сообщений до тех, которые вы видите.
Более новые, чем
 newer_than integer

Возвращает сообщения, более новые, чем идентификатор сообщения, указанный в виде числовой строки. Это следует использовать при опросе новых сообщений. Если вы просматриваете сообщения, и последнее возвращенное сообщение равно 3516, вы можете запросить запрос с параметром "?newer_than=3516", чтобы убедиться, что на странице не будут повторяться копии сообщений.
Тип потоков сообщений
 threaded string

Threaded=true возвращает только начальный поток (первое сообщение) для каждого потока. Этот параметр предназначен для приложений, которые должны отображать свернутые потоки сообщений. threaded=extended возвращает начальные сообщения потока и два последних сообщения, упорядоченные по действиям, так как они отображаются в представлении по умолчанию на веб-интерфейсе Viva Engage.
Лимит
 limit integer

Возвращает только указанное количество сообщений.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
PageableMessageListV2

Сообщение о публикации (версия 2)

Идентификатор операции:
PostMessageV2

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Уникальный идентификатор сети.
Идентификатор группы
 group_id True integer

Группа для публикации сообщения (0 = все компании или сети).
Текст сообщения
 body True string

Сообщение, которое будет опубликовано в вашей сети.
Ответ на идентификатор
 replied_to_id integer

Идентификатор сообщения, на который оно отвечает.
Прямой идентификатор
 direct_to_id integer

Если задано, частное сообщение будет отправлено пользователю непосредственно с указанным идентификатором.
Вещать
 broadcast boolean

Публикация сообщения в качестве объявления всем пользователям в группе.
Название
 title string

Заголовок сообщения для публикации.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
MessageListV2

Сообщение о публикации [DEPRECATED]

Идентификатор операции:
PostMessage

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Уникальный идентификатор сети.
Идентификатор группы
 group_id True integer

Группа для публикации сообщения (0 = все компании или сети).
Текст сообщения
 body True string

Сообщение, которое будет опубликовано в вашей сети.
Ответ на идентификатор
 replied_to_id integer

Идентификатор сообщения, на который оно отвечает.
Прямой идентификатор
 direct_to_id integer

Если задано, частное сообщение будет отправлено пользователю непосредственно с указанным идентификатором.
Вещать
 broadcast boolean

Публикация сообщения в качестве объявления всем пользователям в группе.
Название
 title string

Заголовок сообщения для публикации.
Раздел 1
 topic1 string

Раздел для применения к сообщению.
Раздел 2
 topic2 string

Раздел для применения к сообщению
Раздел 3
 topic3 string

Раздел для применения к сообщению.
Раздел 4
 topic4 string

Раздел для применения к сообщению
Раздел 5
 topic5 string

Раздел для применения к сообщению.
Раздел 6
 topic6 string

Раздел для применения к сообщению.
Раздел 7
 topic7 string

Раздел для применения к сообщению
Раздел 8
 topic8 string

Раздел для применения к сообщению.
Раздел 9
 topic9 string

Раздел для применения к сообщению.
Раздел 10
 topic10 string

Раздел для применения к сообщению.
Раздел 11
 topic11 string

Раздел для применения к сообщению.
Раздел 12
 topic12 string

Раздел для применения к сообщению.
Раздел 13
 topic13 string

Раздел для применения к сообщению.
Раздел 14
 topic14 string

Раздел для применения к сообщению.
Раздел 15
 topic15 string

Раздел для применения к сообщению.
Раздел 16
 topic16 string

Раздел для применения к сообщению.
Раздел 17
 topic17 string

Раздел для применения к сообщению.
Раздел 18
 topic18 string

Раздел для применения к сообщению.
Раздел 19
 topic19 string

Раздел для применения к сообщению.
Раздел 20
 topic20 string

Раздел для применения к сообщению.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
MessageList

Триггеры

Когда в моем веб-канале (V2) появится новое сообщение

Эта операция активируется, когда в сети появится новое сообщение, за которым следует.
Когда в моем веб-канале появилось новое сообщение [не рекомендуется]

Это действие устарело. Используйте вместо этого новое сообщение в моем веб-канале версии 2 .

Эта операция активируется, когда в сети появится новое сообщение, за которым следует.
При наличии нового сообщения в группе (версия 2)

Эта операция активируется при публикации нового сообщения в группе.
При наличии нового сообщения в группе [DEPRECATED]

Это действие устарело. Используйте вместо этого новое сообщение в группе (V2).

Эта операция активируется при публикации нового сообщения в группе.

Когда в моем веб-канале (V2) появится новое сообщение

Идентификатор операции:
OnNewMessagesFollowingV2

Эта операция активируется, когда в сети появится новое сообщение, за которым следует.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Выберите сеть.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
MessageListV2

Когда в моем веб-канале появилось новое сообщение [не рекомендуется]

Идентификатор операции:
OnNewMessagesFollowing

Это действие устарело. Используйте вместо этого новое сообщение в моем веб-канале версии 2 .

Эта операция активируется, когда в сети появится новое сообщение, за которым следует.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Выберите сеть.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
MessageList

При наличии нового сообщения в группе (версия 2)

Идентификатор операции:
OnNewMessagesInGroupV2

Эта операция активируется при публикации нового сообщения в группе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Уникальный идентификатор сети.
Идентификатор группы
 group_id True integer

Уникальный идентификатор группы.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
MessageListV2

При наличии нового сообщения в группе [DEPRECATED]

Идентификатор операции:
OnNewMessagesInGroup

Это действие устарело. Используйте вместо этого новое сообщение в группе (V2).

Эта операция активируется при публикации нового сообщения в группе.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сети
 network_id string

Уникальный идентификатор сети.
Идентификатор группы
 group_id True integer

Уникальный идентификатор группы.

Возвращаемое значение

Список одного или нескольких сообщений.

Список сообщений
MessageList

Определения

User

Свойства пользователя Viva Engage.

Имя Путь Тип Описание
Имя пользователя
 name string

Имя пользователя.
Название задания
 job_title string

Название задания пользователя.
Местоположение
 location string

Расположение пользователя.
ФИО
 full_name string

Полное имя пользователя.
Имя (первое имя)
 first_name string

Имя пользователя.
Фамилия
 last_name string

Фамилия пользователя.
URL-адрес профиля
 web_url string

URL-адрес профиля пользователя.
Адрес электронной почты
 email string

Электронная почта пользователя.
Дата рождения
 birth_date string

Дата рождения пользователя.
URL-адрес фотографии
 mugshot_url string

URL-адрес фотографии пользователя.

Message

Свойства одного сообщения Viva Engage.

Имя Путь Тип Описание
Идентификатор
 id integer

Идентификатор, связанный с записью.
Текст
 content_excerpt string

Текстовое содержимое записи.
Отправитель
 sender_id integer

Уникальный идентификатор пользователя, который опубликовал сообщение.
Ответ на
 replied_to_id integer

Идентификатор сообщения, к которому это сообщение является ответом.
Создано в
 created_at string

Время создания сообщения.
Сеть
 network_id integer

Идентификатор сетевого сообщения связан.
Тип
 message_type string

Дескриптон типа сообщения.
Тип отправителя
 sender_type string

Описание типа отправителя.
URL-адрес
 url uri

URL-адрес API записи.
Url-адрес веб-сайта
 web_url uri

Url-адрес веб-страницы публикации.
Идентификатор группы
 group_id integer

Уникальный идентификатор группы, которая опубликовала сообщение.
Текст сообщения
 body MessageBody

Содержимое, связанное с одним сообщением.
Идентификатор потока
 thread_id integer

Уникальный идентификатор потока.
Прямое сообщение
 direct_message boolean

Пометка, чтобы указать, является ли запись прямым сообщением.
Идентификатор клиента
 client_type string

Тип клиента.
URL-адрес клиента
 client_url uri

Веб-ссылка клиента.
Language
 language string

Язык, используемый в сообщении.
Помеченный пользователь
 notified_user_ids array of integer

Сведения об уведомлениях пользователей.
Конфиденциальность
 privacy string

Сведения о конфиденциальности, связанной с сообщением.
liked_by
 liked_by LikedBy

Нравится
Системное сообщение
 system_message boolean

Пометка, чтобы указать, является ли запись системным созданным сообщением или нет.
Темы
 topics array of Topic

Список разделов.

MessageV2

Свойства одного сообщения Viva Engage.

Имя Путь Тип Описание
Идентификатор
 id integer

Идентификатор, связанный с записью.
Текст
 content_excerpt string

Текстовое содержимое записи.
Отправитель
 sender_id integer

Уникальный идентификатор пользователя, который опубликовал сообщение.
Ответ на
 replied_to_id integer

Идентификатор сообщения, к которому это сообщение является ответом.
Создано в
 created_at string

Время создания сообщения.
Сеть
 network_id integer

Идентификатор сетевого сообщения связан.
Тип
 message_type string

Дескриптон типа сообщения.
Тип отправителя
 sender_type string

Описание типа отправителя.
URL-адрес
 url uri

URL-адрес API записи.
Url-адрес веб-сайта
 web_url uri

Url-адрес веб-страницы публикации.
Идентификатор группы
 group_id integer

Уникальный идентификатор группы, которая опубликовала сообщение.
Текст сообщения
 body MessageBody

Содержимое, связанное с одним сообщением.
Идентификатор потока
 thread_id integer

Уникальный идентификатор потока.
Прямое сообщение
 direct_message boolean

Пометка, чтобы указать, является ли запись прямым сообщением.
Идентификатор клиента
 client_type string

Тип клиента.
URL-адрес клиента
 client_url uri

Веб-ссылка клиента.
Language
 language string

Язык, используемый в сообщении.
Помеченный пользователь
 notified_user_ids array of integer

Сведения об уведомлениях пользователей.
Конфиденциальность
 privacy string

Сведения о конфиденциальности, связанной с сообщением.
liked_by
 liked_by LikedBy

Нравится
Системное сообщение
 system_message boolean

Пометка, чтобы указать, является ли запись системным созданным сообщением или нет.

Тема

Свойства одного раздела.

Имя Путь Тип Описание
Идентификатор
 id integer

Уникальный идентификатор раздела.
Имя
 name string

Имя раздела.

PageableMessageList

Список одного или нескольких сообщений.

Имя Путь Тип Описание
Messages
 value array of Message

PageableMessageListV2

Список одного или нескольких сообщений.

Имя Путь Тип Описание
Messages
 value array of MessageV2

MessageList

Список одного или нескольких сообщений.

Имя Путь Тип Описание
Messages
 messages array of Message

messages

MessageListV2

Список одного или нескольких сообщений.

Имя Путь Тип Описание
Messages
 messages array of MessageV2

messages

MessageBody

Содержимое, связанное с одним сообщением.

Имя Путь Тип Описание
Текст
 parsed string

Проанализированный текстовый формат.
Равнина
 plain string

Формат обычного текста.
Богатый
 rich string

Формат форматированного текста.

LikedBy

Нравится

Имя Путь Тип Описание
Численность
 count integer

Количество отдельных подобных.
Names
 names array of object

Список людей, которые любили пост.
Полное имя
 names.full_name string

Полное имя человека, который любил пост.

Сеть

Свойства одной сети.

Имя Путь Тип Описание
Идентификатор
 id string

Уникальный идентификатор сети.
Имя
 name string

Сводка по сети.
Link
 permalink string

Веб-ссылка на сетевую страницу.

YammmerEntity

Свойства одной сущности Viva Engage.

Имя Путь Тип Описание
Description
 type string

Сведения о сущности Viva Engage.
Идентификатор группы
 id integer

Уникальный идентификатор группы.
Полное имя
 full_name string

Имя сущности Viva Engage.