# Oncall Assistant

{% hint style="info" %}
Read this if you have Smart Apps in use that have been ordered before 21 october 2024. New Smart Apps documentation can be found within the [Marketplace](/store/marketplace-apps.md).
{% endhint %}

For companies that offer on call services to their customers it is quite a hassle to configure an on call schedule in their PBX. A bot with the Oncall Assistant template installed solves this issue quite easily.

After installing the skill you can simple add the node "Dial: On Call" to your flow and configure your agents and planning in the Content section of the platform. Using this approach even users without the right to edit your flows can change the On call schedule of your agents.

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

## Add Dial: On Call to your Flows

There will be a new flow node introduced to your bot called "Dial: on call". This node needs to be added to your flow in order to enable it.

1. Go to the Flows section of the platform
2. Find the place in your flow where you want to have the bot to dial the on call agent.
3. Click right mouse button, click on Dial and then on On call.
4. Now make sure your flow routes a link (Arrow) to your new Dial: on call node. In case this is the only node in your Flow, you need to connect it to the Entry trigger.
5. Open the side panel of the node by clicking on the title bar of the **Dial: On call** node.

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

6. Now fill in the text and the fallback number.
7. Now go to the Content section and add your agents to the **On-call Phonebook**.
8. Then configure who is available for on call services from when in the **On-call Schedule** page in the Content section.

<table><thead><tr><th width="140">Property</th><th>Description</th><th>Explanation</th></tr></thead><tbody><tr><td>SIP</td><td>The SIP method to use for dialing</td><td>Choose Refer</td></tr><tr><td>Text</td><td>The text the bot should say just before dialing</td><td>By embedding <strong>#{oncall_name}</strong> the name of the agent can be used in the text</td></tr><tr><td>Fallback</td><td>What number to dial when no schedule is found in the <a href="#oncall-assistant-schedule">Content</a> section</td><td></td></tr></tbody></table>

### Oncall Assistant Template

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

### Oncall Assistant Phonebook

In order for the On call function to work the system must know which agents there are to route the call to. The on call agents can be configured in the Content section.

1. Click on Content
2. Click on On-call Phonebook
3. Click Add

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

<table><thead><tr><th width="125">Property</th><th width="241">Description</th><th>Explanation</th></tr></thead><tbody><tr><td>Name</td><td>Name of the agent</td><td></td></tr><tr><td>Number </td><td>Number of the agent</td><td>Make sure to enable or disable the extension option depending on the number you need</td></tr><tr><td>Extension</td><td>Uncheck for public numbers</td><td>To make sure the number is validated on correctness</td></tr></tbody></table>

### Oncall Assistant Schedule

When the agents are configured we can configure the schedule. This will help the system to know when to route the call to which agent.

1. Click on Content
2. Click on On-call Schedule
3. Click Add

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

<table><thead><tr><th>Property</th><th>Description</th><th data-hidden>Explanation</th></tr></thead><tbody><tr><td>From</td><td>The date and time at which this schedule becomes active </td><td></td></tr><tr><td>Route to</td><td>The agent to route the call to</td><td></td></tr></tbody></table>

{% hint style="info" %}
The system always searches for the schedule that is closest to the current date time.
{% endhint %}


---

# 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://manuals.dialox.ai/store/legacy-apps/oncall-assistant.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.