> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/ai-agents/creating-ai-agents-in-botpenguin/install-ai-agents/install-agents-on-phone-number.md).

# Install Agents on Phone Number

### What is AI Agent Phone Number Installation?

AI Agent Phone Number Installation allows you to connect your AI agents to phone numbers so they can handle incoming and outgoing calls. It enables you to provide voice-based customer support, automate call handling, and manage customer interactions through your deployed AI agents across different telecom platforms.

***

### When should you use this?

Use this feature when:

* You want to deploy your AI agent to handle phone calls
* You need to connect your agent to a specific phone number
* You are trying to enable voice-based automation for customer support
* You require integration with third-party telecom providers (Plivo or Twilio)

***

### Benefits of AI Agent Phone Number Installation

* 🎯 Enables voice-based customer interactions with your AI agent
* ⏱️ Reduces manual call handling and support time
* 🌐 Integrates seamlessly with Plivo or Twilio platforms
* 🔄 Automates incoming and outgoing call management
* 📞 Provides multi-channel support (voice calls) for customers

***

### Expected Outcome

After setting this up:

* Your AI agent will be able to receive and respond to phone calls
* You will have a fully functional voice channel connected to your phone number
* Users will experience automated voice interactions with your AI agent

{% hint style="info" icon="lightbulb" %}
**Tip**: Your phone number will be live and ready to receive calls once the confirmation message appears. The entire setup process typically takes up to 30 seconds.
{% endhint %}

***

### How to Install AI Agent on Phone Number

1. Navigate to your AI agent and click on the **"Install"** option from the menu.

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

2. From the installation options, select **"Phone Number"**.

<figure><img src="/files/0ToF4kECbMbMW8bbqNqu" alt=""><figcaption></figcaption></figure>

3. Choose your preferred telecom platform: either **"Plivo"** or **"Twilio"**, then click **"Next"**.

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

4. Once selected, we will have 3 methods to complete the installation.&#x20;
   1. Let Team Install
   2. Install Myself
   3. Choose Existing Number

{% hint style="info" icon="lightbulb" %}
**Tip**: Refer to the platform-specific documentation links provided in the interface for detailed setup instructions for your chosen provider. Links present at the bottom of the page.
{% endhint %}

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

***

### Installation Method 1: Let Team Install (Standard Method)

1. In the **"Let Team Install"** section, enter all required authentication information in the provided fields:
   1. Account ID
   2. Auth Token
   3. Trunk Name
   4. Phone Number
   5. Username
   6. Password
2. Click **"Install"** to submit your phone number configuration.

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

3. Wait for the confirmation message. This setup process can take up to 30 seconds. Once confirmed, your phone number will be successfully connected to your AI agent.

***

### Installation Method 2: Install Yourself

1. In the **"Install Yourself"** section, enter all the same authentication details as Method 1:
   1. Phone Number
   2. Termination URL
   3. Username
   4. Password

{% hint style="info" icon="lightbulb" %}
**Tip**: Refer to the platform-specific documentation links provided at the bottom of the page to obtain the information from Plivo or Twilio.
{% endhint %}

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

2. Click **"Configure"** to complete the installation.

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

***

### Installation Method 3: Connect Already Existing Number

{% hint style="info" %}
Use this method if you have already configured your telecom platform (Plivo or Twilio) and want to connect an existing number.
{% endhint %}

1. Go to the **"Integrations"** section by clicking on the **"More"** module.

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

2. Click on either **"Plivo"** or **"Twilio"** depending on your platform.
3. Follow the process highlighted in the documentation to connect your chosen platform. Ensure your integration is successfully completed.
   1. [Twilio Integration Documentation](/settings/integrations/twilio.md)
   2. [Plivo Integration Documentation](/settings/integrations/plivo.md)
4. Return to the Phone Number -> Install Agent installation section.

<figure><img src="/files/6oei8SOKC87PmXWQioJI" alt=""><figcaption></figcaption></figure>

5. In the dropdown menu, select the configuration that you want to connect.
6. Click **"Connect"** to link your existing number to your AI agent.

<figure><img src="/files/1NG8F5XFyzusJlnjplTf" alt=""><figcaption></figcaption></figure>

**7.** Wait for the confirmation message. Your existing phone number will now be connected to your AI agent.

***

### Best Practices

> 💡 Ensure all authentication credentials are accurate before clicking update to avoid connection delays

> ⚠️ Keep your Auth ID and Auth Token secure; do not share them with unauthorized users

> 🚀 Test your phone number with a sample call after installation to verify proper connection

