Workplace from Facebook

Dialogflow Facebook Workplace 통합을 사용하여 Facebook 봇에서 최종 사용자와 상호작용하기 위한 Workplace를 만들 수 있습니다.

제한사항

이 통합에서는 기본 에이전트 언어만 지원합니다.

작동 방식

통합은 다음과 같이 작동합니다.

  • Dialogflow 통합과 Workplace 인스턴스가 서로 통신할 수 있도록 구성합니다.
  • Dialogflow 통합은 Facebook Messenger API를 사용하여 최종 사용자에게 메시지를 보냅니다.
  • Dialogflow 통합은 Workplace Webhook from Facebook 역할을 수행하여 최종 사용자의 메시지를 수신합니다.

시작

통합을 시작하는 방법은 다음과 같습니다.

  1. Workplace 인스턴스가 없으면 하나 등록하고 그룹의 시스템 관리자인지 확인합니다.

  2. Dialogflow 콘솔에서 통합을 사용 설정합니다.

    1. Dialogflow ES 콘솔로 이동합니다.
    2. 왼쪽 사이드바 메뉴에서 통합을 클릭합니다.
    3. Workplace from Facebook을 클릭합니다.
    4. 시작을 클릭하면 Workplace로 리디렉션되어 설치가 완료됩니다.
      • Workplace 계정에 로그인합니다. 통합을 설치하려면 계정이 Workplace의 시스템 관리자여야 합니다.
      • Dialogflow 통합 설치를 요청하는 팝업 창에서 Workplace 추가를 클릭합니다. 봇 이름을 맞춤설정할 수도 있습니다.

  3. 앱을 테스트합니다.

    1. Workplace로 이동하고 계정에 로그인합니다.
    2. 사이드바의 홈 섹션에서 봇의 Dialogflow를 찾고 봇과 채팅을 시작합니다.

취소

시작 버튼을 클릭했지만 Workplace에서 설치를 마치는 것이 내키지 않으면 다음 안내를 따르세요.

  1. Dialogflow ES 콘솔로 이동합니다.

  2. 왼쪽 사이드바 메뉴에서 통합을 클릭합니다.

  3. Facebook Workplace를 클릭합니다.

    1. 취소 버튼이 표시되는 경우 취소를 클릭하여 설치를 취소합니다.
    2. STOP 버튼이 표시되는 경우 아래 안내에 따라 통합을 제거합니다.

중지

성공적으로 설치된 통합을 중지하는 방법은 다음과 같습니다.

  1. Dialogflow ES 콘솔로 이동합니다.

  2. 왼쪽 사이드바 메뉴에서 통합을 클릭합니다.

  3. Facebook Workplace를 클릭합니다.

  4. STOP를 클릭하면 Workplace로 리디렉션되어 설치가 완료됩니다.

    1. Workplace 계정에 로그인합니다. 통합을 제거하려면 계정이 Workplace의 시스템 관리자여야 합니다.
    2. Workplace에 설치된 통합에서 Dialogflow 통합을 찾아 선택하고 제거를 클릭하여 제거를 완료합니다.

  5. Dialogflow 통합이 제거됩니다.

리치 응답 메시지

이 통합은 일부 리치 응답 메시지를 Facebook Messenger 플랫폼 메시지 유형으로 변환합니다.

이미지 응답

이미지 응답은 Facebook Messenger에 Facebook Messenger 파일 첨부 메시지로 전송됩니다. message.attachment.type 값은 image로 설정됩니다. 지원되는 형식은 다음과 같습니다.

  • jpg
  • png
  • 정적 GIF
  • 애니메이션 GIF

카드 응답

카드 응답은 Facebook Messenger에 Facebook Messenger 일반 템플릿으로 전송됩니다.

빠른 답장 응답

빠른 답장 응답은 Facebook Messenger에 Facebook Messenger 빠른 답장 응답으로 전송됩니다.

커스텀 페이로드 응답

다른 유형의 Facebook Messenger 메시지를 보내려면 커스텀 페이로드를 사용할 수 있습니다.

커스텀 페이로드의 일반적인 형식은 다음과 같습니다.

{
  "facebook": {
    message
  }
}

message 대신 Facebook Messenger message 객체를 제공합니다. message 객체에 대한 자세한 내용은 Facebook Messenger API 참조를 확인하세요.

예를 들면 다음과 같습니다.

  • 오디오 링크 보내기:
    {
  "facebook": {
    "attachment": {
      "type": "audio",
      "payload": {
        "url": "https://example.com/audio/test.mp3"
      }
    }
  }
}
  • 재생 가능한 동영상 보내기:
    {
  "facebook": {
    "attachment": {
      "type": "video",
      "payload": {
        "url": "https://example.com/video.mp4"
      }
    }
  }
}
  • 파일 보내기
    {
  "facebook": {
    "attachment": {
      "type": "file",
      "payload": {
        "url": "https://example.com/file.pdf"
      }
    }
  }
}

제한사항

  1. Dialogflow 에이전트는 Workplace 인스턴스 하나에만 설치될 수 있지만 Workplace 인스턴스 하나에 Dialogflow 에이전트를 여러 개 설치할 수 있습니다.

  2. 실패한 설치를 삭제하려면 Dialogflow에서 설치를 취소하고 Workplace에서 설치를 삭제해야 합니다.

마이그레이션

메신저 통합을 사용하고 있으며 Workplace 통합으로 마이그레이션하려는 경우 다음을 수행해야 합니다.

  1. 메신저 통합을 중지합니다.

  2. Facebook 앱 설정의 단계를 역순으로 수행하여 Facebook 앱에서 callback_url을 삭제합니다.

  3. 위 단계를 수행하여 Workplace 통합을 시작합니다.