Collect Input from Caller Step

User level: Admin

---

Collect Input is a step available in CloudTalk’s Call Flow Designer. Use it when callers need to enter data on their keypad that will be used in a follow-up step, such as an HTTP Request or dynamic routing on a Ring to step.

​

Add Collect Input to Your Call Flow

1. From the Dashboard, click Numbers.
2. In the My numbers tab, find the number you want to configure.
3. Click + Configure (or the flow name, if one exists) in the Call Flow column.
4. On the canvas, click the + button where you want the step.
5. In the step library, under Automation, select Collect Input.

​

Value Types (From Caller)

Though character strings will be accepted, there may be better CloudTalk solutions available for companies that need long-form answers or text strings from customers.

---

​

Configuration

The Collect Input config panel has two sections: a sound picker at the top and Collect info from caller settings below it.

​

Sound

The sound picker works the same as in the Greeting, IVR Menu, and Dial by Extension steps. You can create a new sound, upload one, use text-to-speech, or search your existing library. Use it to play a prompt telling callers what to enter (e.g., “Please enter your order number”).

​

Collect info from caller settings

Seconds to wait on this step A timeout is the default method of ending the step. The number of seconds you enter here determines how long the step waits before moving on. Make sure the timeout is longer than the greeting you’ve set, so callers have time to listen and respond. Pattern The Pattern field expects a regular expression (regex). If the regex is formatted incorrectly, it will return null or create an error during execution. The # character will not be recognized in a pattern; it will automatically end the input step. Retry on invalid Check this box to give the caller a chance to repeat the input if it doesn’t match the expected pattern or if the timeout is reached. The maximum number of retries is 10. At the beginning of each retry, the greeting (if set) will be played again.

---

​

Using Collected Input in Other Steps

​

With HTTP Request

You can design a flow where callers enter information (like an order number) that is then sent via HTTP Request to another system, such as a CRM.

1. Add a Collect Input step followed by an HTTP Request step in your flow.
2. In the HTTP Request’s Request Body, add a key-value pair. For the value, reference the caller input using: #{{input[123].value}} where the number in brackets is the input_id of the Collect Input step.

If you create both steps in the same session, you can enter a temporary ID in the brackets. The real ID will replace it after you click Save. Set the paired Key to any string value expected by the receiving endpoint. Check the box to Parse response if an HTTP response is needed to continue through the flow. If unchecked, the flow continues after the request is sent, regardless of whether a response was received.

​

With Ring to (dynamic routing)

Use collected input to dynamically route the call to an agent, group, or voicemail based on what the caller entered.

1. Add a Collect Input step followed by a Ring to step.
2. In the Ring to config panel, click Route dynamically via variable.
3. In the Route to (variable) field, enter: #{{input.step_id}} where step_id is the Step ID of the Collect Input step (e.g., #{{input.389008}}). To find the Step ID, click the three-dot menu (⋮) on the Collect Input card.

---

Need help or have a question? Just reach out through our Support portal — we’re here for you.