Slack

Slack 통합을 사용하면 대화형 에이전트(Dialogflow CX) 기술을 기반으로 자연어 이해를 지원하는 Slack 봇을 쉽게 만들 수 있습니다.

제한사항

이 통합에서는 에이전트 기본 언어의 텍스트 입력만 지원됩니다.

Slack 설정

에이전트에 Slack 통합을 설정하려면 다음이 필요합니다.

Slack 계정
Slack 작업공간

Slack 봇 만들기

Slack 앱으로 이동합니다.

앱 매니페스트에서 새 Slack 앱을 만듭니다. 다음은 매니페스트 예시입니다. oath_config 및 event_subscriptions 필드가 예시 매니페스트와 일치하는지 확인합니다.

display_information:
  name: Conversational Agents (Dialogflow CX)
  description: Conversational Agents (Dialogflow CX) integration
  background_color: "#1148b8"
features:
  app_home:
    home_tab_enabled: false
    messages_tab_enabled: true
    messages_tab_read_only_enabled: false
  bot_user:
    display_name: CX
    always_online: true
oauth_config:
  scopes:
    bot:
      - app_mentions:read
      - chat:write
      - im:history
      - im:read
      - im:write
      - incoming-webhook
settings:
  event_subscriptions:
    request_url: https://dialogflow-slack-4vnhuutqka-uc.a.run.app
    bot_events:
      - app_mention
      - message.im
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

원하는 작업공간에 애플리케이션을 설치합니다.
- 봇 사용자 OAuth 토큰
  - 앱 설치 > 작업공간의 OAuth 토큰 > 봇 사용자 OAuth 토큰으로 이동합니다.
- 서명 토큰
  - 기본 정보 > 앱 사용자 인증 정보 > 서명 보안 비밀로 이동합니다.

대화형 에이전트 설정(Dialogflow CX)

왼쪽 패널에서 관리 탭을 클릭합니다.
왼쪽 메뉴에서 통합을 클릭합니다.
Slack 타일에서 연결 버튼을 클릭합니다.
다음 정보를 입력합니다.
- 액세스 토큰
- 서명 토큰
적절히 환경을 선택합니다.
시작을 클릭합니다.
웹훅 URL을 복사합니다.

Slack에서 웹훅 사용 설정

Slack App으로 돌아가고 이벤트 구독 > 이벤트 사용 설정 > 요청 URL에 웹훅 URL을 붙여넣습니다.

테스트

구성된 앱을 테스트하려면 앱을 설치한 작업공간에서 그룹 채널에 언급하거나 DM을 보냅니다.

리치 응답 메시지

리치 응답 메시지는 fulfillment의 커스텀 페이로드를 통해 지원됩니다. 메시지 형식은 Slack 메시지 API를 참조하세요.

예를 들어 다음 커스텀 페이로드는 간단한 Slack 문자 메시지를 제공합니다.

{
  "text": "Hello, world"
}

채널별 응답

채널별 응답을 구성하면 에이전트가 Slack 메시지에 응답할 때 DF_CX_SLACK 채널이 자동으로 사용됩니다.