Set up queued callback by creating flows, queues, and routing profiles - Amazon Connect

Set up queued callback by creating flows, queues, and routing profiles

You can create flows that provide the ability for customers to leave their phone number and get a callback from an agent.

How callbacks keep their place in queue

Callbacks can be placed in either the same queue as the one they come from, or in a new queue that you can create to get a clearer delineation of the active queued calls versus in memory (callback) calls in the real time reports.

From a routing perspective, if the callback queue has the same priority with the original queue, Amazon Connect continues to look at the start time as the original start time for the call where the callback was initiated from, so the call does not lose the place in queue, regardless of where you transfer it.

Amazon Connect evaluates the routing profiles first so if the two queues have the same priority, the oldest call is pushed first across all queues with the same priorities. For example, if your original call arrived at 10:00 and left a callback request at 10:05, Amazon Connect looks for the call start time of 10:00, not 10:05.

Steps to set up queued callback

Use the steps provided in the following overview to set up queued callback.

  • Set up a queue specifically for callbacks. In your real-time metrics reports, you can look at that queue and see how many customers are waiting for callbacks.

  • Set up caller ID. When setting your callback queue, specify the caller ID name and phone number that appears to customers when you call back.

  • Add the callback queue to a routing profile. Set this up so that contacts waiting for a call are routed to agents.

  • Create a flow for queued callbacks. You offer the option for a callback to the customer.

  • Associate a phone number with the inbound flow.

  • (Optional) Create an outbound whisper flow. When a queued call is placed, the customer hears this message after they pick up and before they connect to the agent. For example, "Hello, this is your scheduled callback..."

  • (Optional) Create an agent whisper flow. This is what the agent hears right after they accept the contact, before they are joined to the customer. For example, "You're about to be connected to Customer John, who requested a refund for..."

The routing process

  1. When a customer leaves their number it's put in a queue and then routed to the next available agent.

  2. After an agent accepts the callback in the CCP, Amazon Connect calls the customer.

    If no agents are available to work on callbacks, the callbacks can stay in queue for up to 7 days after they are created before Amazon Connect automatically removes them.


    To manually remove a callback from the queue, use the StopContact API.

  3. If there is no answer when the Amazon Connect calls the customer, it retries based on the number of times you've specified.

  4. If the call goes to voicemail, it's considered connected.

  5. If the customer calls again while in the callback queue, it's treated as a new call and will be handled as usual. To avoid duplicate callback requests in a callback queue, see this blog: Preventing duplicate callback requests in Amazon Connect.

How queued callbacks affect queue limits

  • Queued callbacks count towards the queue size limit, but they are routed to the error branch. For example, if you have a queue that handles callbacks and incoming calls, and that queue reaches the size limit:

    • The next callback is routed to the error branch.

    • The next incoming call gets a reorder tone (also known as a fast busy tone), which indicates no transmission path to the called number is available.

  • Consider setting up your queued callbacks to be lower priority than your queue for incoming calls. This way, your agents only work on queued callbacks when the incoming call volume is low.

Create a flow for queued callbacks

To see what a flow looks like with queued callback, in new Amazon Connect instances see Sample queue configurations. In previous instances, see Sample queued callback.

The following procedure shows how to:

  • Request a callback number from a customer.

  • Store the callback number in an attribute.

  • Reference the attribute in a Set callback number block to set the number to dial the customer.

  • Transfer the customer to the callback queue.

At the basic level, here's what this queued callback flow looks like, without any of the alternative branches or error handling configured. The following image shows a flow with the following blocks: Get customer input, Store customer input, Set callback number, Play prompt, Transfer to queue, and Disconnect/hang up.

A queued callback flow in the flow designer.

Following are the steps to create this flow.

To create a flow for queued callbacks
  1. In Amazon Connect, choose Routing, Contact flows.

  2. Select an existing flow, or choose Create flow to create a new one.


    You can create this flow using different flow types: Customer queue flow, Transfer to agent, Transfer to queue.

  3. Add a Get customer input block.

  4. Configure the block to prompt the customer for a callback. The following image shows a message in the Text-to-speech box: Press 1 to receive a callback. Press 2 to stay in queue.

    The properties page of the Get customer input block, configured for text-to-speech or chat text.
  5. At the bottom of the block, choose Add another condition, and add options 1 and 2, as shown in the following image.

    Option 1 and option 2.
  6. Add a Store customer input block.

  7. Configure the block to prompt customers for their callback number, such as "Please enter your phone number." The following image shows the Properties page of the Store customer input block.

    The text to speech box, contains the message Please enter your phone number.
  8. In the Customer input section, select Phone number, and then choose one of the following:

    • Local format: Your customers are calling from phone numbers that are in the same country as the AWS Region where you created your Amazon Connect instance.

    • International format/Enforce E.164: Your customers are calling from phone numbers in countries or regions other than the one where you created your instance.

  9. Add a Set callback number block to your flow.

  10. Configure the block to set Type to System, as shown in the following image. For Attribute, choose Store customer input. This attribute stores the customer's phone number.

    The Properties page of the set callback number block.
  11. Add a Transfer to queue block.

  12. In the Transfer to queue block, configure the Transfer to callback queue tab as shown in the following image. Set Initial delay to 99. Set Max number of retries to 2. Set Minimum time between attempts to 10 minutes.

    The transfer to callback queue tab on the Properties page of the Transfer to queue block.

    The following properties are available:

    • Initial delay: Specify how much time has to pass between a callback contact being initiated in the flow, and the customer is put in queue for the next available agent. In the previous example, the time is 99 seconds.

    • Maximum number of retries: If this is set to 2, then Amazon Connect tries to call back the customer a maximum of three times: the initial callback, and two retries.

      A retry only happens if it rings but there's no answer. If the callback goes to voicemail, it's considered connected and Amazon Connect does not retry again.


      We strongly recommend that you double-check the number entered in Maximum number of retries. If you accidentally enter a high number, such as 20, it's going to result in unnecessary work for the agent and too many calls for the customer.

    • Minimum time between attempts: If the customer doesn't answer the phone, this is how long to wait until trying again. In the previous example, we wait 10 minutes between attempts.

  13. In the Optional parameters section, choose Set working queue if you want to transfer the contact to a queue that you set up specifically for callbacks. This option is shown in the following image.

    The optional parameters, set a queue set to callback queue.

    Creating a queue just for callbacks lets you view in your real-time metrics reports how many customers are waiting for callbacks.

    If you don't set a working queue, Amazon Connect uses the queue that was set previously in the flow.

  14. To save and test this flow, configure the other branches and add error handling. To see an example of how this is done, see Sample queue configurations. For previous instances, see Sample queued callback.

  15. For information about how callbacks appear in real-time metrics reports and contact records, see About queued callbacks in metrics.

Learn more about queued callbacks

See the following topics to learn more about queued callbacks: