Flow Debug

View detailed execution logs, find, and fix problems in individual flow runs

Flow Debug provides a step-wise execution trace for your recent flow executions. You can find and fix problems in your flows using Flow Debug. This capability is typically meant to be used for troubleshooting purposes while configuring and iterating flows. We recommend you to use Debug Console for viewing old transaction logs.

You can launch the flow debug panel using the Flow Debug icon at the right navigation panel of your flow canvas. The Flow Debug panel opens in a split view at the bottom of your flow and displays a list of 10 most recent flow runs. Typically logs take about two minutes to show in the flow debug section. You may not see the logs for a recently initiated transaction immediately.

  • Click the transaction ID to drill down to the details of each flow run (transaction)
  • Filter the flow executions using the transaction ID
  • Filter the logs based on selected date range and time (Logs are available for the latest 30 days).
1559

Debug - Canvas split view

The information captured within logs is segregated into three levels based on the sensitivity of the data and the level of detail:

  • Level 1: Summary Logs
  • Level 2: Sequence Summary
  • Level 3: Node Execution Details.

You can now see the timezone along with the timestamp in the transaction logs.

1601

Transaction Sequence Summary

This view lists the complete sequence of nodes executed for the selected transaction. It also lists the time taken to execute each step and the outcome of each step. Step here refers to the runtime execution of a particular node. This view allows you to verify the business logic within the flow without going into technical details.

Since navigating to a specific node in a large flow can be cumbersome, flow debug automatically shifts the canvas to the respective node when you click on a node name under the 'Node' column.

🚧

Encryption

Summary logs do not contain personally identifiable information (PII) and are therefore not encrypted. However, the details of node execution may contain PII, in which case such information is encrypted. Only users who are authorized by the client admin can decrypt these detailed logs to view them in plain text.

Node Execution Details

The node execution details are available only to users authorized by the tenant onwer. This view, by default, shows PII in encrypted form. However, basic information such as the outcome of the node and the execution parameters like start time is available to all users in plain text.

📘

Note

For all the flows created after the v6.3.0 release, there is a limit of 1000 for the number of node executions within a single flow. If the number of node executions exceeds 1000, the node execution fails with an error “System limit reached.”

❗️

Capturing Node Execution Details during Initial Set-up.

You must enable the Descriptive Logs option under flow settings to capture node execution details. Please note that this feature is suggested to be used only during initial flow set-up and troubleshooting. Enabling this feature in production mode can impact your tenant performance.

800

Node Level Execution Details

In the case of voice flows, you can see the various voice nodes within the flow and the sequence in which the nodes are executed. If the flow contains the voice node group, then you can drill down to the individual nodes in the group.

When a voice flow has recordings, you can click Recordings to play the recordings directly in the debug console. You can also see the call duration and audio prompts configured and played to the caller during an ongoing call.

1601

Voice Flows

Transaction Logs

  • Decrypts Logs: the additional description of the action performed by the node under the transaction in encrypted mode.
  • Time Stamp: the time at which the flow execution started
  • Transaction ID: the ID number created for the transaction
  • Invoked By: the trigger that invoked the flow
  • Time Taken: the time taken to execute the entire flow
  • Last Node: the last node that was in use when the flow ended
  • NodeID : ID of the current node in the flow
  • Outcome: the node event of each node
  • Details: details of the node execution.

👍

As mentioned above, flow debug allows you to analyse step wise execution of your recent flow executions and is mainly best suited for understanding how your flow is progressing and where there are issues, if any, during initial flow configuration and prototyping phases. If you want to analyse a transaction within last 30 days period, or want to look at the past 30 days of message exchanges for a given customer or channel, you can use Debug Console feature.

Transaction Channels

The following parameters are displayed in the Debug flow of the Start Node:

ChannelEvent in Start nodeParameters to be shown in transaction logs
SMSMobile originated -MO Timestamp
Sender Number
Service Number
Message
SMSOn Link click Timestamp
Sender Number
VoiceInbound call Service Number
Timestamp
* MSISDN
VoiceMissed call Service Number
Timestamp
* MSISDN
MMSMobile originated -MO * Sender Number
MessengerIncoming Message AppId
PSID
Message
Attachment URL
Timestamp
Location URL
MessengerOn link click AppId
PSID
* Timestamp
MessengerPostback AppId
PSID
Timestamp
Postback Payload
WhatsAppIncoming Message AppId
WaId
Timestamp
Message
Image URL
Location URL
Voice URL
Audio URL
Video URL
Sticker URL
WhatsAppPostback AppId
WaId
Timestamp
Button Payload
WhatsAppList Message AppId
WaId
Timestamp
List Description
Row Title
Row Identifier
WhatsApp

