Facebook Messenger - Instant Messaging

The integration with Facebook Messenger allows you to send messages via Facebook Messenger.

Before you begin

Before you can set up integration with Blueshift, you must have your Facebook Messenger developer account set up.

A Facebook developer account is required to use this integration.

Set up your Facebook Messenger account

Complete the following steps to set up your Facebook Messenger developer account:

  1. Set up your Facebook app by following the steps provided here: https://developers.facebook.com/docs/messenger-platform/getting-started/app-setup
  2. Once the app is set up, you can access the Page access token by following the instructions here: https://developers.facebook.com/docs/facebook-login/access-tokens/#pagetokens
  3. Use the Page access token in the API endpoint using which data is sent to Facebook Messenger. The API endpoint to use is:

    For example, if the page access token is “ACJA456ASDHJADJ456AFS7BA”, then the “API Endpoint” will be “https://graph.facebook.com/v2.6/me/messages?access_token=ACJA456ASDHJADJ456AFS7BA

For more information about the Facebook Messenger API, see https://developers.facebook.com/docs/messenger-platform/reference/send-api/#example_request

Set up integration

To add a Facebook Messenger adapter in Blueshift, complete the following steps:

  1. Sign in to the Blueshift app, and click Apps in the left navigation menu.
  2. Go to All Apps, search for, and select Facebook Messenger.
  3. You can also go to Instant Messaging Apps and select Facebook Messenger.
  4. Click Configure to view all the configured adapters.
  5. Click +ADAPTER to add an adapter.
  6. Add a Name for the adapter.  If you have multiple adapters, the adapter name helps you to identify the integration.
  7. Add information for any Additional Headers.


  8. Click Save to add the adapter.

    The adapter is now added and you can use it in your Cloud App template.

Next steps

  1. Create a Salesforce cloud app template to send a payload from a campaign.
  2. In your campaign journey, add a Salesforce trigger. Select the template that you created.

Create a Facebook Messenger cloud app template

A Cloud App template is required to send a payload to Facebook Messenger from a campaign.

To add a Facebook Messenger Cloud App template, complete the following steps:

  1. Go to Creatives > Cloud App.
  2. Click +TEMPLATES on the Cloud App Templates page.
  3. Select the Facebook Messenger app.

    Note: Only apps that support Cloud Apps templates and have atleast one adapter configured are displayed on the Cloud App Templates page.

  4. Configure the template including the name, tags and other relevant information. For more information, see Cloud Apps templates.


    Field Description
    Template Name Specify a name for the template to identify it on the index screen. 
    API Endpoint Specify the API endpoint that receives the request that is made by the Blueshift app.

    See step 3 from the Set up your Facebook Messenger account section.

    Adapter Select the adapter to use to send the payload.

    Specify tags to organize this template.

    Since this template is a Blueshift resource that you use in campaigns, you can use tagging to organize it under folders.

    For more information on this, see Tagging.

  5. It is recommended that you set the Unique Sent Identifier under Show Advanced Settings to the user attribute you use to identify the recipient. For example, if you are using “phone_number” as the recipient attribute in the Content tab, set the “Unique Sent Identifier” to “phone_number”.
  6. On the Content tab, fill the form to specify the data and the format in which to send the data to Salesforce.

    You can also switch to JSON and specify the content in JSON format. However, once you switch to JSON, you cannot use the form layout again.


Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.