Supported content profiles

Prerequisites:
  • Genesys Cloud User 3, Genesys Cloud User 1 Digital Upgrade II, or Genesys Cloud User 2 Digital Upgrade I
  • messaging > supportedContent > Add, Delete, Edit, and View

Supported content profiles identify the media types that agents and customers can send through third-party messaging and open messaging. These media types include audio, video, images, text, applications, advanced and user-defined types. You can configure a content profile for each messaging channel and for inbound and outbound attachments. A messaging channel integration indicates the content profile to use. For more information, see the configuration procedure for your messaging channel.

Genesys Cloud provides a default content profile that allows all inbound file types and .jpg, .png, and .gif for outbound file types. The default content profile applies if you do not assign a content profile to a messaging channel integration. To manage the default content profile:

  • You can change the file types allowed in the default content profile provided by Genesys Cloud.
  • You can set a different content profile as the default by clicking the star next to the content profile name. If you set a new content profile as the default, the new default applies only to new messaging channel integrations. The new default content profile is not associated with existing messaging channel integrations.
  • You cannot delete the default content profile. To delete the current organization default profile, first set another content profile as the default. 

Genesys Cloud permits sending and receiving attachments up to 25 MB. The third-party messaging platform you are using can have different file size restrictions. The maximum file size a messaging platform allows can depend on the media type being attached. Refer to the third-party messaging platform documentation for allowed maximum file sizes.

The Supported Content Profiles view displays the most common media types. If you want to add types not listed in this view, use the API. Supported content profiles can contain any valid media type string for inbound and outbound attachments. For more information about example media types, see Media Types on the Internet Assigned Numbers Authority (IANA) website. The API can also use strings with the asterisk (*) wildcard character, such as “image/*” to allow all image types or “*/*” to allow all media types. Caution: Allowing all media types increases your risk of receiving unwanted or malicious files. For more information about using the API, see API Resources for supported content in the Genesys Cloud Developer Center under Conversations > Messaging.

Configure a supported content profile

  1. Click Admin.
  2. Under Message, select Supported Content Profiles.
  3. Click New Content Profile.
  4. Enter a name for the content profile.
  5. Click Add File Types.
  6. In the Add Inbound File Types pane, select the file types to allow. Select a category in the View list. Or, to filter the file types, start typing in the search box. You can select all or select individual files types. A check mark appears next to a selected type.
  7. Click Add Inbound Files. The selected file types appear in the Inbound tab.
  8. Click the Outbound tab. In the Add Outbound File Types pane, select the file types to allow. Select a category in the View list. Or, to filter the file types, start typing in the search box. You can select all or select individual files types. Select all or select individual files types. A check mark appears next to a selected type.
  9. Click Add Outbound Files. The selected file types appear in the Outbound tab.
  10. Click Create.
Note: After creating a supported content profile, assign the content profile on your messaging channel integration. If you do not assign a content profile, the integration assigns your current default support content profile.

Test a supported content profile

Messaging channels differ in the media types they support. Test that the supported content profile you are using matches the messaging channel’s allowed media types.

Notes:
  • For third-party messaging platforms, such as Facebook, Messenger, Twitter, LINE, and WhatsApp, Genesys Cloud can further restrict the supported files types that you configure in your supported content profile. Test all types of files you want to support for both inbound and outbound on each messaging platform you use. Examples of supported file name extensions include:
    • aac, 3g2, 3gp, 7z, aac, amr, avi, bmp, csv, doc, docx, eml, gif, heic, ics, jfif, jpeg, jpg, key, log, m4a, m4v, mov, mp3, mp4, mp4a, mpeg, mpg, mpga, neon, numbers, odt, oga, ogg, ogv, pages, pdf, png, pps, ppsx, ppt, pptx, qt, svg, tif, tiff, txt, vcf, wav, webm, webp, wmv, xls, xlsx, xml, yml, yaml, webp, zip
  • Some third-party messaging platforms can convert a file, such as an image, from one media type to another. For example, a third-party messaging platform converts a large animated .gif file to an .mp4 video file, or a .png to .jpg, to make the file size smaller. A third-party message platform can also convert a file depending on the client that sends the file, such as a web app vs. the mobile app. For the file types you want to send and receive, test how the third-party message platform handles the file types and adjust your supported media types accordingly. Consider supporting related types together for third-party platforms, such as .gif, .jpg, .png, and .mp4.