Messenger Platform - facebook for developers

Messenger Platform - facebook for developers

• Setup

  For this integration, you will need the following:
  통합을 위해서 다음이 필요.

  Facebook App: The Facebook App contains the settings. This is where you will setup your webhook, retrieve your page access token and submit your app for approval.
  페이스북 앱: 페이스북 앱 설정이 포합되어 있다. webhook 설정, 토큰 페이지 액세스를 검색, 승인을 위해 당신의 앱을 제출하라.

  Facebook Page: A Facebook Page will be used as the identity of your bot. When people chat with your bot, they will see the Page name and the Page profile pic.
  페이스북 페이지: 로봇 ID로 사용됩니다. 로봇과 대화를 나눌 때, 페이지의 이름과 페이지 프로필 그림을 볼 수 있습니다.

  Webhook URL: We use secure callbacks in order to send you messaging events. These will be sent to your webhook.
  웹후크 URL:우리는 당신에게 메시지 이벤트를 전송하기 위해 보안 콜백을 사용하며, 당신의 webhook로 전송됩니다.

• Create an App and a Page
  페이지와 앱 만들기

  Create a Facebook App and Page or use existing ones.
  페이스 북 앱 및 페이지를 만들거나 기존것을 사용합니다.

  Go to your app settings and under "Product Settings" add a product. Select "Messenger."
  제품을 추가 "제품 설정"앱 설정 및 아래로 이동합니다. "메신저"를 선택합니다.

  

  
  

• Setup a Webhook
  웹후크 설정

  Webhooks are used to send you a variety of different events including messages, authentication events and callback events from messages.
  Webhooks는 당신에게 메시지의 메시지, 인증 이벤트 및 콜백 이벤트를 포함하여 다양한 이벤트를 전송하는 데 사용됩니다.

  In the Messenger Platform tab, find the Webhooks section and click Setup Webhooks. Enter a URL for a webhook, define a Verify Token and select message_deliveries, messages, messaging_optins, and messaging_postbacks under Subscription Fields.
  webhook의 URL을 입력, 서브 스크립 션 필드에서 토큰을 선택 message_deliveries, 메시지, messaging_optins 및 messaging_postbacks을 확인 정의합니다.

  

  
  

  At your webhook URL, add code for verification. Your code should expect the Verify Token you previously defined, and respond with the challenge sent back in the verification request. Click the "Verify and Save" button in the New Page Subscription to call your webhook with a GET request.
  당신은 webhook URL에서 확인을 위해 코드를 추가합니다. 당신의 코드는 이전에 정의 된 토큰을 확인하고 검증 요청에 다시 전송 과제로 응답 기대한다. GET 요청하여은 webhook를 호출하는 새 페이지 구독에서 "확인하고 저장하기"버튼을 클릭하세요.

• Example (Node.js)

  app.get('/webhook', function (req, res) {
    if (req.query['hub.verify_token'] === 'YOUR_VERIFY_TOKEN') {
      res.send(req.query['hub.challenge']);
    } else {
      res.send('Error, wrong validation token');    
    }
  });

Read more details on these fields in the Webhook Reference for Messenger.
메신저 용으로 webhook 참조에 이러한 필드에 대한 자세한 내용을 읽어 보시기 바랍니다.

• Get a Page Access Token
  페이지 액세스 토큰을 가져 오기

  A Page Access Token is based on an app, page and user and has scopes associated with it. In the developer app, go to the Messenger tab. Select your page and generate a token:
  페이지 액세스 토큰은 앱 페이지와 사용자를 기반으로하며 그와 관련된 범위를 가지고있다. 개발자 앱에서 메신저 탭으로 이동합니다. 페이지를 선택하고 토큰을 생성 :

  

  
  

  This will generate a Page Access Token with the manage_pages, pages_messaging, and pages_messaging_phone_number scopes. Save this token as it will be used throughout your integration. You must be an admin on the page in order to generate a valid page access token.
  이것은 manage_pages, pages_messaging 및 pages_messaging_phone_number scopes와 페이지 액세스 토큰을 생성합니다. 그것은 당신의 통합 전반에 걸쳐 사용되는 바와 같이,이 토큰을 저장합니다. 유효한 페이지 액세스 토큰을 생성하기 위해 페이지에서 관리해야한다.

  These tokens are non-expiring. However, in rare cases, they may be invalidated. Read about debugging and error handling for these cases. You can also read more general details about page access tokens.
  이 토큰은 만료되지 않습니다. 그러나, 드문 경우에, 무효화 될 수 있다. 이러한 경우에 대한 디버깅과 오류 처리에 대해 읽어보십시오. 또한 페이지 액세스 토큰에 대한 일반적인 정보를 읽을 수 있습니다.

• Subscribe the App to a Page
  페이지에서 앱을 구독

  In order for your webhook to receive events for a specific page, you must subscribe your app to the page. You can do this in the Webhooks section under the Messenger Tab.
  webhook 특정 페이지에 대한 이벤트를 수신하기 위해서는, 당신은 페이지에 앱을 등록해야합니다. 당신은 메신저 탭에서 Webhooks 섹션에서이 작업을 수행 할 수 있습니다.

  

  
  

  Or you can do this via API by using your Page Access Token and making a POST request to https://graph.facebook.com/v2.6/me/subscribed_apps.
  또는 당신은 당신의 페이지 액세스 토큰을 사용 https://graph.facebook.com/v2.6/me/subscribed_apps에 POST 요청을하여 API를 통해이 작업을 수행 할 수 있습니다.

    curl -X POST "https://graph.facebook.com/v2.6/me/subscribed_apps?access_token=PAGE_ACCESS_TOKEN"    
  

  If successful, you will receive a response:
  성공하면, 당신은 응답을받을 것입니다 :

    {
        "success": true
    }
  

• Test your Bot
  봇 테스트

  At this point in the setup you should have:
  현 시점에서 시점에서 해야 할 설정.

    1. Created an App and a Page
        앱과 페이지를 생성
    2. Setup a Webhook
        webhook 설정
    3. Generated a Page Access Token
        페이지 액세스 토큰 생성
    4. Subscribed your App to your Page
        당신의 페이지에 앱을 구독
    5. Once you have completed these steps your're then ready to test your integration can receive messages sent to your Page.
        이 단계를 완료하면 END_LINK하면 관심은 준비가 당신의 통합이 페이지에 보낸 메시지를받을 수 있습니다 테스트합니다.
  

  To test you're receiving updates via the Webhook simply send a message to your page either from facebook.com, the facebook mobile app or using your Messenger short url https://m.me/PAGE_USERNAME.
  당신은 단순히 어느 페이스 북 모바일 앱, facebook.com에서 페이지에 메시지를 보내으로 webhook를 통해 업데이트를 수신하거나 메신저 짧은 URL을 https://m.me/PAGE_USERNAME를 사용하고 테스트합니다.

  If you fail to receive an update via your Webhook, please ensure you didn't receive any errors when you setup your Webhook and you subscribed your App to your page.
  당신은 webhook를 통해 업데이 트를 수신하지 못할 경우, 당신은 webhook 당신이 당신의 페이지에 앱을 등록 할 때 설정이 오류를받지 못한 확인하시기 바랍니다.

• Developer's Note 개발 노트

    When your app is in Development Mode, plugin and API functionality will only work for admins, developers and testers of the app. After your app is approved and public, it will work for the general public.
    앱이 개발 모드에있을 때, 플러그인 및 API 기능은 관리자, 개발자 및 응용 프로그램의 테스터 작동합니다. 앱이 승인 된 공공 후에는 일반 대중을 위해 작동합니다.