Getting started (Interactions API)

Before you start using the Interactions API you must complete the following tasks:

• Sign up for a Vonage Contact Center (VCC) account. If you have not already done so, find more information on how to do this at Vonage | Cloud Contact Center.
• Set up one or more named routes with interaction plans using VCC’s Interaction Architect. You can use the Interactions API to invoke these named routes and interaction plans. For information about setting up named routes and interaction plans and using VCC to make and receive interactions, go to Vonage Contact Center Product Documentation.
• Get your client credentials (client ID and client secret) within the VCC Admin Portal. For information about generating your client credentials, see Getting your client credentials from Vonage Contact Center.
• Use your client credentials to generate your bearer access token. You must use your bearer access token to send API requests. The Getting a bearer access token section contains information about getting your bearer access token.

The root URL for the Interactions API is is https://***.api.newvoicemedia.com/interactions, where *** represents a regional subdomain.

Add the action name to the URL to form the endpoint you need to access the action and its fields. For example, https://***.api.newvoicemedia.com/interactions/Invoke enables you to invoke an interaction flow, or release an existing interaction. The URL https://***.api.newvoicemedia.com/interactions/Register enables you to register a provider.