Debug Console

The Debug Console allows you to view transaction details and historical logs for all your API, flow, and rule executions on Webex Connect. This includes details such as event/message status, transaction timestamp, service name, source of the transaction, errors, and more.

Understanding the Debug Console

• The default querying period is 30 days. However, if archive search is enabled and the retention period is set for archive search, then records of up to a maximum range of 60 to 90 days can also be queried at a time in both tabs i.e., Channels and Integrations.
• Decrypting Logs - Logs are visible in the encrypted mode by default. The Decrypt Logs button is enabled for users who have permissions associated with their user account. If permissions are granted, then the Decrypt Logs button is enabled for the user. The Webex Connect platform uses AES and secure key for encrypting personal information.

  📘

  Note

  For Outbound Logs - To, Message Body, and Payload are the encrypted fields.

  For Inbound Logs - From, Message, or any personal information are the encrypted fields.
  When you click Decrypt Logs, the logs are decrypted using the Master Key associated with your tenant. The Master Key must be auto regenerated on regular intervals, with '1' month being the minimum and '60' months being the maximum. The default interval is 12 months. Reach out to your account manager for configuration-related information.

• Refresh - The Refresh button allows you to refresh the query pages if filters are changed or any other changes are made. The Refresh button is enabled when you search for any transaction logs.

📘

Note

The logs typically take about two minutes to show in the flow debug console.

Query by Transaction ID

You can search for transaction logs using the channels or transactional ID returned by the Messaging API or the Custom Event API. You can view channel-specific transaction id documentation under Outbound Webhooks. When you search using transaction ID, a table showing recent data associated with that transaction ID appears as shown below.
The table contains the following details:

• Source Transaction ID – the source transaction ID. Click this ID to go to the transaction details page.
• Service Name - the service through which the transaction was initiated.
• Source - the source of the transaction - Messaging API /Flow /Rule. You can see all the transactions are grouped on the source type.
• Status - the status of the transaction - Completed /Received /In Session /Submitted /Inactive/ Clicked/ Unresolved.
• Created On - the date and time on which the transaction was created.

Querying Channels

You can filter using the query parameters listed below after selecting the time range, in any number of combinations with no restrictions.

• Channel

• Destination ID

• Service

• Source

When you expand the Transaction ID, you can view details such as the message associated with the transaction, its status, and the “created on” timestamp.

Clicking the hyperlink on the transaction ID takes you to the Transaction Details page with additional information.

Clicking on the hyperlinks for Actions and Trace Details displays the flow transaction details and node details.

Clicking the hyperlink in the message ID of a specific transaction of the Debug Console query page takes you to the page enclosing the Message Details, Process Log, and Error & Warnings.

Querying by Channel - Live Chat/ In-App

To query for transaction logs by Channels:

1. Select the Channel (Live Chat/ In-App Messaging) from the drop-down list.
2. Select the required service from the Service drop-down.
3. Select the Time Range.
4. Click Search.
   All the query transactions are populated.

Click the Transaction ID if you want to get further flow details. Clicking a Transaction ID link will open the transaction details page.

🚧

Availability

You can only see the transaction logs for the last 30 days.

📘

Note

If +E.164 format is enabled for your tenant - all the sender and recipient numbers will be displayed in E.164 format.

Search will be supported with or without +E.164 format.

This format displays the number with a "+" followed by the country code and the phone number.

Query by Channel - SMS SMPP

To query for transaction logs by Channels:

1. Select the Channel (SMS) from the drop-down list.
2. Select the SMPP service from the Service drop-down .
3. Select the Time Range.
4. Click Search.
   All the the query transactions are populated.

Query by Destination ID

You can search for all the sent and received messages to a customer based on customer identity. When a user searches using Destination ID, a table showing recent data associated with that Destination ID appears.

The table contains the following details:

