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를 사용하도록 설정한 다음 봇을 페이지에 연결합니다.

앱 만들기

  1. 개발자용 Meta 계정에 로그인합니다.
  2. 새 Facebook 앱 만들기로 이동합니다.
  3. 앱 유형 선택 페이지에서 비즈니스 및 다음을 선택합니다.
  4. 기본 정보 제공 페이지에서 앱의 이름을 입력하고 앱 만들기를 선택합니다.
    • 메시지가 표시되면 암호를 입력하고 제출을 선택하여 앱을 만듭니다.
    • 앱을 만든 후 사이트는 앱의 페이지로 이동합니다.
  5. 설정 확장하고 기본을 선택합니다.
    1. 앱 ID 및 앱 비밀을 복사하고 저장합니다.
  6. 이제 설정 아래에서 고급을 선택합니다.
    1. 결과 창에서 보안 설정까지 아래로 스크롤하고 앱 설정에 대한 API 액세스 허용을 사용하도록 설정합니다.
    2. 변경 내용 저장을 선택합니다.

Messenger 사용

  1. 대시보드를 선택합니다.
  2. 결과 창에서 Messenger 타일까지 아래로 스크롤하고 설정을 선택합니다.
  3. 사이트는 앱에 Messenger 설정을 추가하고 설정 페이지를 표시합니다.

페이지 추가 및 토큰 생성

  1. Messenger에서 설정 선택합니다.

  2. 액세스 토큰까지 아래로 스크롤하고 페이지 추가 또는 제거를 선택합니다.

    1. 메신저와 연결할 ID를 묻는 메시지가 표시되면 현재 계정을 계속 사용하거나 다른 계정에 로그인합니다.
    2. 앱에서 사용할 페이지에 대한 메시지가 표시되면 페이지를 선택한 다음, 다음을 선택합니다.
    3. 로그인 검토 요청을 제출하라는 메시지가 표시되면 정보를 검토하고 완료를 선택합니다.
    4. 성공하면 사이트에 성공 페이지가 표시됩니다. 계속하려면 확인을 선택합니다.

  3. 이제 추가한 페이지가 페이지 목록에 표시됩니다.

    나중에 페이지 ID를 복사하고 저장합니다.

  4. 페이지에 대한 토큰 생성을 선택합니다.

    1. 사이트에서 보안 정보를 표시하고 토큰을 복사할 수 있는 기회를 제공합니다.
    2. 경고를 읽고 승인합니다.
    3. 토큰을 복사하고 완료를 선택합니다.

이제 다음 단계에 대한 앱 정보와 토큰이 있습니다. Facebook 설정 단계를 보류 상태로 둡니다. 나중에 업데이트합니다.

Azure에서 봇 구성

봇이 Facebook Messenger에 메시지 및 기타 이벤트를 보내도록 하려면 웹후크 통합을 사용하도록 설정합니다.

  1. 새 브라우저 창에서 Azure Portal로 이동합니다.
  2. 봇에 대한 Azure Bot 리소스 블레이드를 엽니다.
  3. 채널을 열고 Facebook을 선택합니다.
  4. Facebook 채널 구성에서 이전 단계에서 복사한 Facebook 정보를 입력합니다.
    1. Facebook 앱 ID 및 Facebook 앱 비밀을 입력합니다.
    2. 페이지 ID 및 액세스 토큰을 입력합니다.
    3. 생성된 콜백 URL을 복사하고 토큰 값을 확인합니다.
    4. 추가를 선택합니다.

팁

  • 이전 단계의 정보 복사본이 없는 경우 개발자용 메타 사이트에 대해 검색할 수 있습니다.
  • 필요한 경우 페이지에 대한 새 웹 토큰을 만듭니다. 지침은 페이지 추가 및 토큰 생성을 참조 하세요.

웹후크 사용

