# Exotel Cellular Calling - Setup Guide

{% hint style="info" %}
This integration facilitates the Virtual Number/IVR cellular calling solution, offering seamless connectivity and efficient call management.
{% endhint %}

***

## Integration Steps

{% hint style="info" %}
Initiate a mail with the Exotel support team to enable V3 Active Legs API and "Listen barge APIs", as these are essential for ticket creation and webhook handling.
{% endhint %}

### Inbox Creation

To create a Exotel Voice inbox:

{% stepper %}
{% step %}
Go to Settings Section → Inboxes Section → Add Inbox Button → Voice channel → Exotel

<figure><img src="/files/VMvJRBORxHnzYlPXcPEs" alt="" width="563"><figcaption></figcaption></figure>

{% endstep %}

{% step %}
You will be required to fill the following credentials:

2.1. **Inbox Name** (*This is only for internal purposes and will not be visible to your customers)*

2.2. **API Key**

2.3. **Api token**

2.4. **Subdomain**

2.5. **Account SID**

2.6. **Virtual Number(s)**: *you can enter multiple virtual numbers*

<figure><img src="/files/MsDEnlgtKTv7Ut6tIngW" alt="" width="563"><figcaption></figcaption></figure>

1.

<figure><img src="/files/YPhbTJWhloq1bxpxUQZT" alt="" width="563"><figcaption></figcaption></figure>

{% endstep %}

{% step %}
**How to fetch these details:** Navigate to the Exotel Dashboard

1. Method 1: Go to “**Developers**” in the right hand panel, this will redirect you to a page where all these details are present
2. Method 2: Click on "API Credentials" button, which will redirect you to the same page
   {% endstep %}

{% step %}
Clicking the **Create Inbox** button will generate an Exotel Voice Inbox and take you to the next step of adding agents. Add agents&#x20;

<figure><img src="/files/G7t8AgXebqRRWHzDykfO" alt="" width="563"><figcaption></figcaption></figure>

{% endstep %}

{% step %}
Once the agents are added, you need to add agents’ mobile numbers which they use to attend calls (same as the ones configured in Exotel Agent Settings) by using one of given ways:

5.1. Account Administrators use Agent Settings: \
Settings Section → Agents Section → Edit Agent

<figure><img src="/files/H0lA990rc1LahZ19jjcj" alt="" width="563"><figcaption></figcaption></figure>

5.2. Agents use their Profile Settings:

<figure><img src="/files/oovFrhn9MNihUbhJGVBh" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Phone numbers must start with the country code **without** `+` sign.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Enabling Incoming Webhooks from Exotel Dashboard

{% stepper %}
{% step %}
Go to Exotel Dashboard
{% endstep %}

{% step %}
Click on **App bazaar**

<figure><img src="/files/vVY7woEDvP7TPVSBBTax" alt="" width="563"><figcaption></figcaption></figure>

{% endstep %}

{% step %}
On this page, either **create a new app** or **edit** an existing one if you already have an app<br>

<figure><img src="/files/enLy1ocMgMgcDUMvO7iz" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Flow to be created:

**4.1. Call Start**: *This defines what should be done when a call starts*

4.2. Add a "Greeting" Voice applet

**4.2.1**. In the greeting voice applet, choose an audio to be played when a caller reaches this step

<figure><img src="/files/dnMHaG6iUGsdFA1UDZIs" alt="" width="563"><figcaption></figcaption></figure>

**4.2.2**. In the next step, add a 'Connect' voice applet. This applet consists of multiple configurations; choose the following options for this setup.<br>

<table><thead><tr><th>Parameters</th><th>Value to be filled</th><th data-hidden></th></tr></thead><tbody><tr><td>How do you want to control your Connect params? </td><td>Configure using flow builder here</td><td></td></tr><tr><td>Dial Whom</td><td>Dial a user or group (And select the relevant group)</td><td></td></tr><tr><td>Distribute Calls</td><td>Choose between "Sequentially" and "Equally" as per your requirement.</td><td></td></tr><tr><td>Record this call?</td><td>Enable this if you want to get a recording of the calls</td><td></td></tr><tr><td>Create popup</td><td>Enter the following endpoint here: <a href=" https://messaging.limechat.ai/webhooks/v1/exotel.get-event">https://messaging.limechat.ai/webhooks/v1/exotel.get-event</a></td><td></td></tr></tbody></table>
{% endstep %}

{% step %}
After the call conversation ends

1. Add a "passthrough" applet

   1. In the Pass through applet add the following endpoint&#x20;
   2. Enable Make Passthru Async

   <figure><img src="/files/nkbqXHBWgwhdxp6wz7BA" alt="" width="563"><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Save this app

{% endstep %}
{% endstepper %}

***

## Connecting Apps with ExpPhones

{% stepper %}
{% step %}
Navigate to ExoPhone
{% endstep %}

{% step %}
Edit the "Installed App" and select the required app from the dropdown

<figure><img src="/files/ZmfLGr6KJ9ui5NiYQV5Z" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

This completes the setup process.

***


---

# 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://limechatai.gitbook.io/limechat-product-guide/helpdesk/inboxes/voice-calling-inboxes/exotel-cellular/exotel-cellular-calling-setup-guide.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.