<!-- Source: https://docs.vinsi.ai/phone-connections/telnyx -->
# Connect Telnyx

Use Telnyx numbers with VINSI AI agents — either numbers you buy inside VINSI, or numbers in your own Telnyx account.

Created: September 18, 2026

Updated: September 18, 2026

## Overview

VINSI's own phone numbers run on the Telnyx network, so there are two situations:

| Your numbers are…          | What to do                                                                               |
| -------------------------- | ---------------------------------------------------------------------------------------- |
| Bought in VINSI            | Nothing to connect. They're already on Telnyx and fully set up.                          |
| In your own Telnyx account | Connect them with a SIP trunk, below. They stay in your account and on your Telnyx bill. |

## Numbers Bought in VINSI

On the **Phone Numbers** page, click **Add Phone Number**, search by area code, and pick a number. Each number is **$3/month**, billed separately. VINSI sets up incoming calls, outgoing calls and call recording for you. Then assign it to an agent — see [Setting Up Phone Numbers](https://docs.vinsi.ai/ai-phone-agents/setting-up-phone-numbers).

Numbers hosted by VINSI are signed with the highest STIR/SHAKEN verification level, which helps keep outgoing calls from being labelled “Spam Likely”.

## Your Own Telnyx Account

You'll create a SIP connection in Telnyx that sends incoming calls to VINSI and lets VINSI place outgoing calls with a username and password. Before you start, open VINSI's **Phone Numbers** page and click **Add SIP Trunk**: the **Configure SIP Trunk** window shows your **Origination SIP URI** under _Inbound Call Setup_.

Telnyx renames its portal menus from time to time. If a label below doesn't match, look for the setting described next to it — the values you need don't change.

### 1\. Set Up the Telnyx Connection

1. In the [Telnyx Portal](https://portal.telnyx.com), go to **Voice → SIP Trunking** and create a new connection named, for example, _VINSI AI_.
2. **Inbound:** set the connection to deliver calls to the host in VINSI's Origination SIP URI (the part after `sip:`), on port 5060.
3. **Outbound:** turn on **credential authentication** and set a username and password. Save the password somewhere safe.
4. Create or choose an **Outbound Voice Profile** that allows the countries you'll call, and assign the connection to it. Telnyx won't place outgoing calls on a connection without one.

**Authenticate with a username and password, not by IP address.** VINSI's outgoing calls don't always come from the same IP address, so IP-only authentication will reject some calls.

### 2\. Point Your Number at It

In **Numbers → My Numbers**, open your number and set its connection to the one you just created.

### 3\. Connect It in VINSI

In VINSI's **Configure SIP Trunk** window, fill in:

| Field               | What to enter                                         |
| ------------------- | ----------------------------------------------------- |
| Trunk Name          | Any name, e.g. _Telnyx – Main line_.                  |
| Phone Number        | Your Telnyx number in full format, e.g. +18005551234. |
| SIP Termination URI | sip:sip.telnyx.com                                    |
| SIP Username        | The username from step 1.                             |
| SIP Password        | The password from step 1.                             |

Click **Configure Trunk**, then assign the number to an agent — see [Setting Up Phone Numbers](https://docs.vinsi.ai/ai-phone-agents/setting-up-phone-numbers).

### 4\. Test

- **Incoming:** call the number from your mobile. The AI agent should answer.
- **Outgoing:** open the agent and click **Call Me** to have the AI ring your phone.
- **Transfer:** ask the AI to transfer you, and check the call reaches the right person.

Each test call appears in **Call Logs** with its recording and transcript.

## Troubleshooting

| Problem                                          | Check                                                                                                                                                                |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Incoming calls don't reach the AI                | The number is assigned to the new connection in Telnyx; the connection sends inbound calls to VINSI's origination host; the number is assigned to an agent in VINSI. |
| The AI can't call out                            | The connection has an Outbound Voice Profile; credential authentication is on; the username and password in VINSI match.                                             |
| Calls to some countries fail                     | Add those destinations to the Outbound Voice Profile's allowed countries.                                                                                            |
| _Please enter a valid E.164 format phone number_ | Enter the number as +1 followed by 10 digits. The form takes US and Canada numbers.                                                                                  |