Call User Node
Understand what a Call User node is and how to configure it
The Call User node is used to initiate an outbound call to the configured number. This node cannot exist within the Voice Node Group. When you drag-and-drop the Call User node onto the visual flow builder, its onAnswer node event gets connected to the voice node group container automatically. Based on your use case you can decide which nodes exist in the node voice group.
Node Configuration
Drag-and-drop the node onto the visual flow builder and double-click it to open the configuration window.
- Select the Destination Type: msisdn or Customer Id. MSISDN is the mobile number of the user and the customer id is the unique identifier that identifies the user.
Number Format
The phone number should be in E.164 format.
- Select the From Number from the drop-down list of available numbers. This is the number from which the outbound call gets initiated to the user. The platform supports dynamic 'FROM NUMBER' configuration as well. Simply select the ‘Dynamic’ option dropdown and configure the variable name that contains the ‘FROM NUMBER’.
- In the Destination field, enter the variable that contains the selected destination type or provide an absolute value.
- Configure Correlation ID, Callback Data, and Notify URL options are added to be able to pass data back to the client’s system to notify every call status. If an invalid URL is passed in API request or via a variable, then such request will not be considered eligible for retries. This field accepts only a valid URL or a variable.
These are optional and accept dynamic values as well. The callback data size is however limited to 2KB and exceeding that will cause the node to exit through the policy error without making any calls. - Expiry Time: There are two types of expiry. You can select a specific date or number of seconds after which the request should expire. You can define the maximum time, within which the node execution must complete by providing the expiry time in UTC or seconds. You can define the date and time after which the calls should not be made.
Note
For a better customer experience, we strongly advise utilizing the expiry time whenever using the "Call User Node" for voice calls. This practice helps prevent voice calls being made after designated expiry time which otherwise could be disruptive and bothersome.
Here is a list of milestone events and when they occur while making a call:
- Offered: when Webex Connect platform offers a call to the network to place a call
- Accepted: when the network accepts the call offered by Webex Connect and places it to end-customer
- Answered: when the end-customer answers the call
- Dropped: when the call is dropped because of an internal technical error
- Rejected: when the call gets rejected; it can be due to various reasons like network failure, the customer is busy, rejected by the customer, etc.
- Released: when the call is ended by the platform
- Disconnected: when the end-customer disconnects the call
- Trombone Connected: when the Webex Connect platform sends an outbound call to the customer and the customer asks to talk to an agent. The Trombone Connect event occurs when both parties A (end-customer) and B (agent) are connected.
- Trombone Released: when the party B (agent) exits the call.
- Message Expired: when the call request comes in after the configured expiry time, the request expires.
The endpoints will be automatically be notified of the occurrence of all the events.
- Click Save to complete the configuration.
Input Variables
You can see a list of all the flow variables available for use within this node under the Input Variables pane. You can also search for a variable using the Search field.
You can see the list of variables that you explicitly create and configure for this node under the Custom Variables pane. You can also add a custom variable to the flow using the Add New Custom Variable button. For more information, see Custom Variables.
Output Variables
You can see the data that this node generates as output variables. These variables are available for use in subsequent nodes. The following are the standard output variables for the Call User node:
- call.fromNumber - stores the number from which the outbound call is initiated
- call.toNumber - stores the number or batch of numbers to which the outbound call is made
- call.transId - stores the transaction id of the outbound call
- call.timestamp - stores the timestamp of the outbound call.
Node Outcomes
You can see the list of possible node outcomes for this node under this pane. You can customize the node labels using the Edit (pencil) icon. The node exits through one of the node edges corresponding to the outcome of the node.
Node Edge | Node Event/Outcome |
---|---|
Success (green) | onAnswer - the flow exits through this node outcome when the configured audio prompts are played successfully. This node outcome is automatically connected to the voice node group. |
Error (red) | onError - the node exits with an error when there is an invalid user ID or missing digits in the customer's phone number. However, we noticed that the success rate of retried calls is significantly low. So, we suggest not to retry calling in such scenarios. oncallfail - the flow exits through this node outcome when the call could not be connected due to network issues. onnoanswer - the flow exits through this node outcome when the call is not answered. onbusy - the flow exits through this node outcome when there is a busy tone on the receiver's side. onreject - the flow exits through this node outcome when the call is rejected. onPolicyFail - the flow exits through this node outcome when there is a policy failure. |
Timeout (orange) | onExpiry - the flow exits through this node outcome when the call request expires. |
Note
- The onExpiry node outcome is available only when Expiry is configured.
- All the newly created flows exit through the onExpiry node outcome when the call request expires.
- For existing flows, the flow exits through the onError node outcome when the call request expires. However, once you edit the flow, it exits through the onExpiry node outcome when the call request expires.
Transition Actions
Use this tab to configure the transition actions for On-enter
/On-leave
events. However, configuring transition actions is optional. For detailed instructions about configuring the transition actions, see Node Transition Actions.
Updated 2 months ago