Webex Engage Nodes and Node Authorizations

Understand the various engage nodes and node authorizations in Cisco Contact Center Enterprise integration.

Webex Connect offers the following Webex Engage nodes for Cisco Contact Center Enterprise integration. The node authorization configuration details are available in the next section.

Node and Methods

Node NameDescriptionMethodsRecommended Node Version
Search ConversationCalls Webex Engage Conversation Search API to search for an existing conversation using the customer identifierSearch Conversationv1.1
Append MessageCalls Webex Engage Append Conversation API to append a message to an existing conversationAppend Messagev1.0 and v1.3
Create ConversationCalls Webex Engage Create Conversation API to create a new conversation on imiengage with the channel and customer detailsCreate Conversationv1.0 and v1.2
Update ConversationCalls Webex Engage Update Conversation API to update a new conversation on imiengage with the channel and customer detailsUpdate Conversationv1.0
Add ParticipantCalls Webex Engage API to add a participant to a conversationAdd Participantv1.0
Remove ParticipantCalls Webex Engage API to remove a participant from a conversationRemove Participantv1.0
Close conversationCalls Webex Engage API to close the conversationClose conversationv1.0
Re-open ConversationCalls Webex Engage Update Conversation API to Re-open and queue a conversation which is in closed stateRe-open Conversationv1.0

Node Authorization

Client applications (in this case Webex Connect ) are required to provide a valid access token for using various Webex Engage APIs. The access token is generated using the authorization details configured within the ‘Node Runtime Authorization’ field that Cisco Contact Center Enterprise users are required to provide during flow configuration.

Node Authorization for Webex Engage nodes

Webex Engage nodes (Search Conversation, Create Conversation, Append Conversation, Re-open Conversation, Add Participant, Remove Participant, Close Conversation).

To authorize a pre-built integration:

  1. Go to Assets > Integrations.
  2. Select Pre-built Integrations under Integration Type, to display the list of all pre-built integrations.
    The integrations which are not yet authorized show the status as Pending Authorization.
1918
  1. Click Actions → Manage associated with the integration you want to authorize.
  2. On the Manage Integrations page, scroll down to the Node Authorizations section. This section lists all the authorizations mapped to this integration.
1899

📘

Note

If the integration nodes have no auth required, then it is not shown in the list.

  1. Click Action → Add Authorization associated with the authorization, where Auth Type is oauth2 and Status is Authorization Pending.
1244
  1. Enter the Authorization Name
  2. Click Authorize.
    A pop-up appears.
  3. Enter your Cisco email address and click Sign in.
1580

The status of the authorization will change to Authorized and all the nodes under this authorization are authorized and ready for use.
Once authorized, you can perform the following actions on the authorization.

  • View - allows you to view the authorization.
  • Update - allows you to update the authorization details.
  • Make it as default - allows you to make a particular authorization default for that node.
  • Remove - allows you to delete the authorization.

📘

Note

If an OAuth 2.0 type authorization is edited in the Admin portal, you will be prompted to re-authorize the authorization.

You are not allowed to delete the authorization if it is mapped/used in flow assets.