Connect applet - Your tool to do complex call routing with Exotel

every single customer of exotel uses exotel because they want complete control over how they route incoming calls and to whom exotel provides a variety of different options and ways to route your incoming calls this article lists all possibilities, but before that, let's get some concepts out of the way the team we have a hypothetical group called the "support" group in which there are three members ajay, bhaskar & chaitanya in that order parallel ringing(on request feature) with exotel, it is possible to send an incoming call to ajay, bhaskar & chaitanya at the same time that is, exotel can ring all their phones at the same time and connect the caller to the first person who picks the call up read more about parallel ringing connect configuration options dial whom choose the group to send this call to click on the "magnifying glass" to select a group alternatively, you can use the radio button to choose the "text box" section in the text box, paste in a valid url that can return text and valid http headers refer here for the documentation of providing numbers to dial using your application url the text box section is good & bad at the same time the good you have the freedom to return a comma separated list of numbers to dial this is useful if you want to make a dynamic decision (based on the caller's number or "an input you collected using the gather applet which the caller may have pressed"' in the previous step etc) on whom to call the bad exotel does not maintain the state of these numbers that is if another call comes and your script decides to send the call to the same set of numbers, exotel will dial them and if the destination party has call waiting enabled, the caller will hear "the person you are trying to reach is on another call" etc so the user & user's state management is left to you to handle note this text box option for pasting url will only appear in connect applet if you have submitted your kyc documents successfully call recording if you select this option, an entry in the inbox will also have a recording that you can play & listen to at a later point if this is not checked, then there will still be a line item in your inbox without the recording read more about call recordings here call routing default option the default call routing option in a group is the order in which the names appear once you click on the group name on the co workers & groups page that is, every incoming call will be sent to ajay first and if he does not pick up, to bhaskar and then to chaitanya the default option respects whether the user is available & free that is, if ajay has turned himself "off" from the exotel system, then the call goes straight to bhaskar if bhaskar is already talking to someone, then to chaitanya distribute calls equally to group members this option is similar to "round robin" in the round robin, if the first call today goes to ajay, then the 2nd call goes to bhaskar, the third to chaitanya, etc the point of the round robin is to equally distribute the load of calls to all members in a group in the example above, if bhaskar cannot pick up when the second call comes in, the call is routed to chaitanya the third call then goes to ajay and the fourth to bhaskar it is assumed that an agent who is "on" would be free to pick up all calls if you don't check this option, then it will be the above "default" option click here to know more about this feature sticky agent when an incoming call from a new user (say dinesh) is picked up by bhaskar, then every time dinesh calls, the call will always first go to bhaskar if bhaskar is busy talking to someone else or is currently switched off from exotel, then the call follows the usual routing configurations this option is useful in assigning "account managers" that is, a single person responsible for a customer sticky agent will also work in an outbound scenario consider the above example where bhaskar has used the voice api (v1/v2/v3) to reach out to dinesh in this scenario, exotel would have first dialed out to bhaskar, who picks up, and then exotel dials out to dinesh irrespective of whether dinesh picks up or not, exotel will now ensure a mapping exists between dinesh and bhaskar for a fixed duration of 30 days dinesh will be able to connect back on the number and reach out to bhaskar itself (the sticky agent) if a call flow attached to the same vn (that was used in the voice apis ) has a connect applet with bhaskar as one of the agents in the agent group number of seconds to ring an agent this is the amount of time to ring ajay's phone number before moving on to bhaskar this time period starts from the time the server starts to dial (and not the time ajay receives the call) there will be a 2 to 3 sec delay before the call lands on ajay's phone (we all experience this delay when you dial your friend's number, you will hear "beep, beep, beep" before it goes tring tring) the default is 30 secs we recommend that you do not reduce this to less than 10 secs as exotel might move on to bhaskar even before ajay realizes that he is getting a call on his number the "beep beep" network slowness depends on the system load of not only exotel (which we are constantly monitoring) but also the load and congestion in the source & destination operator networks limit call duration this is the length of the time period up to which the call can be active the default is 4 hours and i can tell you that no one has ever crossed that limit yet we recommend that you leave this blank this option is particularly useful when you want to control the length of a call for ex if you have paid support and let's say the user has paid for a 30 minute slot, then you could use this to cut the call at the end of 30 minutes currently, exotel does not inform the caller or the callee that their time period is over it simply hangs up! music on hold (ringing tone) this is the music that will be playing when we dial the agent's number (note this is not the hold music that plays when you put the call on hold on your handset) there are more options in connect create pop up ( it triggers a call pop up notification on your endpoint) this is particularly useful to dynamically send information to one of your servers or systems during the call option sends the parameters from number(customer number), to number(agent number), and caller id(exotel number); more about these parameters can be found here during the call after the call conversation ends there are a few things you can do when ajay and dinesh finish talking send an sms to dinesh saying "thank you for calling mannar & company we hope to hear from you again!" drag/drop the sms applet to achieve this send an email to the "support" group with the details of the call read more about the email applet pass the information through to your system/server using passthru if you leave this option empty, then the call will simply hang up (which is what you really want in most cases) just to be clear, drag/drop the "hangup" applet queue the caller if all the agents are busy, you can put the caller in a queue and make him wait exotel will wake up every 10 seconds to check all callers in your queue and if there is a free agent who can talk to them read more about call queueing here if nobody answers exotel will look into your configuration in this option if no one picked up the call in your group to be specific, this option will be looked up if any of the following options are true a) there were agents in the group, some of them were free, exotel sent the call to them but they did not pick up b) there were no free agents in the group at the time of the call c) there were no agents at all in the group! d) you had enabled the queue & after having placed the caller in the queue, the queue time out exceeded choice 1 say sorry & hangup up plays this message to the caller & hangs up choice 2 you could drag/drop another applet for ex, a voicemail or even an sms applet that sends an sms informing the customer that all three people were busy