• Source Transaction ID – the source transaction ID. Click this ID to go to the transaction details page
• Service Name - the service through which the transaction was initiated
• Source - the source of the transaction - Messaging API /Flow /Rule. You can see all the transactions are grouped on the source type.
• Status - the status of the transaction - Completed /Received /In Session /Submitted /Inactive/ Clicked.
• Created On - the date and time on which the transaction was created

You can view all the source transactions and messages grouped by Source Transaction ID in a single page view.

List of source transactions ID’s along with message ID’s are grouped under each is shown with filter options:

• Service
• Source
• Status
• Time Period

All the transactions are grouped according to the source type.

Moreover, you can also check node executions of each source transaction associated with the Destination ID by clicking on the respective Source Transaction ID and/or Message ID links that redirects you to the respective details page.

Following are the source types:

• Flow
• Rule
• API

Note: Status at source transaction-level appears as per the type of transaction. Click the drill-down button of the source transaction to expand the details.

Click the Message ID if you want to get further message details. Clicking on a message ID link will open the message details page.

Note:

• Status column in the source transaction row is status of the flow execution but in the message id row it is message status.
• The status filter has both flow transaction status and message status which can be selected using the list items in filter dropdown.
• Sorting by default is by created on (latest record on top).
• All the messages are grouped by source transaction ID, in case of flows you can see the messages grouped by flow transaction.

🚧

Availability

Transaction logs are stored for up to 30 days on the platform.

Voice calls

You can query the summary of a call by the destination​. This provides a detailed view of how the call progressed​. You can also listen to prompts played to the user and recordings.​

WhatsApp

Using the debug logs, you can see all the transactions and the details of each transaction.

1. Select WhatsApp as Channel.
2. Enter/select all the other search criteria.
3. Click Search.

Here you can view all the transaction logs along with the status of the messages.- Read, Submitted, in-session, Delivered, Failed, Invoked, Unresolved, and so on. You can filter the logs by status.

❗️

Please note that Call Duration is showing up as Zero currently in Debug Console results when you view the details for a large number of calls at once due to a bug that's planned to be fixed in a future release. However, the duration is available when looking at an individual transaction.

Drill-down the log to view more details like message ID, direction (inbound or outbound), created date, body, source, from, to, message priority, and payload

Historical Logs

It allows you to search for all incoming and outgoing messages on a channel over a specific time period.

Querying Integrations

Before the time range is selected, only the filter parameters in the above screen capture are visible.

After you select the time range and click the Search button, some additional filter criteria are displayed as shown in the above screen capture.

You can select or add the search parameters listed below in after selecting the time range, in any number of combinations with no restrictions.

*Prebuilt Integrations - Cannot be changed

*Integration

*Transaction ID

*Resume Key

*Node

*Method

*Service

*Source

*Status

Clicking the expand button next to a flow transaction displays the request details by the connect system to the integrating system and the response received from the integrating system.

Clicking on the hyperlink of the flow transaction takes you to the flow transaction details page. Clicking o the hyperlinks for Actions and Trace Details displays related information on the screen.

Types of Flow Transactions

*There are three types of flow transactions. They are indicated in the Type column of the main query page.

*Node Outbound: Refers to API calls sent by the Webex Connect system to the integrating system.

*Inbound Event: Refers to API calls sent by the integrating system to the Webex Connect system.

*Async Event: Refers to API calls sent to the integrating system for which response is received after a certain time lag.

Unresolved Status

When a message or event received from an end customer is not resolved to any flow and/or rule (i.e., no trigger condition matched with the incoming message or event), such messages and events for all channels are categorised as 'Unresolved' in the Debug Console. The same happens for Inbound Webhooks and Event API triggers that are not mapped with any Flow and/or Rule.

To see the list of the unresolved messages and events:

1. Go to Debug Console.
2. Select the Channel for which you want to see the unresolved messages and events.
3. Select the Time Range.
4. Select any other search criteria you want.
5. Click Search.
6. From the search results, filter the Status column to display Unresolved.
7. Click any transaction to see the details.

You can see that the status is Unresolved, Source and Service are NA (Not Applicable), and the Rules Triggered is 0, because the transaction is not resolved.