Cisco Webex is an app-centric, cloud-based service that provides a complete collaboration suite for teams to create, meet, message, call, care, white board, and share, regardless of whether they’re together or apart—in one continuous workstream before, during, and after meetings. It is built to help teams work seamlessly. It is simple, secure, complete, and open, and provides a space for people to work better. The core capabilities of Cisco Webex are Meetings, Messaging, and Calling. The Cisco Webex platform, app-centric design, hybrid services, and architecture of Cisco Webex create a unique and differentiated service. For more information on the solution, refer to Cisco Webex.
Cisco Webex Meetings provides a Messaging API that VFC is able to use to retrieve content from Webex Rooms.
The Webex Import Source uses the Webex Messaging API to list and download available recordings, query and add participants prior to ingest.
Separate recordings are created for each recorded Webex user. Each recording contains details of all meeting participants.
For a general description of Verba Import sources, please refer to Import sources.
...
To create a Webex integration, a Webex account backed by Cisco Webex Common Identity (CI) is required. If no Webex account is available, sign up. If you're using Webex Meetings, your site will must be on Common Identity.. Typically, the user creating the API Integration needs to be the Compliance Officer on Webex. Navigate to https://developer.webex.com/my-apps and press the Create a new app button.
...
Press the Create an integration button to create an OAuth Integration.
...
Configuration Item | Description | Value |
|---|---|---|
| Mobile SDK | (Webex iOS or Android SDK 3. |
...
| 0+) | No | |
| Integration Name | Name of your integration as it will appear in Webex. | VFC WebEx Meetings Ingestion |
...
| Icon | Upload your own or select from our defaults. Must be exactly 512x512px in JPEG or PNG format. | Use VFC Logo provided. |
| App Hub Description | What does your app do, how does it benefit users, how do users get started? Does your app require a non-Webex account? If your app is not free or has additional features for paid users, please note that and link to pricing information. 1024 character limit. | VFC WebEx Meetings Ingestion. (Note the application will not be shared on the app hub at present.) |
...
| Redirect URI(s) | One or more URIs that a user will be redirected to when completing an OAuth grant flow. |
...
VFC Hostname |
...
is the name of the VFC server |
...
VFC Port |
...
is the port opened in the customer firewall for Webex access. | |
| Scopes | Select the following 3 scopes:
|
...
|
...
|
...
Creating an ACR import source
...
Configuration Item | Description |
|---|---|
| Name | Name your Import Source. This name will identify the source across the system. |
| Type | Select ACR |
| ACR Hostname or IP Address | Mandatory Name of ACR CRS (Central Replay Server) |
| ACR Port | Mandatory Port Number of ACR CRS (Central Replay Server) |
| TLS Certificate File or Thumbprint | Optional certificate file / certificate thumbprint used for the ACR connection. |
| TLS Key File | Optional file system location where the certificate key is stored. |
| TLS Key Password | Specify the password for the file that contains the certificate keys. |
| TLS Trust List | Certificate chain (or Chain of Trust) is made up of a list of certificates that start from a server's certificate and terminate with the root certificate. If your server's certificate is to be trusted, its signature has to be traceable back to its root CA. |
| ACR API User | Mandatory ACR user that must be created with API permission before this Import Source is used. |
| ACR API Password | Mandatory ACR user password that is set the first time the Import Source is used. N.B. The ACR API user must not have a password set when it is created, instead the import source ACR API Password will be set and used automatically. |
| ACR Layout Name | Mandatory ACR search layout name created before this Import Souce is used. |
| ACR Timezone | Mandatory. Set to the timezone of the ACR CRS, in case it is in a different timezone from the ingesting VFC server. |
| Recording Import Batch Size (minutes) | Mandatory. Every time the Import Source is run by the Data Management Policy, it attempts to retrieve ACR recordings within this time range, progressing the batch via the recording start and end timestamp. While a larger batch size retrieves more records, it must not exceed the duration of the timeslot available for processing. |
| Recording Start Timestamp | Mandatory. Start timestamp of the first ACR recording to be migrated. |
| Recording End Timestamp | Mandatory. Timestamp of the last ACR recording to be migrated. |
...
Metadata Field | Description | Template | Available |
|---|---|---|---|
| Start Date | Start date of the conversation | Standard | Yes |
| Start Time | Start time on the conversation | Standard | Yes |
| End Date | End date of the conversation | Standard | Yes |
| End Time | End time of the conversation | Standard | Yes |
| Duration | Length of the conversation | Standard | Yes |
| User | Name of the recorded user | Standard | Yes |
| From | Subscriber / Third Party Phone number | Standard | Yes |
| From Info | User / contact name | Standard | Yes |
| To | Subscriber / Third Party phone number | Standard | Yes |
| To Info | User / contact name | Standard | Yes |
| Direction | Direction of the call from the system perspective, requires configuring internal number/domain patterns | Standard | Yes |
| Direction (User) | Direction of the call from the recorded user perspective | Standard | Yes |
| From (Verba) | Verba user name associated with the From Number | Standard | Yes |
| To (Verba) | Verba user name associated with the To number | Standard | Yes |
| Location | Hostname of the recording server | Standard | Yes |
| End Cause | Normal, Hold, Transfer, Conference, Device Change, From Terminated, To Terminated | Standard | No |
| Audio Codec | Audio codec of the recorded streams | Standard | No |
| Video codec | Video codec of the recorded streams | Standard | No |
| Platform Call ID | Unique conversation identifier received from the recorded platform | Standard | Yes |
| Silence Ratio | Ratio of silence in the conversation | Standard | No |
| Talkover Ratio | Talkover ratio of the conversation | Standard | No |
| Longest Silence | Length of the longest silence present in the conversation | Standard | No |
| User ID / Agent ID | User ID | Standard | Yes |
| From Device | Device ID of the calling party | Standard | No |
| To Device | Device ID of the called party | Standard | No |
| Dialed Number | Original dialed number | Standard | No |
| From IP | IP address associated with the calling party | Standard | No |
| To IP | IP address associated with the called party | Standard | No |
| From Proxy IP | IP address of the proxy server associated with the caller party | Standard | No |
| To Proxy IP | IP address of the proxy server associated with the called party | Standard | No |
| Source Platform | ACR | Standard | Yes |
| Conversation Type | Voice | Standard | Yes |
| Forward Reason | Forward reason for the conversation (e.g. forwarded, transferred, team call, delegated, etc.) | Standard | No |
| Recording failed | Indicates if the recording has failed and the metadata was imported during CDR reconciliation | Standard | No |
| Media Length | Length of the media file related to the conversation in hhh:mm:ss format | Standard | No |
| Media Error | Shows the media processing errors during recording | Standard | No |
| Voice Quality | Overall voice quality check score for the conversation | Standard | No |
| Record Type | Standard | Standard | Yes |
| 2N Source | In case of duplicate (2N) recording, records are marked as primary or secondary | Standard | No |
| UDFs | All standard ACR User Defined Fields | ACR | Yes |
| Agents | Customer custom metadata | ACR | Yes |
| Services | Customer custom metadata | ACR | Yes |
| Skills | Customer custom metadata | ACR | Yes |
| Other Parties | Customer custom metadata | ACR | Yes |
| Fingerprint | Customer custom metadata | ACR | Yes |