비바 인게이지
Viva Engage는 기업이 더 스마트하고 빠르게 작업을 수행할 수 있는 선도적인 소셜 네트워크입니다. Viva Engage에 연결하여 엔터프라이즈 네트워크의 대화에 액세스합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - 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 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://products.office.com/yammer/yammer-overview |
| 개인 정보 보호 정책 | https://privacy.microsoft.com |
| 카테고리 | Communication |
중요합니다
Yammer(Viva Engage)에 대한 OAuth2 인증은 곧 더 이상 사용되지 않습니다.
- 새 연결은 9월 1일부터 Entra ID 인증을 사용해야 합니다.
- 기존 OAuth2 연결은 2025년 11월 15일까지 계속 작동합니다.
중단을 방지하려면 2025년 11월 15일 이전에 Entra ID 인증으로 연결을 전환하세요.
알려진 문제 및 제한 사항
다음 작업 및 트리거는 Viva Engage REST API 제한으로 인해 모든 메시지를 반환하도록 보장하지 않습니다.
- 모든 메시지 가져오기
- 그룹에서 메시지 가져오기
- 스레드에서 메시지 가져오기
- 내 다음 피드에서 메시지 가져오기
- 그룹에 새 메시지가 있는 경우
- 팔로우한 피드에 새 메시지가 있는 경우
다음 작업은 Viva Engage REST API 제한으로 인해 최대 100개의 그룹을 반환할 수 있습니다.
- 그룹 가져오기
비고
Viva Engage API는 반환되는 메시지 수를 제한할 수 있습니다. 이 경우 이 제한을 해결하려면 Microsoft Flow를 사용하여 Yammer 그룹의 모든 메시지를 가져오는 방법을 참조하세요. Viva Engage API 제한과 관련된 자세한 내용은 Yammer API 속도 제한을 방문하세요.
또한 Viva Engage REST API 제한으로 인해 다음 작업 및 트리거가 모든 회사 그룹에서 작동하지 않을 수 있습니다.
- 그룹에서 메시지 가져오기
- 그룹에서 메시지 가져오기(V2)
- 그룹에 새 메시지가 있는 경우
Yammer 구성에서 타사 애플리케이션 기능을 사용하도록 설정해야 합니다. "응답이 JSON 형식이 아닙니다."와 같은 작업 응답은 일반적으로 기능이 비활성화됨을 의미합니다.
다음 작업을 통해 해당 고급 매개 변수를 설정한 후 "제목"으로 "알림" 게시물을 만들 수 있지만 이 게시물은 Viva Engage UI에서 편집할 수 없습니다. Viva Engage는 이 문제를 알고 있으며 향후 업데이트에서 이 문제를 해결합니다.
- PostMessage
- PostMessageV2
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| Microsoft Entra ID로 로그인 | Microsoft Entra ID로 로그인 | 모든 지역 | 공유할 수 없음 |
| 기본값 [사용되지 않음] | 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. | 모든 지역 | 공유할 수 없음 |
Microsoft Entra ID로 로그인
인증 ID: entraIDUserLogin
적용 가능: 모든 지역
Microsoft Entra ID로 로그인
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
기본값 [사용되지 않음]
적용 가능: 모든 지역
이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
| 트리거 폴링 빈도 | 1 | 15초 |
동작
| 그룹 가져오기 |
모든 그룹을 가져옵니다. mine = 1인 경우 사용자가 속한 그룹만 가져옵니다. |
| 그룹에서 메시지 가져오기(V2) [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 그룹(V3)에서 메시지 가져오기를 사용하세요.
|
| 그룹에서 메시지 가져오기(V3) |
이 작업은 그룹에 게시된 메시지를 반환합니다. |
| 그룹에서 메시지 가져오기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 그룹(V3)에서 메시지 가져오기를 사용하세요.
|
| 내 네트워크 가져오기 |
사용자가 속한 모든 네트워크를 가져옵니다. |
| 내 다음 피드에서 메시지 가져오기(V2) [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 내 다음 피드(V3)에서 메시지 가져오기 를 사용하세요.
|
| 내 다음 피드에서 메시지 가져오기(V3) |
이 작업은 사용자가 팔로우하는 사람, 그룹 및 토픽과 관련된 대화인 다음 피드의 메시지를 반환합니다. |
| 내 다음 피드에서 메시지 가져오기[사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 내 다음 피드(V3)에서 메시지 가져오기 를 사용하세요.
|
| 메시지 게시(V2) |
이 작업은 그룹 또는 모든 회사 피드에 메시지를 게시하는 데 사용됩니다. 그룹 ID가 제공되면 지정된 그룹에 메시지가 게시되고, 그렇지 않으면 모든 회사 피드에 게시됩니다. |
| 메시지 게시 [사용되지 않음] |
이 작업은 그룹 또는 모든 회사 피드에 메시지를 게시하는 데 사용됩니다. 그룹 ID가 제공되면 지정된 그룹에 메시지가 게시되고, 그렇지 않으면 모든 회사 피드에 게시됩니다. |
| 모든 메시지 가져오기(V2) [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 모든 메시지 가져오기(V3) 를 사용하세요.
|
| 모든 메시지 가져오기(V3) |
이 작업은 로그인한 사용자의 Viva Engage 네트워크에 있는 모든 공용 메시지를 반환합니다. Viva Engage 웹 인터페이스의 "모두" 대화에 해당합니다. |
| 모든 메시지 가져오기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 모든 메시지 가져오기(V3) 를 사용하세요.
|
| 사용자 세부 정보 가져오기 |
이 작업은 사용자 프로필 세부 정보를 반환합니다. |
| 스레드에서 메시지 가져오기(V2) [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 스레드(V3)에서 메시지 가져오기를 사용하세요.
|
| 스레드에서 메시지 가져오기(V3) |
이 작업은 스레드에 게시된 메시지를 반환합니다. |
| 스레드에서 메시지 가져오기 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 스레드(V3)에서 메시지 가져오기를 사용하세요.
|
| 좋아요 메시지 |
이 작업은 지정된 메시지를 같게 하는 데 사용됩니다. |
그룹 가져오기
모든 그룹을 가져옵니다. mine = 1인 경우 사용자가 속한 그룹만 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크 ID |
|
|
광산
|
mine | integer |
사용자가 속한 그룹을 가져오는 데 사용됩니다. |
|
|
모든 회사 그룹 표시
|
showAllCompanyGroup | integer |
모든 회사 그룹을 표시하는 데 사용됨 |
반환
- response
- array of YammmerEntity
그룹에서 메시지 가져오기(V2) [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 그룹(V3)에서 메시지 가져오기를 사용하세요.
이 작업은 그룹에 게시된 메시지를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크의 고유 식별자입니다. |
|
|
그룹 아이디
|
group_id | True | integer |
그룹의 고유 식별자입니다. |
|
이전 버전
|
older_than | integer |
숫자 문자열로 지정된 메시지 ID보다 오래된 메시지를 반환합니다. 이는 메시지 페이지를 매길 때 유용합니다. 예를 들어 현재 20개의 메시지를 보고 있고 가장 오래된 메시지가 숫자 2912인 경우 "?older_than=2912"를 요청에 추가하여 표시되는 메시지 앞에 20개의 메시지를 가져올 수 있습니다. |
|
|
최신 버전
|
newer_than | integer |
숫자 문자열로 지정된 메시지 ID보다 최신 메시지를 반환합니다. 새 메시지를 폴링할 때 사용해야 합니다. 메시지를 보고 있고 가장 최근에 반환된 메시지가 3516인 경우 "?newer_than=3516" 매개 변수를 사용하여 요청을 수행하여 페이지에 이미 중복된 메시지 복사본을 가져오지 않도록 할 수 있습니다. |
|
|
메시지의 스레드 유형
|
threaded | string |
Threaded=true는 각 스레드에 대한 스레드 시작(첫 번째 메시지)만 반환합니다. 이 매개 변수는 축소된 메시지 스레드를 표시해야 하는 앱용입니다. threaded=extended는 Viva Engage 웹 인터페이스의 기본 보기에서 볼 수 있으므로 스레드 시작 메시지와 가장 최근의 두 메시지를 모두 작업별로 정렬하여 반환합니다. |
|
|
한계
|
limit | integer |
지정된 수의 메시지만 반환합니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- PageableMessageList
그룹에서 메시지 가져오기(V3)
이 작업은 그룹에 게시된 메시지를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크의 고유 식별자입니다. |
|
|
그룹 아이디
|
group_id | True | integer |
그룹의 고유 식별자입니다. |
|
이전 버전
|
older_than | integer |
스레드의 최신 메시지가 지정된 메시지 ID보다 오래된 스레드의 메시지를 반환합니다. 가장 최근 메시지 ID가 지정된 ID보다 크거나 같은 스레드에는 이 쿼리에서 반환된 메시지가 없습니다. |
|
|
최신 버전
|
newer_than | integer |
스레드의 최신 메시지가 지정된 메시지 ID보다 최신인 스레드의 메시지를 반환합니다. 가장 최근 메시지 ID가 지정된 ID보다 오래되었거나 같은 스레드에는 이 쿼리에서 반환된 메시지가 없습니다. |
|
|
메시지의 스레드 유형
|
threaded | string |
Threaded=true는 각 스레드에 대한 스레드 시작(첫 번째 메시지)만 반환합니다. 이 매개 변수는 축소된 메시지 스레드를 표시해야 하는 앱용입니다. threaded=extended는 Viva Engage 웹 인터페이스의 기본 보기에서 볼 수 있으므로 스레드 시작 메시지와 가장 최근의 두 메시지를 모두 작업별로 정렬하여 반환합니다. |
|
|
한계
|
limit | integer |
지정된 수의 메시지만 반환합니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- PageableMessageListV2
그룹에서 메시지 가져오기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 그룹(V3)에서 메시지 가져오기를 사용하세요.
이 작업은 그룹에 게시된 메시지를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크의 고유 식별자입니다. |
|
|
그룹 아이디
|
group_id | True | integer |
그룹의 고유 식별자입니다. |
|
이전 버전
|
older_than | integer |
숫자 문자열로 지정된 메시지 ID보다 오래된 메시지를 반환합니다. 이는 메시지 페이지를 매길 때 유용합니다. 예를 들어 현재 20개의 메시지를 보고 있고 가장 오래된 메시지가 숫자 2912인 경우 "?older_than=2912"를 요청에 추가하여 표시되는 메시지 앞에 20개의 메시지를 가져올 수 있습니다. |
|
|
최신 버전
|
newer_than | integer |
숫자 문자열로 지정된 메시지 ID보다 최신 메시지를 반환합니다. 새 메시지를 폴링할 때 사용해야 합니다. 메시지를 보고 있고 가장 최근에 반환된 메시지가 3516인 경우 "?newer_than=3516" 매개 변수를 사용하여 요청을 수행하여 페이지에 이미 중복된 메시지 복사본을 가져오지 않도록 할 수 있습니다. |
|
|
한계
|
limit | integer |
지정된 수의 메시지만 반환합니다. |
|
|
페이지
|
page | integer |
지정된 페이지를 가져옵니다. 반환된 데이터가 제한보다 큰 경우 이 필드를 사용하여 후속 페이지에 액세스할 수 있습니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- MessageList
내 네트워크 가져오기
내 다음 피드에서 메시지 가져오기(V2) [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 내 다음 피드(V3)에서 메시지 가져오기 를 사용하세요.
이 작업은 사용자가 팔로우하는 사람, 그룹 및 토픽과 관련된 대화인 다음 피드의 메시지를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크의 고유 식별자입니다. |
|
|
이전 버전
|
older_than | integer |
숫자 문자열로 지정된 메시지 ID보다 오래된 메시지를 반환합니다. 이는 메시지 페이지를 매길 때 유용합니다. 예를 들어 현재 20개의 메시지를 보고 있고 가장 오래된 메시지가 숫자 2912인 경우 "?older_than=2912"를 요청에 추가하여 표시되는 메시지 앞에 20개의 메시지를 가져올 수 있습니다. |
|
|
최신 버전
|
newer_than | integer |
숫자 문자열로 지정된 메시지 ID보다 최신 메시지를 반환합니다. 새 메시지를 폴링할 때 사용해야 합니다. 메시지를 보고 있고 가장 최근에 반환된 메시지가 3516인 경우 "?newer_than=3516" 매개 변수를 사용하여 요청을 수행하여 페이지에 이미 중복된 메시지 복사본을 가져오지 않도록 할 수 있습니다. |
|
|
메시지의 스레드 유형
|
threaded | string |
Threaded=true는 각 스레드에 대한 스레드 시작(첫 번째 메시지)만 반환합니다. 이 매개 변수는 축소된 메시지 스레드를 표시해야 하는 앱용입니다. threaded=extended는 Viva Engage 웹 인터페이스의 기본 보기에서 볼 수 있으므로 스레드 시작 메시지와 가장 최근의 두 메시지를 모두 작업별로 정렬하여 반환합니다. |
|
|
한계
|
limit | integer |
지정된 수의 메시지만 반환합니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- PageableMessageList
내 다음 피드에서 메시지 가져오기(V3)
이 작업은 사용자가 팔로우하는 사람, 그룹 및 토픽과 관련된 대화인 다음 피드의 메시지를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크의 고유 식별자입니다. |
|
|
이전 버전
|
older_than | integer |
숫자 문자열로 지정된 메시지 ID보다 오래된 메시지를 반환합니다. 이는 메시지 페이지를 매길 때 유용합니다. 예를 들어 현재 20개의 메시지를 보고 있고 가장 오래된 메시지가 숫자 2912인 경우 "?older_than=2912"를 요청에 추가하여 표시되는 메시지 앞에 20개의 메시지를 가져올 수 있습니다. |
|
|
최신 버전
|
newer_than | integer |
숫자 문자열로 지정된 메시지 ID보다 최신 메시지를 반환합니다. 새 메시지를 폴링할 때 사용해야 합니다. 메시지를 보고 있고 가장 최근에 반환된 메시지가 3516인 경우 "?newer_than=3516" 매개 변수를 사용하여 요청을 수행하여 페이지에 이미 중복된 메시지 복사본을 가져오지 않도록 할 수 있습니다. |
|
|
메시지의 스레드 유형
|
threaded | string |
Threaded=true는 각 스레드에 대한 스레드 시작(첫 번째 메시지)만 반환합니다. 이 매개 변수는 축소된 메시지 스레드를 표시해야 하는 앱용입니다. threaded=extended는 Viva Engage 웹 인터페이스의 기본 보기에서 볼 수 있으므로 스레드 시작 메시지와 가장 최근의 두 메시지를 모두 작업별로 정렬하여 반환합니다. |
|
|
한계
|
limit | integer |
지정된 수의 메시지만 반환합니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- PageableMessageListV2
내 다음 피드에서 메시지 가져오기[사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 내 다음 피드(V3)에서 메시지 가져오기 를 사용하세요.
이 작업은 사용자가 팔로우하는 사람, 그룹 및 토픽과 관련된 대화인 다음 피드의 메시지를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크의 고유 식별자입니다. |
|
|
이전 버전
|
older_than | integer |
숫자 문자열로 지정된 메시지 ID보다 오래된 메시지를 반환합니다. 이는 메시지 페이지를 매길 때 유용합니다. 예를 들어 현재 20개의 메시지를 보고 있고 가장 오래된 메시지가 숫자 2912인 경우 "?older_than=2912"를 요청에 추가하여 표시되는 메시지 앞에 20개의 메시지를 가져올 수 있습니다. |
|
|
최신 버전
|
newer_than | integer |
숫자 문자열로 지정된 메시지 ID보다 최신 메시지를 반환합니다. 새 메시지를 폴링할 때 사용해야 합니다. 메시지를 보고 있고 가장 최근에 반환된 메시지가 3516인 경우 "?newer_than=3516" 매개 변수를 사용하여 요청을 수행하여 페이지에 이미 중복된 메시지 복사본을 가져오지 않도록 할 수 있습니다. |
|
|
한계
|
limit | integer |
지정된 수의 메시지만 반환합니다. |
|
|
페이지
|
page | integer |
지정된 페이지를 가져옵니다. 반환된 데이터가 제한보다 큰 경우 이 필드를 사용하여 후속 페이지에 액세스할 수 있습니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- MessageList
메시지 게시(V2)
이 작업은 그룹 또는 모든 회사 피드에 메시지를 게시하는 데 사용됩니다. 그룹 ID가 제공되면 지정된 그룹에 메시지가 게시되고, 그렇지 않으면 모든 회사 피드에 게시됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크의 고유 ID입니다. |
|
|
그룹 아이디
|
group_id | True | integer |
메시지를 게시할 그룹입니다(0 = 모든 회사/네트워크). |
|
메시지 텍스트
|
body | True | string |
네트워크에 게시할 메시지입니다. |
|
ID에 회신됨
|
replied_to_id | integer |
이 메시지가 회신 중인 메시지 ID입니다. |
|
|
Direct To Id
|
direct_to_id | integer |
설정된 경우 개인 메시지가 표시된 ID를 사용하여 사용자에게 직접 전송됩니다. |
|
|
방송
|
broadcast | boolean |
그룹의 모든 사용자에게 메시지를 알림으로 게시합니다. |
|
|
제목
|
title | string |
게시할 메시지의 제목입니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- MessageListV2
메시지 게시 [사용되지 않음]
이 작업은 그룹 또는 모든 회사 피드에 메시지를 게시하는 데 사용됩니다. 그룹 ID가 제공되면 지정된 그룹에 메시지가 게시되고, 그렇지 않으면 모든 회사 피드에 게시됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크의 고유 ID입니다. |
|
|
그룹 아이디
|
group_id | True | integer |
메시지를 게시할 그룹입니다(0 = 모든 회사/네트워크). |
|
메시지 텍스트
|
body | True | string |
네트워크에 게시할 메시지입니다. |
|
ID에 회신됨
|
replied_to_id | integer |
이 메시지가 회신 중인 메시지 ID입니다. |
|
|
Direct To Id
|
direct_to_id | integer |
설정된 경우 개인 메시지가 표시된 ID를 사용하여 사용자에게 직접 전송됩니다. |
|
|
방송
|
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) [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 모든 메시지 가져오기(V3) 를 사용하세요.
이 작업은 로그인한 사용자의 Viva Engage 네트워크에 있는 모든 공용 메시지를 반환합니다. Viva Engage 웹 인터페이스의 "모두" 대화에 해당합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크의 고유 식별자
|
network_id | string |
네트워크 ID |
|
|
이전 버전
|
older_than | integer |
숫자 문자열로 지정된 메시지 ID보다 오래된 메시지를 반환합니다. 이는 메시지 페이지를 매길 때 유용합니다. 예를 들어 현재 20개의 메시지를 보고 있고 가장 오래된 메시지가 숫자 2912인 경우 "?older_than=2912"를 요청에 추가하여 표시되는 메시지 앞에 20개의 메시지를 가져올 수 있습니다. |
|
|
최신 버전
|
newer_than | integer |
숫자 문자열로 지정된 메시지 ID보다 최신 메시지를 반환합니다. 새 메시지를 폴링할 때 사용해야 합니다. 메시지를 보고 있고 가장 최근에 반환된 메시지가 3516인 경우 "?newer_than=3516" 매개 변수를 사용하여 요청을 수행하여 페이지에 이미 중복된 메시지 복사본을 가져오지 않도록 할 수 있습니다. |
|
|
메시지의 스레드 유형
|
threaded | string |
Threaded=true는 각 스레드에 대한 스레드 시작(첫 번째 메시지)만 반환합니다. 이 매개 변수는 축소된 메시지 스레드를 표시해야 하는 앱용입니다. threaded=extended는 Viva Engage 웹 인터페이스의 기본 보기에서 볼 수 있으므로 스레드 시작 메시지와 가장 최근의 두 메시지를 모두 작업별로 정렬하여 반환합니다. |
|
|
한계
|
limit | integer |
지정된 수의 메시지만 반환합니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- PageableMessageList
모든 메시지 가져오기(V3)
이 작업은 로그인한 사용자의 Viva Engage 네트워크에 있는 모든 공용 메시지를 반환합니다. Viva Engage 웹 인터페이스의 "모두" 대화에 해당합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크의 고유 식별자
|
network_id | string |
네트워크 ID |
|
|
이전 버전
|
older_than | integer |
숫자 문자열로 지정된 메시지 ID보다 오래된 메시지를 반환합니다. 이는 메시지 페이지를 매길 때 유용합니다. 예를 들어 현재 20개의 메시지를 보고 있고 가장 오래된 메시지가 숫자 2912인 경우 "?older_than=2912"를 요청에 추가하여 표시되는 메시지 앞에 20개의 메시지를 가져올 수 있습니다. |
|
|
최신 버전
|
newer_than | integer |
숫자 문자열로 지정된 메시지 ID보다 최신 메시지를 반환합니다. 새 메시지를 폴링할 때 사용해야 합니다. 메시지를 보고 있고 가장 최근에 반환된 메시지가 3516인 경우 "?newer_than=3516" 매개 변수를 사용하여 요청을 수행하여 페이지에 이미 중복된 메시지 복사본을 가져오지 않도록 할 수 있습니다. |
|
|
메시지의 스레드 유형
|
threaded | string |
Threaded=true는 각 스레드에 대한 스레드 시작(첫 번째 메시지)만 반환합니다. 이 매개 변수는 축소된 메시지 스레드를 표시해야 하는 앱용입니다. threaded=extended는 Viva Engage 웹 인터페이스의 기본 보기에서 볼 수 있으므로 스레드 시작 메시지와 가장 최근의 두 메시지를 모두 작업별로 정렬하여 반환합니다. |
|
|
한계
|
limit | integer |
지정된 수의 메시지만 반환합니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- PageableMessageListV2
모든 메시지 가져오기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 모든 메시지 가져오기(V3) 를 사용하세요.
이 작업은 로그인한 사용자의 Viva Engage 네트워크에 있는 모든 공용 메시지를 반환합니다. Yammer 웹 인터페이스의 "모두" 대화에 해당합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크의 고유 식별자
|
network_id | string |
네트워크 ID |
|
|
이전 버전
|
older_than | integer |
숫자 문자열로 지정된 메시지 ID보다 오래된 메시지를 반환합니다. 이는 메시지 페이지를 매길 때 유용합니다. 예를 들어 현재 20개의 메시지를 보고 있고 가장 오래된 메시지가 숫자 2912인 경우 "?older_than=2912"를 요청에 추가하여 표시되는 메시지 앞에 20개의 메시지를 가져올 수 있습니다. |
|
|
최신 버전
|
newer_than | integer |
숫자 문자열로 지정된 메시지 ID보다 최신 메시지를 반환합니다. 새 메시지를 폴링할 때 사용해야 합니다. 메시지를 보고 있고 가장 최근에 반환된 메시지가 3516인 경우 "?newer_than=3516" 매개 변수를 사용하여 요청을 수행하여 페이지에 이미 중복된 메시지 복사본을 가져오지 않도록 할 수 있습니다. |
|
|
한계
|
limit | integer |
지정된 수의 메시지만 반환합니다. |
|
|
페이지
|
page | integer |
지정된 페이지를 가져옵니다. 반환된 데이터가 제한보다 큰 경우 이 필드를 사용하여 후속 페이지에 액세스할 수 있습니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- MessageList
사용자 세부 정보 가져오기
이 작업은 사용자 프로필 세부 정보를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
사용자 ID
|
user_id | True | integer |
사용자의 고유 식별자입니다. |
반환
Viva Engage 사용자의 속성입니다.
- 사용자
- User
스레드에서 메시지 가져오기(V2) [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 스레드(V3)에서 메시지 가져오기를 사용하세요.
이 작업은 스레드에 게시된 메시지를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
스레드 ID
|
thread_id | True | integer |
스레드의 고유 식별자입니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- PageableMessageList
스레드에서 메시지 가져오기(V3)
이 작업은 스레드에 게시된 메시지를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
스레드 ID
|
thread_id | True | integer |
스레드의 고유 식별자입니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- PageableMessageListV2
스레드에서 메시지 가져오기 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 스레드(V3)에서 메시지 가져오기를 사용하세요.
이 작업은 스레드에 게시된 메시지를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
스레드 ID
|
thread_id | True | integer |
스레드의 고유 식별자입니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- MessageList
좋아요 메시지
이 작업은 지정된 메시지를 같게 하는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메시지 ID
|
message_id | True | string |
메시지의 고유 ID입니다. |
트리거
| 그룹에 새 메시지가 있는 경우(V2) |
이 작업은 그룹에 새 메시지가 게시될 때 트리거됩니다. |
| 그룹에 새 메시지가 있는 경우 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 대신 그룹(V2)에 새 메시지가 있는 경우를 사용하세요.
|
| 팔로우한 피드에 새 메시지가 있는 경우(V2) |
이 작업은 네트워크에 새 메시지가 있을 때 트리거됩니다. |
| 팔로우한 피드에 새 메시지가 있는 경우 [사용되지 않음] |
이 작업은 더 이상 사용되지 않습니다. 팔로우한 피드(V2)에 새 메시지가 있는 경우 대신 사용하세요.
|
그룹에 새 메시지가 있는 경우(V2)
이 작업은 그룹에 새 메시지가 게시될 때 트리거됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크의 고유 식별자입니다. |
|
|
그룹 ID
|
group_id | True | integer |
그룹의 고유 식별자입니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- MessageListV2
그룹에 새 메시지가 있는 경우 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 대신 그룹(V2)에 새 메시지가 있는 경우를 사용하세요.
이 작업은 그룹에 새 메시지가 게시될 때 트리거됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크의 고유 식별자입니다. |
|
|
그룹 ID
|
group_id | True | integer |
그룹의 고유 식별자입니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- MessageList
팔로우한 피드에 새 메시지가 있는 경우(V2)
이 작업은 네트워크에 새 메시지가 있을 때 트리거됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크를 선택합니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- MessageListV2
팔로우한 피드에 새 메시지가 있는 경우 [사용되지 않음]
이 작업은 더 이상 사용되지 않습니다. 팔로우한 피드(V2)에 새 메시지가 있는 경우 대신 사용하세요.
이 작업은 네트워크에 새 메시지가 있을 때 트리거됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
네트워크 ID
|
network_id | string |
네트워크를 선택합니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- MessageList
정의
사용자
Viva Engage 사용자의 속성입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자 이름
|
name | string |
사용자 이름. |
|
직함
|
job_title | string |
사용자 직종입니다. |
|
위치
|
location | string |
사용자 위치입니다. |
|
전체 이름
|
full_name | string |
사용자 전체 이름입니다. |
|
이름 (이름의 첫 부분)
|
first_name | string |
사용자 이름입니다. |
|
성(姓)
|
last_name | string |
사용자 성입니다. |
|
프로필 URL
|
web_url | string |
사용자 프로필 URL입니다. |
|
전자 메일
|
string |
사용자 전자 메일. |
|
|
생년월일
|
birth_date | string |
사용자 생년월일입니다. |
|
사진 URL
|
mugshot_url | string |
사용자 사진 URL입니다. |
Message
단일 Viva Engage 메시지의 속성입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | integer |
게시물과 연결된 ID입니다. |
|
문자 메시지
|
content_excerpt | string |
게시물의 텍스트 콘텐츠입니다. |
|
보낸 사람
|
sender_id | integer |
메시지를 게시한 사용자의 고유 ID입니다. |
|
에 회신됨
|
replied_to_id | integer |
이 메시지가 회신인 메시지의 ID입니다. |
|
만든 위치에서
|
created_at | string |
메시지가 만들어진 시간입니다. |
|
네트워크
|
network_id | integer |
네트워크 메시지의 ID가 연결되어 있습니다. |
|
유형
|
message_type | string |
메시지 유형의 설명입니다. |
|
보낸 사람 유형
|
sender_type | string |
보낸 사람 유형에 대한 설명입니다. |
|
웹 주소
|
url | uri |
게시물의 API URL입니다. |
|
웹 URL
|
web_url | uri |
게시물의 웹 URL입니다. |
|
그룹 아이디
|
group_id | integer |
메시지를 게시한 그룹의 고유 ID입니다. |
|
메시지 본문
|
body | MessageBody |
단일 메시지와 연결된 콘텐츠입니다. |
|
스레드 ID
|
thread_id | integer |
스레드의 고유 ID입니다. |
|
직접 메시지
|
direct_message | boolean |
게시물이 직접 메시지인지 지정하는 플래그입니다. |
|
클라이언트 ID
|
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 메시지의 속성입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | integer |
게시물과 연결된 ID입니다. |
|
문자 메시지
|
content_excerpt | string |
게시물의 텍스트 콘텐츠입니다. |
|
보낸 사람
|
sender_id | integer |
메시지를 게시한 사용자의 고유 ID입니다. |
|
에 회신됨
|
replied_to_id | integer |
이 메시지가 회신인 메시지의 ID입니다. |
|
만든 위치에서
|
created_at | string |
메시지가 만들어진 시간입니다. |
|
네트워크
|
network_id | integer |
네트워크 메시지의 ID가 연결되어 있습니다. |
|
유형
|
message_type | string |
메시지 유형의 설명입니다. |
|
보낸 사람 유형
|
sender_type | string |
보낸 사람 유형에 대한 설명입니다. |
|
웹 주소
|
url | uri |
게시물의 API URL입니다. |
|
웹 URL
|
web_url | uri |
게시물의 웹 URL입니다. |
|
그룹 아이디
|
group_id | integer |
메시지를 게시한 그룹의 고유 ID입니다. |
|
메시지 본문
|
body | MessageBody |
단일 메시지와 연결된 콘텐츠입니다. |
|
스레드 ID
|
thread_id | integer |
스레드의 고유 ID입니다. |
|
직접 메시지
|
direct_message | boolean |
게시물이 직접 메시지인지 지정하는 플래그입니다. |
|
클라이언트 ID
|
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 |
게시물이 시스템 생성 메시지인지 여부를 지정하는 플래그입니다. |
주제
단일 항목의 속성입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | integer |
토픽의 고유 식별자입니다. |
|
이름
|
name | string |
항목의 이름입니다. |
PageableMessageList
하나 이상의 메시지 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Messages
|
value | array of Message |
PageableMessageListV2
하나 이상의 메시지 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Messages
|
value | array of MessageV2 |
MessageList
하나 이상의 메시지 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Messages
|
messages | array of Message |
messages |
MessageListV2
하나 이상의 메시지 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Messages
|
messages | array of MessageV2 |
messages |
MessageBody
단일 메시지와 연결된 콘텐츠입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문자 메시지
|
parsed | string |
구문 분석된 텍스트 형식입니다. |
|
일반
|
plain | string |
일반 텍스트 형식입니다. |
|
풍부한
|
rich | string |
서식 있는 텍스트 형식입니다. |
LikedBy
좋아요 기준
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | integer |
고유한 좋아요의 수입니다. |
|
Names
|
names | array of object |
게시물을 좋아한 사용자 목록입니다. |
|
전체 이름
|
names.full_name | string |
게시물을 좋아한 사람의 전체 이름입니다. |
네트워크
단일 네트워크의 속성입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
네트워크의 고유 식별자입니다. |
|
이름
|
name | string |
네트워크의 요약입니다. |
|
Link
|
permalink | string |
네트워크 페이지에 대한 웹 링크입니다. |
YammmerEntity
단일 Viva Engage 엔터티의 속성입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Description
|
type | string |
Viva Engage 엔터티의 세부 정보입니다. |
|
그룹 아이디
|
id | integer |
그룹의 고유 식별자입니다. |
|
전체 이름
|
full_name | string |
Viva Engage 엔터티의 이름입니다. |