Facebook 설정으로 돌아가서 구성 프로세스를 완료합니다.

  1. 개발자용 메타 사이트에서 앱의 Messenger 설정 페이지로 돌아갑니다.
  2. 결과 창에서 웹후크 섹션까지 아래로 스크롤하고 콜백 URL 추가를 선택합니다.
  3. 콜백 URL 편집 페이지에서 다음을 수행합니다.
    1. 콜백 URL을 입력하고 Azure Portal에서 복사한 토큰 값을 확인합니다.
    2. 확인 및 저장을 선택합니다.
  4. 이제 추가한 페이지가 웹후크 아래의 페이지 목록에 표시됩니다.
  5. 페이지에 대한 구독 추가를 선택합니다.
    1. 페이지 구독 편집 페이지에서 다음 구독 필드를 선택합니다.
      • messages
      • messaging_postbacks
      • messaging_options
      • message_deliveries
    2. 저장을 선택합니다.
  6. 사이트에는 봇에 대한 페이지 옆에 추가된 구독 필드가 표시됩니다.

앱을 공개로 만들기

앱이 게시될 때까지 개발 모드로 전환됩니다. 플러그 인 및 API 기능은 관리자, 개발자 및 테스터에게만 작동합니다.

작성자(페이지 및 봇을 만든 Facebook 개발자 계정)만 봇 응답을 받을 수 있습니다. 일반 Facebook 사용자는 페이지 또는 봇을 볼 수 없습니다. 봇과 채팅할 수 있도록 개발 또는 테스트 역할을 대상 사용자에게 제공합니다.

테스터 역할에 추가할 사용자는 먼저 개발자용 Meta 사이트에 등록해야 합니다. 개발자용 메타 계정이 없는 Facebook 사용자는 테스터 역할을 사용할 수 없습니다. 앱 역할 및 테스트 사용자에 대한 자세한 내용은 개발자용 Meta 개발자 설명서를 참조 하세요.

검토를 위해 제출

Facebook에는 기본 앱 설정 페이지에 개인 정보 취급 방침 URL 및 서비스 약관 URL이 필요합니다. 행동 강령 페이지에는 개인 정보 취급 방침을 만드는 데 도움이 되는 타사 리소스 링크가 포함되어 있습니다. 사용 약관 페이지에는 적절한 서비스 약관 문서를 만드는 데 도움이 되는 샘플 용어가 포함되어 있습니다.

봇이 완료되면 Facebook은 Messenger에 게시된 앱에 대한 자체 검토 프로세스를 찾습니다. 봇은 Facebook 의 플랫폼 정책을 준수하는지 테스트합니다.

앱을 공개하고 페이지 게시

검토에 성공하면 앱 검토 아래의 앱 대시보드에서 앱을 공용으로 설정합니다. 이 봇과 연결된 Facebook 페이지가 게시되었는지 확인합니다. 페이지 설정에 상태가 표시됩니다.

API 버전 설정

Facebook에서 특정 버전의 Graph API 사용 중단에 대한 알림을 받는 경우:

  1. 개발자용 메타로 이동합니다.
  2. 봇에 대해 만든 앱으로 이동합니다.
  3. 설정 아래에서 고급을 선택합니다.
  4. 업그레이드 API 버전을 선택한 다음, 모든 호출을 버전 4.0으로 업그레이드합니다.

Facebook에서 봇 테스트 섹션에 설명된 단계에 따라 연결을 테스트합니다.

Facebook에서 봇 테스트

이제 새 Facebook 앱과 연결된 Facebook 페이지를 통해 메시지를 보내 봇이 Facebook에 올바르게 연결되었는지 테스트할 수 있습니다.

  1. Facebook으로 이동하여 페이지의 프로필로 전환합니다.
  2. 더 많은 작업(...)을 선택한 다음 , 작업 추가 단추를 선택합니다.
    1. 작업 사용자 지정 단추 대화 상자에서 [시도]를 선택하고 지침을 따릅니다.
    2. 사용자 연락처 가져오기의 작업 단추 페이지에서 메시지 보내기를 선택합니다.
    3. 다음을 선택하고 대화 상자를 완료하고 변경 내용을 저장합니다.
  3. 개인 프로필로 다시 전환합니다.
  4. 페이지로 이동하여 메시지를 선택하여 봇에 대한 연결을 테스트합니다.

이전 단계에서 설명한 것과 동일한 값으로 appsettings.json 파일을 채워 Facebook 어댑터용 샘플 봇을 사용하여 이 기능을 테스트할 수도 있습니다.

추가 정보

Facebook Messenger 통신을 지원하는 샘플 봇은 Bot Framework C# Facebook 이벤트 샘플을 참조하세요.

Facebook Messenger 설명서는 다음을 참조하세요.

Facebook Workplace 설명서는 다음을 참조하세요.