• Genesys Cloud CX 2, Genesys Cloud CX 2 Digital, Genesys Cloud CX 3, Genesys Cloud CX 3 Digital, or Genesys Cloud CX 1 Digital Add-on II license
  • Existing customers who have one of the above licenses prior to June 7, 2023: To enable Instagram Direct Messaging in Genesys Cloud, follow these steps:
  • Messaging > conversationInstagramIntegration > All permission
  • Published Facebook business page
  • A professional Instagram account. For information, see How to set up a business account in the Instagram Help Center.
  • Your Instagram professional account linked to your Facebook business page. For more information, see Connect or disconnect an Instagram account to your Facebook in the Meta Business Help Center.

Make sure that you perform the prerequisites in order. First, publish your Facebook business page. Next, configure your professional Instagram account. Finally, link your Instagram professional account to your Facebook business page. If an Instagram account is connected to the Facebook page while the Instagram account is still a personal account, and if the Instagram account changes to a professional account, ensure that you review your Facebook page settings and confirm the switch to a professional account from a personal account. The integration cannot be successfully added to Genesys Cloud until it is reviewed.

The Genesys Cloud for Instagram Direct Messaging integration provides a way for your customers to send messages to your Instagram business account. These customers can use Instagram Direct Messaging to interact with your agents who use Genesys Cloud ACD messaging channels. To connect the Genesys Cloud for Instagram Direct Messaging integration to your Facebook business page, log in to Facebook through Genesys Cloud and configure a few settings.

To set up your Genesys Cloud for Instagram Direct Messaging integration:

  1. Click Admin.
  2. Under Message, click Platforms.
  3. Click Create New Integration.
  4. Click the Instagram Direct tile.
  5. Click Instagram Login.
  6. When you see the Facebook login dialog box, select your account or enter your credentials and then log in.
    Note: If you have not already linked your Instagram business account with your Facebook business page, a message prompts you to connect them. When you log in to Facebook, Genesys Cloud creates its own session and automatically retrieves any Facebook pages that you own. When you create more Instagram Direct Messaging integrations, you must select all of your Facebook pages that integrate with Genesys Cloud, not just the most recently-added one.
    After you log in to Facebook, two boxes appear in the Instagram Direct page.
  7. In the Name box, type a name that you want to assign to your Instagram Direct Messaging integration.
  8. In the Page Name box, select the Facebook business page to which you want to connect the Instagram Direct Messaging integration.
  9. Click Save.
  10. In the Supported Content list, select a supported content profile. If you do not select a supported content profile, the integration uses the default content profile.
  11. Click Save again.

For more information about Platform Configuration profiles, see Platform configuration profiles overview. For more information on how to create and assign configuration profiles, see Create and assign a configuration.

  • After you complete the integration, the Save button changes to a Delete button. Use this button to remove the integration.
  • You can connect one page only to a Genesys Cloud for Instagram Direct Messaging integration. If you want to connect more than one page, create an instance of the Genesys Cloud for Instagram Direct Messaging integration for each page.
  • When you begin to use your Genesys Cloud for Instagram Direct Messaging integration, keep in mind that you must respond to Instagram Direct messages within seven days. After seven days, any messages you attempt to send in response result in an error and are not delivered.
  • Instagram only delivers story mentions from a private Instagram account if your account follows the private account.

After a working Instagram Direct Messaging integration is in place and you configure ACD messaging for Instagram Direct Messaging, then you can configure message flows in Architect

  • If you navigate away from this page or click Save, Delete, or Cancel, Genesys Cloud automatically logs you out of the current Facebook session. 
  • If you create an Instagram Direct Messaging integration and then later change your Facebook account password, you sever the connection between your integration and Instagram Direct Messaging. To re-establish the connection, delete and recreate your Instagram Direct Messaging integration. 
  • If you delete your Instagram Direct Messaging integration, you cannot respond to messages still on the left side in the queue. 


  • Instagram prohibits storage of ephemeral images, videos, or other media contained in an Instagram story mention. This prohibition applies to any Facebook CDN URLs, ephemeral contact made available by any such URLs, and the creation of screen recordings of such media.  
    • Do not use Genesys screen recording or other recording tools to capture Instagram story mention media content.
    • Genesys does not persist ephemeral Instagram story mention content in any conversation or message transcripts, and ephemeral content may be unavailable for quality management review or for any future purpose or feature. 
  • The Instagram mobile and desktop apps allow Instagram users to unsend direct messages. Genesys deletes any messages that users unsend, and those messages may not be available as part of the interaction history.