Get Started – Send a Message with Messenger Platform

• The pages_show_list permission and a User access token, requested by you. This allows your app, or the Graph API Explorer, to get your Page ID.
• The pages_messaging permission and a Page access token, requested by a person who can perform the MESSAGING task on your Page, allows your app to get the conversation ID and your Page-scoped ID (PSID)

• Facebook Login in your app
• The App Dashboard in Messenger > Settings
• The Graph API Explorer, (shown below)

curl -i -X GET "https://graph.facebook.com/<API_VERSION>/me/accounts
    ?access_token=<USER_ACCESS_TOKEN>"

{
  "data": [
    {
      "access_token": "EAABkWcj...",    // PAGE-ACCESS-TOKEN
      "category": "Pet Service",
      "category_list": [
        {
          "id": "144982405562750",
          "name": "Pet Service"
        }
      ],
      "name": "Cisco Dog Page",
      "id": "4225...",                   // PAGE-ID
      "tasks": [
        "ADVERTISE",
        "ANALYZE",
        "CREATE_CONTENT",
        "MESSAGING",
        "MODERATE",
        "MANAGE"
      ]
    }
  ]
}

curl -i -X GET "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/conversations?fields=participants,messages{id,message}&access_token=<PAGE_ACCESS_TOKEN>"

{
  "data": [
    {
      "participants": {
        "data": [
          {
            "name": "CUSTOMER-NAME",
            "email": "PSID@facebook.com",
            "id": "PSID"
          },
          {
            "name": "PAGE-NAME",
            "email": "PAGE-ID@facebook.com",
            "id": "PAGE-ID"
          }
        ]
      },
      "messages": {
        "data": [
          {
            "id": "m_MeS2...",   // Message ID
            "message": "hello"
          },
          {
            "id": "m_Nl1...",    // Message ID
            "message": "CUSTOMER-NAME"
          }
        ]
      },
      "id": "t_10224..."        // Conversation ID
    }
  ]
}

curl -X POST "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/messages" \
    -d "recipient={'id':'<PSID>'}" \
    -d "messaging_type=RESPONSE" \
    -d "message={'text':'You did it!'}" \
    -d "access_token=<PAGE_ACCESS_TOKEN>"

{
  "recipient_id": "1008...",    // The customer's PSID
  "message_id": "m_AG5Hz2..."}  // The message ID

1. Replace the Query String Field string with either me/accounts or /<USER_ID>/accounts. If you ran the default query, you can click the ID in the response and it will automatically be moved to the Query String Field.
2. Go the Add a permission dropdown menu in the right side panel and select the pages_show_list permission then click Generate Access Token.
3. The popup window allows you to agree that the app can access the list of your Pages.
4. Click Submit to run the query.

1. Click the Page ID in the response to move it to the Query String Field and add /conversations?fields=participants,messages{id,message} to the query.
2. Go to the Add a Permission dropdown menu and select the pages_messaging permission then click Generate Access Token.
3. Another popup window will ask you to agree that the app can access the conversations of your Pages.
4. Click Submit to run the query.
5. Copy the Page ID and PSID for Step 3.

1. In the Response Window, click the message ID for the message you want to reply to.
2. In the upper left, switch the method from GET to POST.
3. In the Node Field Viewer to the left of the Response Window, click the + Add parameter under the Params tab. Add the following:
   • recipient set to {id:<PSID>}
   • messaging_type set to RESPONSE
   • message set to {text:'Hello, new customer!'}
4. Click Submit.

• Attach Media Assets to your Message
• Send a customer a message after the 24-hour messaging window
• Create a Message Template

• Graph API
• Graph API Explorer Tool
• Page Access Tokens
• Page Permissions and Tasks
• Page/Messages Reference

• Use the Meta Status tool⁠ to check for the status and outages of Meta business products.
• Use the Meta Developer Support tool to report bugs and view reported bugs, get help with Ads or Business Manager, and more.