Reply button Message
AppId
WaId
Timestamp
Reply Button Title
* Reply Button Identifier
In-App / Live ChatCustom event UserId
PushId
Timestamp
AppId
In-App / Live ChatGeo enter UserId
PushId
Timestamp
AppId
* GeofenceId
In-App / Live ChatGeo Leave UserId
PushId
Timestamp
AppId
* GeofenceId
In-App / Live ChatIncoming Message Timestamp
UserId
PushId
Message
Attachments
DeviceId
Version
Threadid
In-App / Live ChatOn thread close Threadid
AppId
* UserId
In-App / Live ChatOn postback Timestamp
UserId
PushId
Message
Attachments
DeviceId
Version
ThreadId
* Button Payload
EmailIncoming Message Message
Emailid
AppId
To Address
Attachments
Receipts
* Timestamp
EmailSubscribe Emailid
AppId
Attachments
Timestamp
Emailunsubscribe EmailId
AppId
Attachments
Timestamp
RCSIncoming Message Text
Timestamp
AppId
Number
RCSMessage
Incoming attachment
Text
Timestamp
AppId
Number
* File URL
RCSLocation response Text
Timestamp
AppId
Number
RCSPostback Text
Timestamp
AppId
Number
* Postback Data
Apple Messages for BusinessConversation closed ABCUserId
AppId
Apple Messages for BusinessInteractive Message authentication AppId
AuthToken
* AuthStatus
Apple Messages for BusinessInteractive Message list picker ABCUserId
AppId
Timestamp
Date Picker Time Slot
Date Picker Duration
Time Slot Identifier
Time Slot Start Time
List Picker Items
* List Picker Other Items
Apple Messages for BusinessInteractive Message payment ABCUserId
AppId
Timestamp
Payment Status
Apple Messages for BusinessIncoming Message ABCUserId
AppId
Timestamp
Message
* Attachment URL
Apple Messages for BusinessInteractive Message quick reply ABCUserId
AppId
Timestamp
Selected Identifier
* Selected Index
Apple Messages for BusinessInteractive Message form response ABCUserId
AppId
Timestamp
Selections
* Selections Count
Apple Messages for BusinessTyping indicator ABCUserId
AppIdAppId
* Type
Apple Messages for BusinessInteractive Message new authentication AppId
AuthToken
* AuthStatus
Apple Messages for BusinessInteractive Message iMessage extension AppId
URL
Custom event Payload
Timestamp
Google Business MessagesIncoming Message AppId
ConversationId
AgentId
Send Time
MessageId
Text
Google Business MessagesUser Status AppId
ConversationId
AgentId
Send Time
IsTyping
Requested Live Agent
Google Business MessagesSurvey Response AppId
ConversationId
AgentId
Send Time
SurveyId
Question Response Text
Question Response Postback Data
QuestionIndex
Google Business MessagesSuggestion Response AppId
ConversationId
AgentId
Send Time
MessageId
Postback Data
Text
Suggestion Type
InstagramIncoming Message MessageId
Igsid
Igid
Timestamp
UserId
AppId
Message Type
Attachment Type
Attachment Url
Story Reply Url
* Replied MessageId
InstagramMessage Deleted MessageId
Igsid
Igid
Timestamp
UserId
AppId
* IsDeleted
InstagramPostbackMessageId
Igsid
Igid
Timestamp
UserId
AppId
Payload
Title
Quick Reply Payload

Inbound events

The following parameters are displayed in the Debug flow of the Receive Node:

ChannelEvents in Receive nodeParameters to be shown in transaction logs
SMS

·
Sender Number
Service Number
Message
Attachment
Timestamp
VoiceMSISDN
Service Number
Message
Timestamp
MessengerIncoming MessagePSID
AppId
Message
Attachments
Timestamp
MessengerPostbackPSID
AppId
Payload
Timestamp
WhatsAppIncoming MessageAppId
WaId
Timestamp
Message
Image URL
Location URL
Voice URL
Audio URL
Video URLSticker URL
WhatsAppPostbackAppId
WaId
Timestamp
Button Payload
WhatsAppList MessageAppId
WaId
Timestamp
List Description
Row Title Row Identifier
WhatsAppReply button MessageAppId
WaId
Timestamp
Reply Button Title
Reply Button Identifier
Custom eventPayload
In-App / Live ChatIncoming MessageTimestamp
UserId
PushId
Message
Attachments
DeviceId
Version
ThreadId
In-App / Live ChatForm responseTimestamp
UserId
PushId
Form Response
Attachments
DeviceIdVersion
ThreadId
In-App / Live ChatPostbackTimestamp
UserId
PushId
Message
Attachments
DeviceId
Version
ThreadId
Button Payload
Apple Messages for BusinessInteractive Message Time pickerABCUserId
AppId
Timestamp
Message
Attachment URL
Date Picker Timeslot
Date Picker Duration
Time Slot Identifier
Time Slot Start Time
Apple Messages for BusinessInteractive Message authenticationAuthToken
AuthStatus
Apple Messages for BusinessInteractive Message list pickerABCUserId
AppId
Timestamp
List Picker Items
List Picker Other Items
Apple Messages for BusinessInteractive Message paymentABCUserId
AppId
Timestamp
Payment Status
Apple Messages for BusinessInteractive Message form responseABCUserId
AppId
Timestamp
Selections
Selections Count
Apple Messages for BusinessConversation closedABCUserId
AppId
Apple Messages for Business Interactive Message new authenticationAppId
AuthToken
AuthStatus
Apple Messages for BusinessInteractive Message quick replyABCUserId
AppId
Timestamp
Selected Identifier
Selected Index
Apple Messages for Business Typing indicatorABCUserId
AppId
Type
Apple Messages for BusinessInteractive Message iMessage extensionAppId
URL
Apple Messages for Business Incoming MessageABCUserId
AppId
Timestamp
Message
Attachment URL
RCSIncoming attachmentText
Timestamp
AppId
Number
RCS Incoming MessageText
Timestamp
AppId
Number
File URL
RCSLocation responseText
Timestamp
AppId
Number
RCS PostbackText
Timestamp
AppId
Number
Postback Data

HTTP node logs

For HTTP nodes, the flow transactions logs are:

  • Request Timestamp
  • Request URL
  • Request Data
  • Response timestamp
  • Response Data

Custom node logs

For Custom nodes, the flow transactions logs are:

  • Request timestamp
  • Request URL
  • Request Data
  • Response timestamp
  • Response Data

📘

Transaction details for Custom event/Webhook is available for a maximum of 7 days.

Prebuilt Transaction Details - Outbound and Async events

For Prebuilt nodes, the flow transactions logs are:

  • Resume key
  • Request timestamp
  • Request URL
  • Request Data
  • Response timestamp
  • Response Data