# discourse-chat-integration 플러그인으로 Microsoft Teams 알림 설정하기
**URL:** https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193
**Category:** Integrations
**Tags:** chat-integration, how-to
**Created:** [7월 29, 2020, 5:41오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193 "2020-07-29T17:41:28Z")
**Posts on this page:** 20
**Page:** 1
### Author:  [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [7월 29, 2020, 5:41오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/1 "2020-07-29T17:41:28Z")
이 가이드는 `discourse-chat-integration`에 포함된 Microsoft Teams 제공자를 설정하는 방법을 설명합니다.
## Microsoft Teams 설정
Microsoft Teams에서:
1. 왼쪽의 세로 내비게이션 바에서 마침표 버튼(…)을 클릭하고 메뉴에서 **작업 흐름(Workflows)**을 선택합니다.
2. **작업 흐름(Workflows)** 페이지의 오른쪽 상단에 있는 **+ 처음부터 만들기(Build from scratch)** 버튼을 클릭합니다.
3. 사용자 정의 작업 흐름 모달에서 `webhook`을 검색하고 **Teams 웹훅 요청이 수신될 때(When a Teams webhook request is received)** 트리거를 선택합니다.
4. **작업 흐름을 트리거할 수 있는 사람(Who can trigger the flow)** 필드에서 `누구나(Anyone)`를 선택합니다. \[1\]
5. **+ 새 단계(New step)**를 클릭합니다.
6. 다음으로, `card`을 검색하고 **채팅 또는 채널에 카드 게시(Post card in a chat or channel)** 작업을 선택합니다.
7. 필드를 다음과 같이 입력합니다:
- **게시자(Post as):** 메시지가 누구로부터 온 것인지 선택합니다. 기본값을 그대로 두거나 `사용자(User)`를 선택하여 메시지가 나로부터 온 것으로 보이도록 할 수 있습니다.
- **게시 위치(Post in):** `채널(Channel)`을 선택하면 더 많은 필드가 표시됩니다:
1. **적응형 카드(Adaptive Card)** 필드 안쪽을 클릭하여 동적 콘텐츠 또는 수식을 삽입하는 팝업을 엽니다 \[2\] **수식(Expression)** 탭으로 전환하고 수식 필드에 `triggerBody()`를 입력합니다.
2. **저장(Save)**을 클릭합니다.
3. 이제 목록에서 `수동 → 채팅 또는 채널에 카드 게시(manual → Post card in a chat or channel)`라는 이름의 작업 흐름을 볼 수 있어야 합니다. 이 작업 흐름의 세로 점 세 개 버튼을 클릭하고 드롭다운 메뉴에서 **세부 정보(Details)**를 선택합니다.
4. 이 페이지에서 **웹훅 링크 복사(Copy webhook link)**를 클릭하여 다음 단계를 위한 링크를 가져옵니다. 여기에 있는 동안 팀원들이 목적을 알 수 있도록 작업 흐름 이름을 선택적으로 편집할 수 있습니다.
## Discourse 설정
이제 Discourse로 돌아갑니다:
1. Discourse 관리자 영역에서 `채팅 통합 활성화(Chat integration enabled)` 설정을 켜서 채팅 통합 플러그인을 활성화하고, `채팅 통합 Teams 활성화(Chat integration Teams enabled)` 설정을 켜서 Microsoft Teams를 지원합니다.
2. 사이드바에서 **플러그인(Plugins)** 섹션을 찾아 **채팅 통합(Chat Integrations)을 클릭한 다음, + 채널 만들기(Create Channel)**를 클릭합니다.
3. **채널 편집(Edit Channel)** 모달에서 필드를 다음과 같이 입력합니다:
- **이름(Name):** 어떤 Microsoft Teams 채널을 연결하는지 명확하게 나타내는 이름을 입력합니다. 정확한 일치일 필요는 없습니다.
- **웹훅 URL(Webhook URL):** 위의 Teams 설정 섹션 11단계에서 복사한 웹훅 URL을 붙여넣습니다.
1. **채널 저장(Save Channel)**을 클릭합니다.
## 통합 테스트
이제 모든 것이 예상대로 작동하는지 확인해야 할 때입니다.
1. Discourse에서 새로 생성된 채널에서 **테스트(Test)**를 클릭합니다.
2. ID, 제목 또는 URL로 주제를 검색하고, 원하는 주제를 선택한 다음 **테스트 메시지 보내기(Send Test Message)**를 클릭합니다.
3. Microsoft Teams에서 주제에 대한 정보가 포함된 새 메시지가 채널에 게시되어야 합니다:
## 선택 사항: 채널용 규칙 설정
모든 것이 정상 작동하는지 확인했으므로, Discourse로 돌아가 [채널에 추가 규칙을 설정](https://meta.discourse.org/t/discourse-chat-integration/66522#p-309579-configuring-rules-4)하여 메시지를 사용자 정의할 수 있습니다.
## 디버깅
Microsoft Teams에서 예상대로 메시지가 표시되지 않으면, **작업 흐름 세부 정보(Workflow Details)** 페이지로 이동(위의 Teams 설정 섹션 10단계 참조)하여 **실행 이력(Run history)** 섹션을 확인합니다. 여기에는 각 메시지 실행에 대한 로그가 표시되어야 합니다.
실패한 실행을 클릭하면 페이지 상단에 오류 메시지가 표시되는 **Power Automate** 영역으로 이동합니다. (아래 스크린샷에서는 실행이 성공적이었지만, 화살표는 실패한 실행 시 오류가 표시될 위치를 나타냅니다.)
여기에는 문제를 자세히 설명하며, 이를 수정하거나 여기에서 공유하여 도움을 받을 수 있습니다.
* * *
1.
1. Discourse는 현재 Teams에 대한 인증된 웹훅을 지원하지 않으므로 “누구나” 옵션만 작동합니다.
2. 팝업이 표시되지 않으면 적응형 카드 필드에 일시적으로 아무 내용이나 입력한 후 작업 흐름을 저장하고 다시 편집을 위해 열면 팝업이 표시됩니다.
---
### Author:  [@SHilser](https://meta.discourse.org/u/SHilser)
#### Post date: [8월 13, 2020, 8:44오전 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/2 "2020-08-13T08:44:57Z")
방금 테스트해 봤는데 처음에는 작동하는 것 같았지만, **테스트 버튼을 처음 클릭했을 때만** 그랬습니다.
규칙은 다음과 같이 설정되어 있습니다:
- 유형: 일반
- 필터: 모든 주제(?)와 답변 (여기는 독일어에서 번역한 것입니다)
- 카테고리: 샌드박스
샌드박스 카테고리의 테스트 주제에 답변을 작성했을 때 채팅 통합 페이지에 경고 표시가 나타났지만, 경고 삼각형을 클릭하면 `unknown error...`라고 표시되고 오류 메시지는 `null`이었습니다.
또 다른 테스트 알림을 보내려 하면 `500 internal server error` 오류가 발생합니다.
어디서부터 문제를 조사해야 할지 힌트가 있다면 알려주세요. 이 내용을 다른 곳에(예: 채팅 통합 플러그인 페이지) 게시하거나 별도 주제로 만들어야 한다면, 해당 내용으로 이동해 주시거나 알려주세요.
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [8월 13, 2020, 9:45오전 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/3 "2020-08-13T09:45:31Z")
안녕하세요 @SHilser - 사이트의 `/logs`를 확인해서 관련 있는 내용이 있는지 봐주실 수 있을까요?
---
### Author:  [@SHilser](https://meta.discourse.org/u/SHilser)
#### Post date: [8월 13, 2020, 10:03오전 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/4 "2020-08-13T10:03:47Z")
두 가지 관련 있는 것 같습니다.
- Socket Error
- Internal Server Error
아래에 로그를 복사해 두었습니다. (도메인 이름은 mydomain.tld로 대체했습니다)
## Socket Errror
```plaintext
Message (4 copies reported)
SocketError (Failed to open TCP connection to outlook.office.com:443 (getaddrinfo: Temporary failure in name resolution))
app/controllers/application_controller.rb:340:in `block in with_resolved_locale'
app/controllers/application_controller.rb:340:in `with_resolved_locale'
lib/middleware/omniauth_bypass_middleware.rb:68:in `call'
lib/content_security_policy/middleware.rb:12:in `call'
lib/middleware/anonymous_cache.rb:336:in `call'
config/initializers/100-quiet_logger.rb:19:in `call'
config/initializers/100-silence_logger.rb:31:in `call'
lib/middleware/enforce_hostname.rb:22:in `call'
lib/middleware/request_tracker.rb:176:in `call'
Backtrace
/usr/local/lib/ruby/2.6.0/net/http.rb:949:in `rescue in block in connect'
/usr/local/lib/ruby/2.6.0/net/http.rb:946:in `block in connect'
/usr/local/lib/ruby/2.6.0/timeout.rb:93:in `block in timeout'
/usr/local/lib/ruby/2.6.0/timeout.rb:103:in `timeout'
/usr/local/lib/ruby/2.6.0/net/http.rb:945:in `connect'
/usr/local/lib/ruby/2.6.0/net/http.rb:930:in `do_start'
/usr/local/lib/ruby/2.6.0/net/http.rb:919:in `start'
/usr/local/lib/ruby/2.6.0/net/http.rb:1470:in `request'
rack-mini-profiler (2.0.4) lib/patches/net_patches.rb:19:in `block in request_with_mini_profiler'
rack-mini-profiler (2.0.4) lib/mini_profiler/profiling_methods.rb:33:in `step'
Env
HTTP HOSTS: mysite.tld
```
## Internal Server Error
```plaintext
Message (4 copies reported)
Error: Internal Server Error
Url: https://mysite.tld/assets/ember_jquery-1ed3f3559e6f967733b4088aa729ff7039dff2c09c5a5f787a214b016f58aabc.js
Line: 1
Column: 267890
Window Location: https://mysite.tld/admin/plugins/chat/teams
Backtrace
o/t
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [8월 13, 2020, 10:16오전 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/5 "2020-08-13T10:16:01Z")
> [@SHilser](#):
>
> `Temporary failure in name resolution`
이것은 서버가 DNS 해석에 문제가 있음을 시사합니다. 표준 Docker 기반 설치를 사용하고 계신가요? 아니면 개발 환경인가요?
---
### Author:  [@SHilser](https://meta.discourse.org/u/SHilser)
#### Post date: [8월 13, 2020, 10:55오전 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/6 "2020-08-13T10:55:57Z")
일주일 전쯤 별도의 DigitalOcean 드롭렛에 설치했습니다(원클릭 설치). 현재 버전은 2.6.0.beta1 ([310952fd6a](https://github.com/discourse/discourse/commits/310952fd6a2fb74127175486bb0d6723640a274d))입니다. 서브도메인을 사용하며 DNS 레코드도 DigitalOcean에 설정되어 있습니다. [이 안내](https://meta.discourse.org/t/straightforward-direct-delivery-incoming-mail/49487)에 따라 이메일로 답변을 받기 위해 IP로 가리키는 A 레코드와 서브도메인 이름으로 가리키는 MX 레코드를 설정했습니다. 유일한 차이점은 DMARC 레코드를 게시하지 않았다는 점입니다.
DNS 관련해서 제가 한 작업은 이 정도입니다. 하지만 지금까지는 모든 것이 예상대로 작동했습니다. 사이트가 설정되었고 서브도메인 이름으로 접속할 수 있으며, 로그인하고 토픽을 생성(이메일로도 가능)하는 등 모든 기능이 정상적으로 동작합니다.
그런데 첫 번째 메시지는 통과했지만 이후 메시지들은 통과하지 못해서 당황스럽습니다 🤷♂️
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [8월 13, 2020, 12:06오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/7 "2020-08-13T12:06:27Z")
DNS 해석이라고 할 때, 이는 서버가 `outlook.office.com`에 연결하는 데 문제가 있다는 뜻입니다. 포럼의 DNS 레코드 설정은 이에 영향을 주지 않아야 합니다.
SSH로 서버에 접속하여 다음을 실행해 볼 수 있나요?
```plaintext
host outlook.office.com
```
아래와 같은 결과가 나와야 합니다.
```plaintext
outlook.office.com is an alias for substrate.office.com.
substrate.office.com is an alias for substrate.ms-acdc.office.com.
substrate.ms-acdc.office.com is an alias for afd-k.office.com.
afd-k.office.com is an alias for outlook-office-com.k-0002.k-msedge.net.
outlook-office-com.k-0002.k-msedge.net is an alias for k-0002.k-msedge.net.
k-0002.k-msedge.net has address 13.107.18.11
k-0002.k-msedge.net has IPv6 address 2620:1ec:c::11
```
---
### Author:  [@SHilser](https://meta.discourse.org/u/SHilser)
#### Post date: [8월 13, 2020, 12:59오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/8 "2020-08-13T12:59:21Z")
다음과 같이 입력하면
```plaintext
host -d outlook.office.com
```
아래와 같은 결과를 얻습니다:
```plaintext
Trying "outlook.office.com"
Host outlook.office.com not found: 2(SERVFAIL)
Received 36 bytes from 127.0.0.53#53 in 43 ms
```
포트 :443을 추가하면 다른 오류가 발생합니다.
```plaintext
Trying "outlook.office.com:443"
Host outlook.office.com:443 not found: 3(NXDOMAIN)
Received 40 bytes from 127.0.0.53#53 in 3 ms
Received 40 bytes from 127.0.0.53#53 in 3 ms
```
google.com이나 제가 언급한 discourse 인스턴스의 도메인(h-da.transformative-praxis.cc) 또는 기타 사이트의 경우, 귀하가 설명하신 것과 유사한 예상된 출력을 얻습니다.
첫 번째 오류에 대해 검색을 해 보았지만, 그 원인이 무엇인지 여전히 확실하지 않습니다. 다음 내용을 읽어 보았지만, 이것이 제 문제와 실제로 관련이 있는지 판단하지 못했습니다:
- [[Solved] Outlook.office365.com DNS issues - Help - Pi-hole Userspace](https://discourse.pi-hole.net/t/solved-outlook-office365-com-dns-issues/6944)
- [https://stackoverflow.com/questions/54599618/domain-not-resolving-mydomain-com-not-found-2servfail](https://stackoverflow.com/questions/54599618/domain-not-resolving-mydomain-com-not-found-2servfail)
---
### Author:  [@SHilser](https://meta.discourse.org/u/SHilser)
#### Post date: [8월 26, 2020, 5:26오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/9 "2020-08-26T17:26:10Z")
계속 재시도해 보았는데, 이번에는 다음을 입력할 때 말씀하신 결과를 확인했습니다.
```plaintext
host outlook.office.com
```
따라서 이 시점에서는 모든 것이 정상인 것처럼 보였습니다. 확실하게 확인하기 위해 약 10초 간격으로 15회 정도 연속으로 반복했는데, 어느 시점부터는 이전과 동일한 servfail 오류가 발생했습니다. 하지만 대부분은 정상적으로 작동했습니다.
테스트 메시지를 보내는 경우에는 정반대입니다. 10번 중 1번 정도만 성공합니다. 나머지 경우에는 이전과 동일한 오류가 발생합니다. 그리고 채널에 설정한 규칙에 맞는 일반 메시지를 게시하면 알림도, 로그에 오류 메시지도 표시되지 않습니다.
어떤 원인이 이런 문제를 일으키는지 파악하기가 너무 무작위적으로 느껴집니다.
각 하위 도메인당 두 개의 드롭렛과 두 개의 A 레코드, 그리고 `ns1.digitalocean.com`을 가리키는 _메인_ 도메인의 NS 레코드 한 세트로 구성된 제 설정이 문제일 것 같다고 계속 의심했습니다. 그래서 [dnsstuff](https://tools.dnsstuff.com/#dnsReport%7Ctype=domain&&value=h-da.transformative-praxis.cc)로 제 사이트를 검사해 보니 `SOA record check`에서 Fail 판정을 받았고, [whatsmydns.net](https://www.whatsmydns.net/#NS/h-da.transformative-praxis.cc)로 NS 레코드를 확인해 보았지만, 여전히 제 문제와 어떤 연관성이 있는지 파악하지 못했습니다.
이 시점에서 누가 오류를 일으키고 있는지 완전히 혼란스럽습니다. @david의 말대로 영향을 주지 않아야 할 DNS 설정을 잘못한 제 문제인지, 서버 설정/문제인지, 아니면 단순히 MS-Teams(`outlook.office.com`)의 문제이거나 어떤 식으로든 저를 차단하고 있는 것인지요?
오류를 찾기 위해 무엇을 확인하거나 해야 할지에 대한 힌트는 모두 환영합니다. 여기에서 도움을 드리기 어려운 상황이라고 생각하시면, 어디로 가서 질문해야 할지에 대한 조언도 부탁드립니다.
지금까지 도와주셔서 정말 감사합니다.
---
### Author:  [@Dan\_Turner](https://meta.discourse.org/u/Dan_Turner)
#### Post date: [1월 26, 2021, 1:46오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/10 "2021-01-26T13:46:51Z")
안녕하세요, 도움 주셔서 감사합니다. Discourse 5단계에서 계속 실패하고 있습니다. 대화상자에 수신 웹훅 URL이 유효하지 않다고 표시됩니다.
도움 주시면 감사하겠습니다!
Dan
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [1월 26, 2021, 4:03오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/11 "2021-01-26T16:03:57Z")
웹훅 URL이 어떻게 생겼는지 공유해 주시겠어요? 제게 DM으로 보내주시거나, **먼저 무효화할 수 있다면** 이 토픽에 올려 주세요.
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [1월 26, 2021, 5:46오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/13 "2021-01-26T17:46:39Z")
Dan\_Turner님, 감사합니다. 검증 규칙을 조금 완화했는데, 상황이 개선될 것입니다. 시도해 보시고 더 잘 작동하는지 알려주세요.
>
---
### Author:  [@Dan\_Turner](https://meta.discourse.org/u/Dan_Turner)
#### Post date: [1월 26, 2021, 6:24오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/14 "2021-01-26T18:24:09Z")
감사합니다! 한번 시도해 볼게요.
댄
---
### Author:  [@Dan\_Turner](https://meta.discourse.org/u/Dan_Turner)
#### Post date: [1월 26, 2021, 8:10오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/15 "2021-01-26T20:10:32Z")
어리석은 질문이겠지만, Discourse를 업데이트해야 하는지, 아니면 수정 방법에 자세히 설명된 대로 파일을 직접 편집해야 하는지 궁금합니다.
감사합니다, Dan
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [1월 26, 2021, 8:35오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/16 "2021-01-26T20:35:16Z")
플러그인을 업데이트해야 합니다. `/admin/upgrade` 페이지로 이동하여 “Discourse-chat-integration” 옆의 업데이트 버튼을 누르세요.
---
### Author:  [@Dan\_Turner](https://meta.discourse.org/u/Dan_Turner)
#### Post date: [2월 5, 2021, 2:43오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/17 "2021-02-05T14:43:09Z")
안녕하세요 - 무능한 것 같아서 죄송하지만 - 호스팅된 디스코스 인스턴스를 사용 중인데 실제로 어떻게 시도해 볼 수 있을까요? 감사합니다. Dan
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [2월 5, 2021, 2:46오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/18 "2021-02-05T14:46:21Z")
호스팅 제공업체에 플러그인 업데이트를 요청해야 합니다. discourse.org에서는 이 변경 사항이 이미 모든 고객에게 배포되었으므로, 다른 곳에서 호스팅을 하고 계신 것 같습니다?
---
### Author:  [@Dan\_Turner](https://meta.discourse.org/u/Dan_Turner)
#### Post date: [2월 5, 2021, 2:48오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/19 "2021-02-05T14:48:21Z")
네, 제 경우라면 디스커스 호스팅이 맞습니다. 현재 어떤 버전인지 알려주시면 업데이트를 요청해 보겠습니다.
---
### Author:  [@david](https://meta.discourse.org/u/david)
#### Post date: [2월 5, 2021, 2:58오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/20 "2021-02-05T14:58:26Z")
플러그인에는 버전 번호가 없지만, 이 커밋 링크를 공유할 수 있습니다: [https://github.com/discourse/discourse-chat-integration/commit/00ec1f486a3fd1dc523cdf242cfb1c78baaa407e](https://github.com/discourse/discourse-chat-integration/commit/00ec1f486a3fd1dc523cdf242cfb1c78baaa407e)
---
### Author:  [@RomainP](https://meta.discourse.org/u/RomainP)
#### Post date: [5월 14, 2024, 6:54오후 UTC](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193/23 "2024-05-14T18:54:58Z")
이 유용한 플러그인을 만들어 주셔서 감사합니다.
훌륭한 개선 사항이 될 것 같습니다: 메시지 내에 그룹 멘션을 추가하여 Teams 쪽에서 알림을 생성하도록 하는 것입니다.
웹훅 API는 이 기능을 구현하지 않고 있는 것(또는 과거에 그랬던 것)으로 보이지만, 최근 구현되었다고 말하는 사람들도 있습니다.
쉽게 구현할 수 있다고 보시는지요?
[Next page](https://meta.discourse.org/t/set-up-microsoft-teams-notifications-using-the-discourse-chat-integration-plugin/159193.md?page=2)