Facebook에 봇 커넥트
Facebook Messenger 또는 Facebook Workplace를 통해 사람들과 통신하도록 봇을 구성할 수 있습니다. 이 문서에서는 개발자용 메타 사이트를 사용하여 Facebook 앱을 만들고, Azure에서 Facebook 앱에 봇을 연결하고, Facebook에서 봇을 테스트하는 방법을 설명합니다.
이 문서에서는 Azure Portal을 통해 Facebook 채널을 봇에 추가하는 방법을 보여 줍니다. 사용자 지정 채널 어댑터를 사용하는 방법에 대한 자세한 내용은 추가 정보를 참조하세요.
필수 구성 요소
- Azure 구독 아직 계정이 없는 경우 시작하기 전에 체험 계정을 만듭니다.
- Facebook에 연결하려는 Azure에 게시된 봇입니다.
- 개발자용 Facebook 계정입니다. 계정이 없는 경우 developers.facebook.com 계정을 만들 수 있습니다.
- 사용자가 봇에 액세스할 Facebook 페이지입니다. 아직 없는 경우 새 페이지를 만듭니다.
- 봇과 함께 Facebook Workplace를 사용하려면 Workplace 계정과 사용자 지정 통합을 만들어 봇을 연결해야 합니다.
Facebook 앱 만들기
사용자는 Facebook 페이지에서 봇에 액세스합니다. 봇을 연결하려면 Facebook 페이지에서 Facebook Messenger를 사용하도록 설정한 다음 봇을 페이지에 연결합니다.
앱 만들기
- 개발자용 Meta 계정에 로그인합니다.
- 새 Facebook 앱 만들기로 이동합니다.
- 앱 유형 선택 페이지에서 비즈니스 및 다음을 선택합니다.
- 기본 정보 제공 페이지에서 앱의 이름을 입력하고 앱 만들기를 선택합니다.
- 메시지가 표시되면 암호를 입력하고 제출을 선택하여 앱을 만듭니다.
- 앱을 만든 후 사이트는 앱의 페이지로 이동합니다.
- 설정 확장하고 기본을 선택합니다.
- 앱 ID 및 앱 비밀을 복사하고 저장합니다.
- 이제 설정 아래에서 고급을 선택합니다.
- 결과 창에서 보안 설정까지 아래로 스크롤하고 앱 설정에 대한 API 액세스 허용을 사용하도록 설정합니다.
- 변경 내용 저장을 선택합니다.
Messenger 사용
- 대시보드를 선택합니다.
- 결과 창에서 Messenger 타일까지 아래로 스크롤하고 설정을 선택합니다.
- 사이트는 앱에 Messenger 설정을 추가하고 설정 페이지를 표시합니다.
페이지 추가 및 토큰 생성
Messenger에서 설정 선택합니다.
액세스 토큰까지 아래로 스크롤하고 페이지 추가 또는 제거를 선택합니다.
- 메신저와 연결할 ID를 묻는 메시지가 표시되면 현재 계정을 계속 사용하거나 다른 계정에 로그인합니다.
- 앱에서 사용할 페이지에 대한 메시지가 표시되면 페이지를 선택한 다음, 다음을 선택합니다.
- 로그인 검토 요청을 제출하라는 메시지가 표시되면 정보를 검토하고 완료를 선택합니다.
- 성공하면 사이트에 성공 페이지가 표시됩니다. 계속하려면 확인을 선택합니다.
이제 추가한 페이지가 페이지 목록에 표시됩니다.
나중에 페이지 ID를 복사하고 저장합니다.
페이지에 대한 토큰 생성을 선택합니다.
- 사이트에서 보안 정보를 표시하고 토큰을 복사할 수 있는 기회를 제공합니다.
- 경고를 읽고 승인합니다.
- 토큰을 복사하고 완료를 선택합니다.
이제 다음 단계에 대한 앱 정보와 토큰이 있습니다. Facebook 설정 단계를 보류 상태로 둡니다. 나중에 업데이트합니다.
Azure에서 봇 구성
봇이 Facebook Messenger에 메시지 및 기타 이벤트를 보내도록 하려면 웹후크 통합을 사용하도록 설정합니다.
- 새 브라우저 창에서 Azure Portal로 이동합니다.
- 봇에 대한 Azure Bot 리소스 블레이드를 엽니다.
- 채널을 열고 Facebook을 선택합니다.
- Facebook 채널 구성에서 이전 단계에서 복사한 Facebook 정보를 입력합니다.
- Facebook 앱 ID 및 Facebook 앱 비밀을 입력합니다.
- 페이지 ID 및 액세스 토큰을 입력합니다.
- 생성된 콜백 URL을 복사하고 토큰 값을 확인합니다.
- 추가를 선택합니다.
팁
- 이전 단계의 정보 복사본이 없는 경우 개발자용 메타 사이트에 대해 검색할 수 있습니다.
- 필요한 경우 페이지에 대한 새 웹 토큰을 만듭니다. 지침은 페이지 추가 및 토큰 생성을 참조 하세요.
웹후크 사용
Facebook 설정으로 돌아가서 구성 프로세스를 완료합니다.
- 개발자용 메타 사이트에서 앱의 Messenger 설정 페이지로 돌아갑니다.
- 결과 창에서 웹후크 섹션까지 아래로 스크롤하고 콜백 URL 추가를 선택합니다.
- 콜백 URL 편집 페이지에서 다음을 수행합니다.
- 콜백 URL을 입력하고 Azure Portal에서 복사한 토큰 값을 확인합니다.
- 확인 및 저장을 선택합니다.
- 이제 추가한 페이지가 웹후크 아래의 페이지 목록에 표시됩니다.
- 페이지에 대한 구독 추가를 선택합니다.
- 페이지 구독 편집 페이지에서 다음 구독 필드를 선택합니다.
- messages
- messaging_postbacks
- messaging_options
- message_deliveries
- 저장을 선택합니다.
- 페이지 구독 편집 페이지에서 다음 구독 필드를 선택합니다.
- 사이트에는 봇에 대한 페이지 옆에 추가된 구독 필드가 표시됩니다.
앱을 공개로 만들기
앱이 게시될 때까지 개발 모드로 전환됩니다. 플러그 인 및 API 기능은 관리자, 개발자 및 테스터에게만 작동합니다.
작성자(페이지 및 봇을 만든 Facebook 개발자 계정)만 봇 응답을 받을 수 있습니다. 일반 Facebook 사용자는 페이지 또는 봇을 볼 수 없습니다. 봇과 채팅할 수 있도록 개발 또는 테스트 역할을 대상 사용자에게 제공합니다.
테스터 역할에 추가할 사용자는 먼저 개발자용 Meta 사이트에 등록해야 합니다. 개발자용 메타 계정이 없는 Facebook 사용자는 테스터 역할을 사용할 수 없습니다. 앱 역할 및 테스트 사용자에 대한 자세한 내용은 개발자용 Meta 개발자 설명서를 참조 하세요.
검토를 위해 제출
Facebook에는 기본 앱 설정 페이지에 개인 정보 취급 방침 URL 및 서비스 약관 URL이 필요합니다. 행동 강령 페이지에는 개인 정보 취급 방침을 만드는 데 도움이 되는 타사 리소스 링크가 포함되어 있습니다. 사용 약관 페이지에는 적절한 서비스 약관 문서를 만드는 데 도움이 되는 샘플 용어가 포함되어 있습니다.
봇이 완료되면 Facebook은 Messenger에 게시된 앱에 대한 자체 검토 프로세스를 찾습니다. 봇은 Facebook 의 플랫폼 정책을 준수하는지 테스트합니다.
앱을 공개하고 페이지 게시
검토에 성공하면 앱 검토 아래의 앱 대시보드에서 앱을 공용으로 설정합니다. 이 봇과 연결된 Facebook 페이지가 게시되었는지 확인합니다. 페이지 설정에 상태가 표시됩니다.
API 버전 설정
Facebook에서 특정 버전의 Graph API 사용 중단에 대한 알림을 받는 경우:
- 개발자용 메타로 이동합니다.
- 봇에 대해 만든 앱으로 이동합니다.
- 설정 아래에서 고급을 선택합니다.
- 업그레이드 API 버전을 선택한 다음, 모든 호출을 버전 4.0으로 업그레이드합니다.
Facebook에서 봇 테스트 섹션에 설명된 단계에 따라 연결을 테스트합니다.
Facebook에서 봇 테스트
이제 새 Facebook 앱과 연결된 Facebook 페이지를 통해 메시지를 보내 봇이 Facebook에 올바르게 연결되었는지 테스트할 수 있습니다.
- Facebook으로 이동하여 페이지의 프로필로 전환합니다.
- 더 많은 작업(...)을 선택한 다음 , 작업 추가 단추를 선택합니다.
- 작업 사용자 지정 단추 대화 상자에서 [시도]를 선택하고 지침을 따릅니다.
- 사용자 연락처 가져오기의 작업 단추 페이지에서 메시지 보내기를 선택합니다.
- 다음을 선택하고 대화 상자를 완료하고 변경 내용을 저장합니다.
- 개인 프로필로 다시 전환합니다.
- 페이지로 이동하여 메시지를 선택하여 봇에 대한 연결을 테스트합니다.
이전 단계에서 설명한 것과 동일한 값으로 appsettings.json 파일을 채워 Facebook 어댑터용 샘플 봇을 사용하여 이 기능을 테스트할 수도 있습니다.
추가 정보
Facebook Messenger 통신을 지원하는 샘플 봇은 Bot Framework C# Facebook 이벤트 샘플을 참조하세요.
Facebook Messenger 설명서는 다음을 참조하세요.
Facebook Workplace 설명서는 다음을 참조하세요.