> 🎯 Choose the telecom platform (Plivo or Twilio) that best fits your business requirements and existing integrations

***

### Troubleshooting

<details>

<summary><strong>Installation takes longer than 30 seconds or times out</strong></summary>

**Solution:**

* Check your internet connection.
* Verify that all authentication credentials are correct.
* If the issue persists, refresh the page and resubmit your information.

</details>

<details>

<summary><strong>Phone number fails to connect after entering credentials</strong></summary>

**Solution:**

* Confirm that your **Auth ID**, **Auth Token**, **Trunk Name**, and other credentials exactly match your telecom provider's account settings.
* Refer to your provider's documentation (Plivo or Twilio) to verify the credentials.

</details>

<details>

<summary><strong>Incoming calls are not reaching the AI agent</strong></summary>

**Solution:**

* Verify that the correct phone number is associated with your AI agent.
* Ensure that the installation confirmation message was received.
* Check that the AI agent is active and ready to receive calls from the dashboard.

</details>

***

## FAQs

<details>

<summary><strong>What telecom platforms does BotPenguin support for phone number installation?</strong></summary>

BotPenguin currently supports **Plivo** and **Twilio**. You can choose either platform during the installation process based on your business requirements and existing telecom setup.

</details>

<details>

<summary><strong>How long does it take for the phone number to be connected?</strong></summary>

The installation process typically completes within **30 seconds**. Once the confirmation message appears, your phone number is successfully connected and ready to receive calls.

</details>

<details>

<summary><strong>Where can I find my Auth ID and Auth Token?</strong></summary>

Your **Auth ID** and **Auth Token** are available in your telecom provider's dashboard (Plivo or Twilio). You can also refer to the provider's documentation linked within the BotPenguin interface.

</details>

<details>

<summary><strong>Can I change the telecom platform after installation?</strong></summary>

Yes. You can reinstall your phone number using a different provider by selecting **Install** again and completing the setup with the new provider's credentials.

</details>

<details>

<summary><strong>What information is required to complete the phone number installation?</strong></summary>

Depending on your selected telecom provider, you may need:

* Auth ID
* Auth Token
* Trunk Name
* Username
* Password
* Other provider-specific credentials

The exact fields may vary between Plivo and Twilio.

</details>

<details>

<summary><strong>What should I do if I receive an error message during installation?</strong></summary>

* Verify that all credentials are correct.
* Ensure your internet connection is stable.
* Retry the installation.
* If the issue continues, contact BotPenguin Support.

</details>

<details>

<summary><strong>Can I install multiple phone numbers on the same AI agent?</strong></summary>

Yes. You can connect multiple phone numbers to the same AI agent by repeating the installation process for each phone number.

</details>

<details>

<summary><strong>How do I verify that my phone number is correctly installed?</strong></summary>

After the installation is complete:

1. Wait for the confirmation message.
2. Place a test call to the connected phone number.
3. If your AI agent answers the call, the installation was successful.

</details>

<details>

<summary><strong>What happens if I lose connection during the installation process?</strong></summary>

If your internet connection is interrupted:

* Refresh the page.
* Check whether the installation was completed.
* If necessary, repeat the installation process using the same credentials.

</details>

<details>

<summary><strong>Is there a cost associated with phone number installation?</strong></summary>

Installing a phone number in BotPenguin does not incur an additional installation fee. However, you must have an active account with **Plivo** or **Twilio**, and their standard telephony charges will apply.

</details>

***

### Related Articles

{% content-ref url="/pages/SkId1cEF6WPAeU3bLx1z" %}
[Ai Agents](/ai-agents/creating-ai-agents-in-botpenguin.md)
{% endcontent-ref %}

{% content-ref url="/pages/llGSeIT33nmHxeNc9lyR" %}
[Advance AI Settings](/ai-agents/creating-ai-agents-in-botpenguin/advance-ai-settings.md)
{% endcontent-ref %}

{% content-ref url="/pages/buzXAr593ZbakFuYtFeK" %}
[Twilio](/bots/sms-bot/install-sms-bot/twilio.md)
{% endcontent-ref %}

{% content-ref url="/pages/WEfeDWTi6hU5sZOf7u8U" %}
[Plivo](/settings/integrations/plivo.md)
{% endcontent-ref %}

***

### Support

If you still have questions for our team, write to us at **<support@botpenguin.com>**. We'll get back to you within 48 hours.

***

### 🎉 Completion

🎉 Congratulations, you have successfully completed this section! Your AI agent is now ready to handle phone calls. You're one step closer to mastering BotPenguin.