Facebook Messenger

Dialogflow Facebook Messenger 통합을 사용하면 최종 사용자와 상호작용하는 Facebook Messenger 봇을 만들 수 있습니다.

제한사항

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

작동 방식

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

Facebook Messenger 플랫폼을 사용하는 Facebook 앱을 만듭니다.
Dialogflow 통합과 Facebook 앱이 서로 통신할 수 있도록 구성합니다.
Dialogflow 통합은 Facebook Messenger API를 사용하여 최종 사용자에게 메시지를 보냅니다.
Dialogflow 통합은 Facebook Messenger 웹훅 역할을 하여 최종 사용자로부터 메시지를 수신합니다.

설정

통합을 설정하려면 다음 안내를 따르세요.

단계에 따라 Facebook 앱을 만듭니다. Facebook 앱 개발 참조
Facebook Messenger 플랫폼을 사용하도록 Facebook 앱을 설정합니다. Facebook 앱 설정 문서의 단계에 따라 다음을 수행합니다.
- Facebook 앱에 Messenger 플랫폼을 추가합니다.
- Facebook 페이지에 앱을 구독합니다. 이 단계에서 액세스 토큰이 제공됩니다. 이 값을 복사합니다. 이 토큰은 Dialogflow 콘솔에서 통합을 구성하는 데 사용됩니다.
- 아직 웹훅을 구성하거나 통합을 테스트하지 마세요.
Dialogflow 콘솔에서 통합을 구성합니다.
1. Dialogflow ES 콘솔로 이동합니다.
2. 왼쪽 사이드바 메뉴에서 통합을 클릭합니다.
3. Facebook Messenger를 클릭합니다.
4. 구성 대화상자가 열립니다.
  - 이전 콜백 URL 표시 :이 전환이 표시되면 기본적으로 사용 중지입니다. 이 옵션은 Facebook Messenger API의 최근 수정 사항을 반영하기 위한 임시 옵션입니다. Dialogflow 지원팀의 안내가 없는 한 이 전환을 변경하지 마세요. 모든 에이전트가 업데이트된 후에 이 옵션은 삭제됩니다.
  - 콜백 URL :이 값을 복사합니다. Facebook Messenger 웹훅을 구성하는 데 사용됩니다.
  - 확인 토큰 : 원하는 비공개 토큰을 입력할 수 있습니다. 이 값을 복사합니다. Facebook Messenger 웹훅을 구성하는 데 사용됩니다.
  - 페이지 액세스 토큰 : Facebook 페이지를 만들 때 복사한 액세스 토큰을 입력합니다.
  - 시작: 클릭하면 에이전트에 이 통합 서비스를 시작합니다.
Facebook 앱 설정을 완료하고 테스트합니다. Facebook 앱 설정 문서의 단계에 따라 다음을 수행합니다.
- 앱의 Facebook 웹훅을 구성합니다. 위에서 복사한 콜백 URL 및 확인 토큰 값을 사용합니다. 메시지 및 messaging_postbacks를 사용 설정해야 합니다.
- 앱을 테스트합니다.

이벤트

이 통합으로 다음 이벤트가 호출됩니다.

이벤트	설명
`FACEBOOK_WELCOME`	최종 사용자가 봇과 대화를 시작하면 트리거됩니다.

리치 응답 메시지

이 통합은 일부 리치 응답 메시지를 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"
      }
    }
  }
}