API Explorers

Restriction: This feature or information is available to Medallia employees only and it is not to be shared outside the company.

The API Explorers page provides quick access to several common APIs used by super admins for troubleshooting interactions. On this page, you can submit requests to the Genesys Cloud, Salesforce, or Twilio Flex APIs without the need to configure Postman or construct cURL requests. Several common use cases (endpoints) are pre-configured, and you can customize the request body as needed.

screenshot of the A.P.I. explorers page

Submitting API Requests

Each tab contains the same configurable settings:

  • Method: Select GET or POST, depending on the specific request you will submit.
  • API URL: Click within this field to select one of the pre-populated common endpoints, or enter the details of an endpoint into the field.
    • The pre-populated endpoints represent common use cases in the Genesys Cloud and Twilio Flex tabs, but are not present in the Salesforce tab.
  • Customer: Select the Feedback Organization that applies to the request.
    • You are authenticating as the selected client, making requests to the relevant third-party API. This works because we already have clients' authentication credentials to integrate with these platforms.
  • Include JSON Body: Use this field to append a custom JSON body to the request, if needed.
    • A custom JSON body lets you add optional parameters to refine your request, based on your specific goal.
  • Results panel: After submitting a request, the response will be displayed in this panel.

With the configuration in place, click Submit to send a request. You will see the response in the results panel below, even for failed requests, just as you would expect in an API testing environment.

Note: The most common request is the GET /convos/convoID endpoint for Genesys Cloud. This requests full details of a specific Genesys conversation, based on the Conversation ID. As a starting point, you can find a Genesys Conversation ID in the Interaction Details for a particular interaction (Interaction UUID).