# Import Exotel Phone Numbers (/docs/telephony/exotel-import)

> Seamlessly integrate your Exotel phone numbers with OmniDimension and set up intelligent call flows for your AI agents.







































This guide walks through importing Exotel phone numbers into OmniDimension so
your AI agents can handle incoming calls. You'll set up the necessary call
flows in Exotel and import them into OmniDimension for seamless integration.

## What you'll need [#what-youll-need]

Before you can import an Exotel phone number, you need to complete these
steps in your Exotel account:

* Create an account on [exotel.com](https://exotel.com)
* Complete KYC (Know Your Customer) verification by submitting required documents
* Purchase an Exophone number from your Exotel dashboard
* Create a call flow for your Exophone number (covered in step 4)
* Attach the call flow to your phone number

## Required credentials from Exotel [#required-credentials-from-exotel]

After completing the prerequisites, you'll need to collect these credentials
from your Exotel dashboard. You can find these in the **API Credentials**
section:

* **Exotel API Key**: Your authentication key for API access
* **Exotel API Token**: Your secure access token
* **Exotel Subdomain**: Your account's subdomain (e.g., `yourcompany.exotel.com`)
* **Exotel Account SID**: Your unique account identifier
* **Exotel Phone Number**: The phone number you want to import
* **Exotel App ID**: The call flow ID (you'll get this after creating your call flow)

## Setting up the call flow in Exotel [#setting-up-the-call-flow-in-exotel]

This is the most important part of the process. You'll create a call flow in
Exotel that connects to OmniDimension. Follow these steps carefully.

<Steps>
  <Step>
    ### Access App Builder [#access-app-builder]

    In your Exotel dashboard, go to the side menu and click on **App Builder**.

        <img alt="Navigate to App Builder" src="__img0" />
  </Step>

  <Step>
    ### Create new app [#create-new-app]

    Click on **Create New App** to start building your call flow.

        <img alt="Create New App" src="__img1" />
  </Step>

  <Step>
    ### Add Voicebot applet for "Call Comes" [#add-voicebot-applet-for-call-comes]

    On the **Call Comes** block, drag a **Voicebot** applet from the right
    sidebar. In the URL field, enter `wss://live.omnidim.io/media_exotel_community`
    and turn recording **ON**.

        <img alt="Add Voicebot Applet" src="__img2" />
  </Step>

  <Step>
    ### Add second Passthru applet [#add-second-passthru-applet]

    On the voicebot applet's next section, drag another **Passthru** applet. In
    the URL field, enter `https://live.omnidim.io/should_end_the_call`.

        <img alt="Add Second Passthru" src="__img3" />
  </Step>

  <Step>
    ### Add Hangup on 200 response [#add-hangup-on-200-response]

    In the 200 response of the second passthru applet, drag a **Hangup** applet
    to end the call when needed.

        <img alt="Add Hangup on 200" src="__img4" />
  </Step>

  <Step>
    ### Add Connect on 302 response [#add-connect-on-302-response]

    In the 302 response of the second passthru applet, drag a **Connect** applet
    for call transfers.

        <img alt="Add Connect on 302" src="__img5" />
  </Step>

  <Step>
    ### Configure Connect applet [#configure-connect-applet]

    In the connect applet, select **Primary URL** and enter
    `https://live.omnidim.io/call_transfer`.

        <img alt="Configure Connect Applet" src="__img6" />
  </Step>

  <Step>
    ### Add Passthru for call end [#add-passthru-for-call-end]

    For the **After the call conversation ends** option, add a passthru applet
    with URL `https://live.omnidim.io/should_end_the_call?omni_status=call_end`.

        <img alt="Add Passthru for Call End" src="__img7" />
  </Step>

  <Step>
    ### Add Passthru for no answer [#add-passthru-for-no-answer]

    For the **If nobody answers** option, add a passthru applet with URL
    `https://live.omnidim.io/should_end_the_call?omni_status=nobody_ans`.

        <img alt="Add Passthru for No Answer" src="__img8" />
  </Step>

  <Step>
    ### Add Passthru for no dial [#add-passthru-for-no-dial]

    For the **We didn't dial anyone** option, add a passthru applet with URL
    `https://live.omnidim.io/should_end_the_call?omni_status=didnt_dial_anyone`.

        <img alt="Add Passthru for No Dial" src="__img9" />
  </Step>

  <Step>
    ### Add Hangup applets [#add-hangup-applets]

    On all the passthru applets you just created, add a **Hangup** applet in
    both 200 and 302 responses to ensure calls end properly.

        <img alt="Add Hangup Applets" src="__img10" />
  </Step>

  <Step>
    ### Save your call flow [#save-your-call-flow]

    Click **Save** to save your call flow configuration and close the flow
    builder. Make sure to note down the App ID (call flow ID) as you'll need it
    for the import process.

        <img alt="Save Call Flow" src="__img11" />
  </Step>

  <Step>
    ### Attach call flow with your Exophone number [#attach-call-flow-with-your-exophone-number]

    Go to **Exophone**, buy a number, and attach the call flow you just created.
    Make sure to note down the phone number as you'll need it for the import
    process.

        <img alt="Attach Call Flow" src="__img12" />
  </Step>
</Steps>

## Important notes about call flow setup [#important-notes-about-call-flow-setup]

* The Voicebot applet will only be visible after you complete KYC verification
* If you don't see the Voicebot applet after KYC, contact Exotel support
* Make sure all URLs are entered exactly as shown (no extra spaces or characters)
* Test your call flow in Exotel before importing to OmniDimension
* Save your App ID (call flow ID); you'll need it for the import process

## Import to OmniDimension [#import-to-omnidimension]

Now that your call flow is set up in Exotel, import your phone number into
OmniDimension.

<Steps>
  <Step>
    ### Navigate to Phone Numbers [#navigate-to-phone-numbers]

    In your OmniDimension dashboard, go to the **Phone Numbers** section from the
    main navigation menu.

        <img alt="Phone Numbers Section" src="__img13" />
  </Step>

  <Step>
    ### Click "Import Exotel Phone Number" [#click-import-exotel-phone-number]

    Look for the **Import Exotel Phone Number** button and click on it to open
    the import form.

        <img alt="Import Button" src="__img14" />
  </Step>

  <Step>
    ### Fill in the import form [#fill-in-the-import-form]

    Enter all the credentials you collected from your Exotel dashboard in the
    form fields:

    * Exotel API Key
    * Exotel API Token
    * Exotel Subdomain
    * Exotel Account SID
    * Exotel Phone Number
    * Exotel App ID (your call flow ID)

        <img alt="Import Form" src="__img15" />
  </Step>

  <Step>
    ### Complete the import [#complete-the-import]

    Click the **Import** button to complete the process. Your Exotel phone
    number will now appear in your OmniDimension dashboard and be ready for use
    with your AI agents.

        <img alt="Success Import" src="__img16" />
  </Step>
</Steps>

## Understanding the call flow [#understanding-the-call-flow]

Here's how your call flow works after setup. When someone calls your Exotel
number:

* The call first goes to OmniDimension's `call_coming` endpoint
* OmniDimension then connects to your AI agent through the voicebot
* Your AI agent handles the conversation
* When the call should end, it goes to the `should_end_the_call` endpoint
* If a transfer is needed, it goes to the `call_transfer` endpoint
* All calls eventually end with a hangup action

<img alt="Complete call flow overview" src="__img17" />

## What happens after import [#what-happens-after-import]

Once your phone number is successfully imported, you can:

* Use the phone number with any of your AI agents
* Receive incoming calls that are automatically handled by your agents
* Monitor call logs and performance in your dashboard

## Next steps [#next-steps]

* Configure your AI agents to handle calls effectively
* Attach the Exotel phone number to your agent
* Test your setup by making a test call to your number

## Troubleshooting common issues [#troubleshooting-common-issues]

* **Voicebot applet not visible**: Make sure you've completed KYC verification. If still not visible, contact Exotel support.
* **Import fails**: Double-check all credentials are correct and your call flow is properly configured.
* **Calls not connecting**: Verify your call flow URLs are correct and your OmniDimension account is active.
* **Call hangup on connect**: Make sure all URLs are entered exactly as shown with no extra spaces.
* **KYC issues**: Contact Exotel support if you're having trouble with the verification process.

## Getting help [#getting-help]

* [Exotel Documentation](https://developer.exotel.com/applet#voicebot)
* [OmniDimension Discord](https://discord.gg/kdjzykMTHJ)
* [OmniDimension Support](mailto:support@omnidim.io)