다음 중 하나를 사용하여 Kore.ai 봇을 Mattermost 계정에 연결할 수 있습니다. (참고: 시작하기 전에 Mattermost 계정에 관리자 기능을 사용할 수 있는지 확인하세요.)

Webhook 기반 통합

1단계: 발신 Webhook 설정

  • Mattermost 계정에 로그인
  • ‘Main Menu‘(왼쪽 패널의 햄버거 메뉴)에서 ‘Integrations‘을 선택합니다.
  • ‘Outgoing Webhooks‘ 메뉴를 선택하고 ‘Add Outgoing Webhook‘를 클릭합니다.
  • 아래 이미지에 따라 필요한 정보를 입력합니다.
    • 제목과 설명, 봇 이름 필드에 원하는 값을 입력합니다.
    • 콘텐츠 유형으로 ‘application/json’을 선택합니다.
    • 특정 채널에서만 봇을 사용하려면 채널 드롭다운에서 필요한 채널을 선택합니다.
    • 트리거 단어 필드에 Kore.ai 봇 이름을 입력합니다.
    • Kore 봇(Mattermost 채널 활성화의 ‘설정’탭에 위치함)에 콜백 URL을 복사하여 ‘콜백 URL’ 필드에 입력합니다.
    • ‘저장’을 클릭하여 발신 Webhook 설정을 완료합니다.
    • 토큰이 표시되는 확인 페이지로 리디렉션됩니다.
    • 이 토큰을 복사하여 Kore 봇 채널 설정 섹션에 보이는 ‘발신 Webhook 토큰’ 필드에 입력합니다.

2단계: 수신 Webhook 설정

  • ‘Incoming Webhook‘ 메뉴를 선택하고 ‘Add Incoming Webhook‘를 클릭합니다.
  • 아래 이미지에 따라 필요한 정보를 입력합니다.
    • 제목과 설명, 사용자 이름 필드에 원하는 값을 입력합니다.
    • 기본값 채널을 선택합니다. Kore.ai 봇은 항상 사용자 입력이 수신된 채널에서 응답합니다.
    • ‘Lock to this channel’ 옵션을 선택하지 마세요.

  • ‘Save’를 클릭하여 수신 Webhook 설정을 완료합니다.
  • 새로 생성된 수신 Webhook과 연결된 URL과 함께 확인 페이지로 리디렉션됩니다.
  • 이 토큰을 복사하여 Kore Bot Channel Configurations 섹션의 ‘Incoming Webhook URL’ 필드에 입력합니다.

Websocket 기반 통합

1단계: 개인 액세스 토큰 활성화

WebSocket 연결을 활성화하려면, 봇으로 프로비저닝할 Mattermost 계정을 생성해야 합니다.

  • 우선, 개인 액세스 토큰 사용을 활성화하여 Mattermost 사용자가 개인 액세스 토큰을 생성할 수 있도록 합니다
  • 개인 액세스 토큰은 계정을 인증하고 계정에 액세스하는 데 사용됩니다.
    • ‘System Console’에 액세스 권한이 있는 Mattermost 계정에 로그인합니다.
    • ‘System Console’에서 ‘Integrations – Custom Integrations’ 메뉴로 이동합니다.
    • ‘Enable Personal Access Tokens’ 설정을 찾고 ‘True’로 설정하고 저장합니다.

2단계: 봇으로 프로비저닝할 계정 생성

  • Mattermost 사용자에게 봇으로 표시될 새 계정을 생성합니다.
  • 새 계정에 로그인하고 ‘Account Settings’ 섹션으로 이동합니다.
    • ‘Username’을 기록하고 Kore Bot Channel Configurations 섹션에 입력합니다.
  • ‘Account Settings – Security’ 섹션으로 이동합니다.
    • ‘Personal Access Tokens’ 섹션을 클릭하고 ‘Create New Token’을 클릭합니다.
    • 토큰 설명을 입력하고 ‘Save’합니다.
    • 확인 후 액세스 토큰이 표시됩니다.
    • ‘Access Token’을 기록하고 Kore Bot Channel Configurations 섹션에 입력합니다.

You can connect Kore.ai bots to your Mattermost account using either:
(NOTE: Before you begin, ensure that you have access to the administrative functions of your Mattermost account)

WebHook based Integration

Step 1: Setup Outgoing Webhook

  • Login to your Mattermost account
  • From the ‘Main Menu’ (hamburger menu from the left panel) choose ‘Integrations’.
  • Select the ‘Outgoing Webhooks’ menu and click ‘Add Outgoing Webhook’.
  • Provide required information as per the below image.
    • Enter your preferred values for Title, Description and Bot Name fields.
    • Choose ‘application/json’ as Content Type.
    • If you would like your bot to be available only for a specific channel, then choose the required channel from the Channel dropdown.
    • Provide your Kore.ai bot’s Bot Name in the Trigger Words field.
    • Copy the Callback URL for the Kore bot (located in the ‘Configurations’ tab of Mattermost Channel enablement) and provide it in the ‘Callback URLs’ field.
    • Click on ‘Save’ to complete the Outgoing Webhook setup.
    • You would be redirected to the confirmation page with the Token displayed.
    • Copy this Token and provide it in the ‘Outgoing Webhook Token’ field present in the Kore Bot Channel Configurations section.

Step 2: Setup Incoming Webhook

  • Select ‘Incoming Webhooks’ menu and click ‘Add Incoming Webhook’.
  • Provide required information as per the below image.
    • Enter your preferred values for Title, Description and Username fields.
    • Choose a default channel. Kore.ai bots always respond back in the channel from which the user input is received.
    • Do not select the ‘Lock to this channel’ option.

  • Click on ‘Save’ to complete the Incoming Webhook setup.
  • You would be redirected to the confirmation page along with the URL associated with this newly created incoming webhook.
  • Copy this URL and provide it in the ‘Incoming Webhook URL’ field in the Kore Bot Channel Configurations section.

WebSocket based Integration

Step 1: Enable Personal Access Tokens

To enable a WebSocket connection, you would need to create a Mattermost account to be provisioned as a bot.

  • First, enable usage of Personal Access Tokens to allow your Mattermost users to generate personal access tokens.
  • Personal access tokens are used to authenticate and provide full access to an account.
    • Login to Mattermost from an account that has access to ‘System Console’.
    • From ‘System Console’, navigate to the ‘Integrations – Custom Integrations’ menu.
    • Locate the ‘Enable Personal Access Tokens’ setting, set it to ‘true’, and save.

Step 2: Create an Account to be Provisioned as a Bot

  • Create a new account you intend to be presented as a bot for your Mattermost users.
  • Login to this new account and navigate to the ‘Account Settings’ section.
    • Make a note of the ‘Username’ and provide it in the Kore Bot Channel Configurations section.
  • Navigate to the ‘Account Settings – Security’ section.
    • Click on the ‘Personal Access Tokens’ section and click ‘Create New Token’.
    • Provide a description for your token and ‘Save’.
    • Post-confirmation, you will be presented with the access token.
    • Make a note of the ‘Access Token’ and provide it in the Kore Bot Channel Configurations section.