# Configure agents and their groups

Toky uses the concept of **agent** to refer to any person inside your business/organization you want to receive calls. *You* and your *employees* are examples of agents.

Even though we define an agent as a person authorized to receive calls, you don't necessarily need to be answering calls to be considered as it. Having access to the Dashboard makes you an agent too, and this definition is equally valid as the latter.

#### Agent Groups <a href="#agent-groups" id="agent-groups"></a>

As the name implies, is an agents group created to be able to handle them as a unit. Examples of groups could be:

* Sales Team
* Support Team
* Dev Team

They exist for the purpose of keeping everything clean since it's much easier to manage groups than to manage individuals.

#### Adding agents <a href="#adding-agents" id="adding-agents"></a>

In the sidebar of the Dashboard, go to the [Agents Menu](https://beta.toky.co/business/agent/list), and click on **Add Agent**.

<figure><img src="/files/R0VB9wm5Psds8oaP2rDo" alt=""><figcaption></figcaption></figure>

A configuration form will show for you to fill the required data.

#### Public Profile <a href="#public-profile" id="public-profile"></a>

<figure><img src="/files/C3WTrV8TIfP10SyssSep" alt=""><figcaption></figcaption></figure>

1. **Profile Pic:** Change your displayed profile picture.
2. **Full Name:** Name displayed in the Toky platform.
3. **Email:** Email used for notifications and log in.
4. **Extension:** A number the customer can dial after the greeting to call the agent directly.
5. **Personal Phone Number:** This phone number is used when you enable [call forwarding](https://tokyapp.zendesk.com/hc/en-us/articles/360020736237).
6. **Personal Call Link:** is a direct line to the agent. It can be interpreted as the equivalent of an extension in a regular PBX, but with a link instead of a number.
7. **Role:** Define the permissions this agent will have in Toky's platform.

* **Basic**. A *Basic* agent is only able to answer calls and see the call history. No administrative task privileges.
* **Administrator**. An *Administrator* can do almost everything in the system: add users, numbers, greetings, etc. The only thing that is restricted from him/her is the ability to make payments and see the billing information. This is the sole privilege of the agent that created the account.
* **Personal call link**: is a direct line to the agent. It can be interpreted as the equivalent of an extension in a regular PBX, but with a link instead of a number.

#### Agent Groups <a href="#agent-groups" id="agent-groups"></a>

<figure><img src="/files/NeQvepxEvjkWhvtaKUXh" alt=""><figcaption></figcaption></figure>

Select the *agent groups* the agent belongs to. The agent must belong to, at least, one group.

#### Agent Office Hours <a href="#agent-office-hours" id="agent-office-hours"></a>

<figure><img src="/files/OnidjyCj6T0oVkI7bM07" alt=""><figcaption></figcaption></figure>

Here you can define the days and hours the agent will be available to answer calls in the selected timezone. These settings can be configured later by the agent itself through the [My account option](https://tokyapp.zendesk.com/hc/en-us/articles/360020677137).

#### Call Settings <a href="#call-settings" id="call-settings"></a>

<figure><img src="/files/XmVgDrNVba0nmih2WfF9" alt=""><figcaption></figcaption></figure>

1. **Settings:** Restrict calls to only agents calls or enable outbound call recordings *if you are an admin.*
2. **Permissions:** Allow agents to pause and unpause call recordings. *Only for admins.*
3. **Call monitoring:** Set configurations for [call monitoring](https://tokyapp.zendesk.com/hc/en-us/articles/360020959718). *Only for super admins.*
4. **Forward calls to my personal phone number:** Define when to enable call forwarding to the phone number configured in your Public Profile.
5. **Custom Voicemail Message:** Set your personalized voicemail greeting.
6. **Voicemail drop:** Configure pre-recorded messages you can use when you are sent to voicemail to outbound calls.

#### Notifications <a href="#notifications" id="notifications"></a>

<figure><img src="/files/Ce4Dr22T3U9EZhaAKUHY" alt=""><figcaption></figcaption></figure>

Enable or disable notifications for several events in the Toky apps.

#### Preferences <a href="#preferences" id="preferences"></a>

<figure><img src="/files/ET6C7oS0QTRIbPTUuFqY" alt=""><figcaption></figcaption></figure>

You can use this setting to enable or disable the Extended Agents Dashboard. It's only available for admins and when you have more than 3 agents.

After you finished filling up the required information, *Save Changes* and a confirmation email will be sent to the agent to enable the account.

In case the email you entered didn't arrive, please check if you typed it right.

<figure><img src="/files/ToONghAlcIXMk3Dv7znF" alt=""><figcaption></figcaption></figure>

If you did type it wrong, delete the agent and restart the process, if not, try resending it.

<figure><img src="/files/KMYtm84MtkkogNHXvI0O" alt=""><figcaption></figcaption></figure>

Once the email is confirmed, the agent can start to receive calls immediately.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bird.com/toky-en/how-to-guidestokyapp/configure-agents-and-their-groups.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.