# Dial: Number

Voice Bots are able to dial out to forward the conversation to another number or extension.

Dialing can be done in two different ways:

* invite: the call is handed over, but if it fails, it returns
* refer: the call is immediately handed over and will not return

<figure><img src="/files/4GGvQ2SXDHdNyQJUQJJf" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Note that if a dial is done using an SIP invite, the Bot will remain on the call, adding to the billing of this call. An SIP refer will stop incurring cost after the handover. Therefore, the node will be configured with SIP refer by default.
{% endhint %}

The following properties can be configured for this node type.

| Property    | Description                                         | Explanation                                                                                                                                                                                                                                          |
| ----------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| destination | The destination type for the call (default)         | <p>"Default" to dial the following number in any situation.</p><p>"Contact based alternatives" to dial a number that is based on user data (a specific contact field).</p><p>"Number from variable" to fetch the number to dial from a variable.</p> |
| number      | The number to call                                  | Using the extension checkbox, a non-ISO phone number can be provided. This way extension numbers are valid to enter.                                                                                                                                 |
| variable    | The variable in which the number is stored          | The variable picker allows you to select an existing variable or create a new one.                                                                                                                                                                   |
| exceptions  | Option to use another number based on certain rules | Currently only the option "contact based" is offered to select a number based on the value of a specific contact field, like "segment" or "country", etc.                                                                                            |
| SIP         | The method for dialing                              | See above.                                                                                                                                                                                                                                           |
| Timeout     | Time in seconds                                     | Only works for SIP invite.                                                                                                                                                                                                                           |

### Contact based alternatives

If a different number should be dialed for specific users (Contacts), the destination field should be configured with the value "contact based alternatives". This adds a button to add Alternatives based on specific contact field values.

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

In the above example there are three alternative numbers based on the contact field "segment". If none of the alternatives match (so the current caller doesn't have "A", "B" or "C" in the field "segment" in this example), the default number will be used. Otherwise it will use the number corresponding to the matching alternative.

{% hint style="info" %}
Instead of `segment`, used as example above, any other field can be used. For instance `first_name` or `last_name` if you want to dial another number based on someone's name.
{% endhint %}

The field `segment` used in the above example should be present in the Contacts database in order for the example to work. The field `segment` should therefore first be added in the contact definition. This can be done in Settings -> Studio

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

This will add a column in the Contacts list:

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

Which can be edited in the side bar:

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

## Resources

* [Phone flows](/store/skills/phone-flows.md)


---

# 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/studio/flows/nodes/dial-number.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.