ServiceNow HTTP(S) data dip flow template
Overview
This flow integrates Webex Contact Center with ServiceNow using an HTTP connector to route decisions and retrieve incident details through ServiceNow’s REST APIs. It handles inbound voice calls, performs an ANI lookup, fetches relevant information, and delivers personalized service. The process flow is as follows:
- A call is received by Webex Contact Center.
- A welcome message is played to the caller, mentioning their incident details.
- The system performs a lookup in ServiceNow using the ANI to fetch the caller's
sys_id
to get the caller's object identifier on ServiceNow. - Based on the
sys_id
, the system looks up the active incident for the caller. - The incident number is played back to the caller.
- The call is queued for the next available agent, prioritized based on incident severity.
- Hold music is played while the caller waits in the queue.
- Once the call is connected to an agent, the incident information is displayed on the agent's desktop.
- Post-call, Webex Contact Center posts call information back to the relevant incident in ServiceNow.
Prerequisites
Before configuring this flow, ensure the following:
- OAuth2 setup: Configure OAuth2 in ServiceNow and Webex Contact Center, following the video tutorial.
- Admin setup: Log in to admin.webex.com and configure the connector. Go to . Enter the necessary credentials as outlined in the video tutorial.
Use case example
This example integration demonstrates how Webex Contact Center can enhance customer experience through personalized interactions, while leveraging ServiceNow for ANI lookups and incident management:
- Inbound call: Customer calls into Webex Contact Center.
- ANI lookup: Webex performs an ANI lookup in ServiceNow to identify the caller.
- Incident lookup: ServiceNow retrieves the associated Incident ID based on the caller's details.
- Personalized greeting: Customer is greeted with a personalized message, referencing their active incident.
- Routing and prioritization: Calls are routed based on the incident's severity, ensuring critical issues are addressed first.
- Agent assignment: The call is routed to an available agent, with incident details displayed on the agent's desktop.
- Post-call updates: Webex Contact Center posts relevant call information, including call identifiers, to ServiceNow using event flows.
Flow activities
The following table describes the activities used in the flow and their role in the integration.
Flow activity |
Description |
---|---|
Start (New Phone Contact) |
The flow begins when an inbound call is received. |
Play message (Greeting) |
Plays a welcome message using Cisco Cloud Text-to-Speech, such as: Welcome to
ServiceNow demo. Your incident number is:
|
Set variable (Digit Strip ANI) |
Strips the international code (+1) from the ANI for exact matching. |
Set variable (Format ANI) |
Formats the ANI into ServiceNow's required format for queries: (123) 456-7890. |
HTTP request (Lookup User) | Looks up the user’s sys_id in ServiceNow using their
ANI. |
HTTP request (Lookup Incident) | Uses the sys_id to retrieve the caller's active incident from
ServiceNow. |
Play message (Incident Number) | Announces the incident number to the caller using Text-to-Speech. |
Queue contact (Queue to agent) | Places the caller in the queue for the next available agent, based on incident severity. |
Play music (Hold music) | Plays hold music while the caller is in the queue. |
Post call (Post Comments to ServiceNow) | Posts the call information, including the incident number, back to ServiceNow once the call ends. |
Additional resources
To explore and test the REST APIs, you can import the ServiceNow API Postman collection
(ServiceNow API Collection.postman_collection.json
) into Postman. This
helps in understanding which APIs are available and how they interact with Webex Contact
Center.
- ServiceNow REST API documentation: REST API docs
- ServiceNow table API documentation: Table API docs
For more information on Webex Contact Center flows, see Webex Contact Center setup and administration guide.