With this application you can set a specific time when you want something to happen. For example during the mornings you can direct your calls to one operator or number and during the evenings to another one, or you can do this for specific days during the week.

You can branch off your calls even by months.

This application is very similar to the GoToIf application. When the specified time is matched by the current time then the call will be directed to a specific context or extension or priority.

The contexts and the extensions are optional settings. So you can omit one or both of them but you cannot omit the priority setting.

We will show you a simple example below.

To use this application you need a working Asterisk PBX with registered users in iax.conf, sip.conf or mgcp.conf(It depends on which protocol you would like to use) and made extensions.

To see how the application works we recommend to use our IAX softphone Idefisk. You can download it from here. Please also read our tutorial to learn how to configure it to work with Asterisk PBX.

NOTE: This is only an example of what for you can use this application. Of course you can use it and for other things.

We need two registered users in iax.conf file. This is because we are going to use the IAX2 protocol. If you want to use other protocol such as SIP or MGCP, you have to do the configurations below respectively in sip.conf or mgcp.conf.

So, we have registered the users anatoliy and user1

Type=friend means that this user can make and receive calls. Host=dynamic means that the IP is not static but dynamic through a DHCP server. Allow=all means that the line which this user will use, could support all audio codecs. Context=test - this shows that this user is working with the extensions in this context of the configuration file extensions.conf.

On the picture above you can see our extensions.conf file.

First of all, be careful with the names of the weekdays and the months. You have to write them with their short names. For example: "September" have to be written "sep" or "Monday" - "mon", "Tuesday" - "tue" and etc.

Now when somebody dials 222, the call will be answered, thanks to the Answer application.

Then, the next extension will be executed. This is the extension with priority 2. It contains the GoToIfTime application. In our example we have set as argument in the brackets of the application the following: 11:00-14:00|thu|1|sep?test1|s,1.

This means that if the time is between 11:00 and 14:00 and the day is Thursday and the month day is 1 and the month is September, that the call will be redirected to the context [test1], extension s with priority 1.

Extension s is a special type, predefined extension. More information about it you can find in extensions.conf.

The caller will hear a welcome message and then if he/she press one the call will be connected to the user user1 through IAX2 channel.

But what will happen if the call is made through different time, day or month? The call won’t be directed to another context. In our case to [test1], but the execution will continue with the extension with priority n+1, where n is the number of the current extension. In our example the execution will continue with the extension with priority 3. The caller will hear a busy tone and then the line will be hung up. To learn more how to set a busy tone, please read our tutorial about the Busy application.

It is not necessary always to set all four parameters about the time, day of the week, day of the month and the month. You can omit one, two, three or even the all four parameters. When you skip a parameter the system will interpret it as "always" condition. For example if you skip the argument for time the system will execute the GoToIfTime application independently of what is the time of the day. Instead of a empty field for an argument you can put also the asterisk character "*". This character will be interpreted also as "always" condition.

There is something very important to do when you skip an argument. When you omit a parameter you just leave its space blank but the "|"character remains

Examples: