Blip Desk Scheduler 2.0 – Blip | Blip Help

Index

Requirements

For the extension and the bot to work correctly, you need to meet all the requirements below:

The variable containing the queue name must be exactly the same as the queue name itself, and also identical to the value of the condition in the rule on the Attendance tab.

Example: If I’m calling the HR queue through a variable, in the Attendance tab, the queue name must be exactly HR.

And in the Attendance Rule, the value of the rule's condition must also be HR.

The queues that will be used in the extension must have at least one attendant assigned to them.

Configuring the Human Attendance Bot

Before making any configurations in the extension, you must install and configure our example template to ensure the bot retrieves the information correctly.

Installing and Configuring the Template

First, access our extension and click the Example Bot button in the upper right corner.

After clicking this button, our example bot will be automatically downloaded to your computer. Now, just import this template into your bot.

After importing, you’ll need to configure two settings in your bot:

Inserting the Variable That Receives the Queue Name

For the attendance bot to correctly check the queue schedules and verify if there’s any attendant online, we need to update the input variables of two scripts with your variable that holds the queue name.

By default, the bot performs these actions using a variable called contact.extras.Fila. If you’re using a different variable, you’ll need to replace it.

In the 1.1 - Fetch Attendance Information block, go to the script Returns the team resource name, click on the input variables, and replace the variable contact.extras.Fila with yours.

Now, in the 3.0 - Check Attendant Availability block, click on the script Check if someone is online, go to the input variables, and replace only the contact.extras.Fila variable with yours.

All set! With these two changes made, your human attendance bot will retrieve the correct information using your variable that holds the queue name.

Inserting the Human Attendance Bot Key

For the 3.0 - Check Attendant Availability block to work properly, we need the authentication key from the human attendance bot itself.

Note: It’s through this key that we check whether attendants are online or not.

In your human attendance bot, click the gear icon that appears in the upper right corner.

In the menu that appears on the left, click on Connection Information

Scroll to the bottom of the page and go to the HTTP Endpoints section. Now, copy the key under the Authentication Header by clicking the copy icon next to the key.

With the key copied, return to the Builder page of your human attendance bot and click the settings icon on the left.

When you click the icon, a menu will appear on the right. In this menu, scroll down until you find the Configuration Variables option and click on it.

After that, click on Add Extra Information.

After clicking the button, two fields will appear: Variable and Value.

In the Variable field, enter botKey, and in the Value field, paste the bot key you copied earlier.

All set! Now, the 3.0 - Check Attendant Availability block can validate whether there are attendants online or not.

Extension Settings

With the requirements set up, now we need to modify the extension settings.

Inserting the Human Attendance Bot Key

Note: If you installed the extension on a bot that is not a Router and want to continue using it, you can skip to the next configuration.
On your first time, you will be automatically redirected to this configuration page, and on this page, we need to insert the human attendance bot key.
Without this key, the extension will not be able to access the queues.

First, open your human attendance bot and click on the gear icon that appears in the upper right corner.

Now, in the options that appear on the left, click on Connection Information

Scroll to the bottom of the page and go to the HTTP Endpoints section. Now, just copy the key from the Authentication Header by clicking the copy icon next to the key.

With the key copied, we can return to our configuration page in the Router. In the Human Attendance Bot section, click the Edit button.

Clicking the Edit button will enable the field to insert the key. Now, just paste the key we copied earlier and click the diskette icon to save.

Now the extension can access the queues of your human attendance bot.

Time Zone

To configure the time zone, click on the gear icon in the upper right corner of the page.

With the settings page open, go to the Time Zone section and click the Edit button

After clicking the Edit button, the Time Zone selection field will be enabled. Now, just select the desired time zone and then click the diskette icon to save.

All set! Now your time zone is saved.

Using the Extension

With the extension configured, we can now go through the time options that the extension offers us.

Click on the clock icon to access the schedule page.

Selecting the Queues

The first section of the extension is the Select Queue section. In this section, you have the option to set the schedule for All Queues or for a specific queue.

Click on this field and select the queue for which you want to set the attendance schedule.

Setting the Schedules

After selecting the queue for which we want to set a schedule, go to the Attendance Schedules section.

By default, from Monday to Friday, the hours are from 09:00 to 19:00, but you can change them by editing the fields according to the day of the week.

You can also add more hours on a day by clicking the + New button.

This way, you can create time intervals.

You can also delete any unwanted schedule by clicking the trash can icon.

All set! Now you can define the attendance hours for your queues.

Adding Holidays

The Days Off section is where we will add holidays. By default, national holidays are already set.

If you don't want to use any of these dates, you can click on the date again to remove it.

And to add a new date, simply click on the day.

Saving the Schedule

With the queue, hours, and holidays set, now we can save the schedule. At the bottom of the page, click the Save button.

All set! The queue you selected at the top of the page now has the hours and holidays defined. And if you need to make any changes, just make them and click the Save button again.

How Schedule Priority Works

If the user enters the human attendance with a queue that HAS NOT been configured in the extension, the bot will fetch the schedule for All Queues.

If the user enters the attendance with a queue that HAS been configured, the bot will ignore the schedules for All Queues and will fetch the information for the specific queue.

Example 1:
"I selected the All Queues option and set the working hours from 06:00 to 17:00."
Any user with any queue assigned to them will have their schedule verified based on what was defined in All Queues.

Example 2:
"I selected the All Queues option and added a schedule from 06:00 to 17:00, but I want a specific schedule just for my HR queue, so I selected the HR queue and added the schedule from 12:00 to 19:00."

Queue	Schedule
HR	12:00 to 19:00
All Queues	06:00 to 17:00

If the user enters with the HR queue assigned to them, the verification will be based on the HR schedule. If the user enters with a different queue, the verification will be based on the All Queues schedule.

For more information, access the discussion on the topic in our community or watch the videos on our channel. 😃

Related articles