Add a webhook integration

Prerequisites:

  • Integrations > Integration permission assigned to any Genesys Cloud user role or Genesys Cloud admin role.
  • You must be a member of owners-only or members-only Genesys Cloud groups to administer chat notifications (webhooks) to those groups. Ask the owners of those groups to add you as a member and then remove you when the configuration is completed. Note: You can administer notifications to public groups without being a member.

A chat notification (webhook) configuration in Genesys Cloud consists of a series of mappings. Each mapping specifies:

  • Filters that define an event
  • Chat groups to receive the notifications
Recommendation:  Keep the conditions for initiating a notification as narrow as possible while still being useful. When too many notifications fill up group chat feeds, you risk people beginning to regard it as noise.
  1. Click Admin.
  2. Under Integrations, click Integrations.
  3. At the top right, click Integrations.
  4. Find the chat notifications integration that you want to add and click Install. 
  5. Click the Mappings tab.
  6. Click New Mapping.

  7. Specify notification settings for the mapping:

    For this… Do this…
    Name Give the mapping a name.
    Chat Targets

    Specify which chat groups should receive the notifications:

    1. Begin typing a group name and click to add it.
    2. Continue adding as many groups as needed.
    Filters

    Specify one or more events to send notifications about:

    1. Specify the filter type by selecting from the Select a Filter drop-down menu.
    2. In the Value field, enter the matching value that triggers a notification. Matching is exact.
    3. Add more filters to narrow the scope of the notifications by clicking Add Filter.
  8. Click Save.
  9. Add more mappings as needed. Click New Mapping and repeat the previous steps. 
  10. Click the Details tab and copy the URL(s). This URL is required to complete the chat notifications integration setup.

  11. Click Configuration documentation to open the Resource Center article for the selected chat notification integration.

  12. Follow the steps to complete the setup. 

Troubleshooting