Vapi - VoIP.ms Wiki

Check out our YouTube channel to watch our simple tutorials that will help you set up most of our features.

Vapi

From VoIP.ms Wiki

(Difference between revisions)
Jump to: navigation, search
[checked revision][quality revision]
(Gathering the info to configure the DID on VoIP.ms)
 
(10 intermediate revisions not shown)
Line 12: Line 12:
== VoIP.ms Sub Account configuration ==
== VoIP.ms Sub Account configuration ==
-
: To register a SIP trunk in Vapi you will need a sub-account. To create a Sub Account, in your VoIP.ms Customer Portal go to '''Sub Accounts >> Create Sub Account'''.
+
: To register a SIP trunk in Vapi you will need a Sub Account. To create one, in your VoIP.ms Customer Portal go to '''Sub Accounts >> Create Sub Account'''.
=== Creating a Sub Account for Vapi ===
=== Creating a Sub Account for Vapi ===
Line 19: Line 19:
:: 1.1 '''Protocol''': SIP
:: 1.1 '''Protocol''': SIP
-
:: 1.2 '''Authentication type''': User/Password Authentication
+
:: 1.2 '''Authentication type''': Static IP Authentication
:: 1.3 '''Username''': Any name of your choice (E.g. 100000_Vapi)
:: 1.3 '''Username''': Any name of your choice (E.g. 100000_Vapi)
-
:: 1.4 '''Password''': Any password that meets the security requirements (Minimum 15 characters. Upper case, lower case, numbers and special characters are required)
+
:: 1.4 '''IP Address or Fully Qualified Domain Name''': sip.vapi.ai <i>(Use this for now, we will have to add an UUID generated by Vapi later)</i>
:: 1.5 '''Device type''': Asterisk, IP PBX, Gateway or VoIP Switch
:: 1.5 '''Device type''': Asterisk, IP PBX, Gateway or VoIP Switch
:: 1.6 '''CallerID Number''': I use a system capable of passing its own CallerID.
:: 1.6 '''CallerID Number''': I use a system capable of passing its own CallerID.
Line 30: Line 30:
== Vapi configuration ==
== Vapi configuration ==
-
:To use Vapi with VoIP.ms you will need to add a '''Custom SIP Trunk'''. For this, you will need your Sub Account username, password, and the IP address of your preferred VoIP.ms Point of Presence.
+
:To use Vapi with VoIP.ms you will need to add a '''Custom SIP Trunk'''. To do it, you will need your Sub Account username and the IP address of your preferred VoIP.ms Point of Presence.
=== Adding the SIP trunk ===
=== Adding the SIP trunk ===
Line 37: Line 37:
:: 1. Log into your Vapi's dashboard: [https://dashboard.vapi.ai/ Vapi - Dashboard]
:: 1. Log into your Vapi's dashboard: [https://dashboard.vapi.ai/ Vapi - Dashboard]
-
:: 2. Open the sidebar, and click on your username at the bottom.
+
:: 2. Open the sidebar, and click on your username.
:: 3. Click on '''Settings'''.
:: 3. Click on '''Settings'''.
:: 4. Click on '''Integrations'''.
:: 4. Click on '''Integrations'''.
-
:: 5. On the list of integrations search for '''SIP Trunk Credentials'''.
+
:: 5. On the list of integrations search for '''SIP Trunk'''.
:: 6. Click on '''+ Configure New SIP Trunk'''.
:: 6. Click on '''+ Configure New SIP Trunk'''.
Line 49: Line 49:
:: 1. '''Name''': Any name of your choice (E.g. VoIPms trunk)
:: 1. '''Name''': Any name of your choice (E.g. VoIPms trunk)
-
:: 2. '''IP address/domain''': Your Preferred VoIP.ms POP Server IP address (E.g. For example, for losangeles.voip.ms use 208.100.60.38).
+
:: 2. '''IP address/domain''': Your Preferred VoIP.ms POP Server IP address (E.g. For example, for losangeles4.voip.ms use 208.100.60.38).
<div style="margin-left:50px;  
<div style="margin-left:50px;  
Line 65: Line 65:
:: 3. '''Port''': 5060.
:: 3. '''Port''': 5060.
:: 4. '''Netmask''': 24.
:: 4. '''Netmask''': 24.
-
:: 5. '''Outbound Protocol''': UDP.
+
:: 5. '''Outbound Protocol''': UDP or TCP.
:: 6. '''Allow inbound calls''': Checked.
:: 6. '''Allow inbound calls''': Checked.
:: 7. '''Allow outbound calls''': Checked (if needed).
:: 7. '''Allow outbound calls''': Checked (if needed).
-
:: 8. ''Username''': Your VoIP.ms Sub Account username (E.g. 100000_Vapi).
+
:: 8. '''Username''': Your VoIP.ms Sub Account username (E.g. 100000_Vapi).
-
:: 9. ''Password''': Your VoIP.ms Sub Account password.
+
:: 9. '''Password''': Leave empty.
-
:: 10. '''Use SIP Registration''': Checked.
+
:: 10.'''Use SIP Registration''': Unchecked.
-
:: 11. '''Domain''': Same as '''2. IP address/domain'''.
+
:: 11. Click on '''+ Save SIP Trunk'''.
-
:: 12. '''Username''': Same as '''8. Username'''.
+
-
:: 13. '''Realm''': Same as '''2. IP address/domain'''.
+
-
:: 14. Click on '''+ Save SIP Trunk'''.
+
-
: [[File:vapi-sip-trunk-configuration-1.png|border|400px]]  [[File:vapi-sip-trunk-configuration-2.png|border|400px]]
+
: [[File:vapi-sip-trunk-configuration-1.png|border|400px]]  [[File:Vapi-sip-trunk-configuration-2.2.png|border|400px]]
=== Adding a Phone Number ===
=== Adding a Phone Number ===
Line 111: Line 108:
: [[File:vapi-phone-number-3.png|border|600px]]
: [[File:vapi-phone-number-3.png|border|600px]]
-
== VoIP.ms SIP URI ==
+
<!-- == VoIP.ms SIP URI ==
-
: In order to receive calls on Vapi with your VoIP.ms number, you will use need to configure a SIP URI to redirect the calls from your DID number to your Vapi's SIP trunk.
+
: In order to receive calls on Vapi with your VoIP.ms number, you will need to configure a SIP URI to redirect the calls from your DID number to your Vapi's SIP trunk.
=== Create a SIP URI ===
=== Create a SIP URI ===
Line 119: Line 116:
: Follow these steps to configure the SIP URI:
: Follow these steps to configure the SIP URI:
-
:: 1. Log into your '''VoIP.ms Customer Portal'''.
+
:: 1. Log into your [https://voip.ms/signin/index.php VoIP.ms Customer Portal].
:: 2. Go to '''DID Numbers >> SIP URI'''.
:: 2. Go to '''DID Numbers >> SIP URI'''.
:: 3. Click on '''Add SIP URI'''.
:: 3. Click on '''Add SIP URI'''.
 +
 +
: Configure the SIP URI using these parameters:
 +
:: 4. '''SIP URI''': Define a SIP URI in this format -> +1{DID}@{PHONE NUMBER UUID}.sip.vapi.ai (E.g. [email protected])
:: 4. '''SIP URI''': Define a SIP URI in this format -> +1{DID}@{PHONE NUMBER UUID}.sip.vapi.ai (E.g. [email protected])
:: 5. '''Description''': Any description of your choice.
:: 5. '''Description''': Any description of your choice.
Line 129: Line 129:
-
: [[File:vapi-did-sip-uri.png|border|800px]]
+
: [[File:vapi-did-sip-uri.png|border|800px]] -->
-
=== Route your DID to the SIP URI ===
+
== VoIP.ms DID configuration ==
 +
 
 +
: To make VoIP.ms successfully route the calls to the trunk in Vapi you need to add the UUID to the Sub Account's domain used for IP Authentication and then route  the DID to the Sub Account.
 +
 
 +
=== Adding the UUID to the Sub Account ===
 +
 
 +
: Next you need to update the FQDN of the Sub Account by adding the UUID.
 +
 
 +
: Follow these steps to do it.
 +
 
 +
:: 1. Log into your [https://voip.ms/signin/index.php VoIP.ms Customer Portal].
 +
:: 2. Go to '''Sub Accounts >> Manage Sub Accounts'''.
 +
:: 3. Click on '''Edit''' for the Sub Account you created and configured for Vapi.
 +
:: 4. On the field '''IP Address or Fully Qualified Domain Name''' paste the UUID at the beginning of the domain sip.vapi.ai. It will look something like <i>a81bc81b-dead-4e5d-abff-90865d1e13b1.sip.vapi.ai</i>
 +
:: 5. Click on '''Update Account'''.
 +
 
 +
<!-- === Route your DID to the SIP URI ===
: Once the SIP URI is ready, all you need to do is route your DID number to the SIP URI you created to redirect the calls to your Vapi's trunk.
: Once the SIP URI is ready, all you need to do is route your DID number to the SIP URI you created to redirect the calls to your Vapi's trunk.
Line 142: Line 158:
-
That's it! Now the calls to your DID will be answered by your Vapi's AI Assistant.
+
That's it! Now the calls to your DID will be redirected to Vapi and answered by your Vapi's AI Assistant. -->
 +
 
 +
=== Route your DID to the Sub Account ===
 +
 
 +
: Once the Sub Account is ready, all you need to do is route your DID number to this so the calls connect to your Vapi's trunk.
 +
 
 +
:: 1. Go to '''DID Numbers >> Manage DIDs'''.
 +
:: 2. Click on '''Edit''' for the DID number you added to Vapi.
 +
:: 3. '''Main Routing''': Select '''SIP/IAX''' and from the list the Sub Account you added for Vapi.
 +
:: 4. '''DID Point of Presence''': Make sure is the same server you used in the Vapi's SIP Trunk configuration.
 +
:: 5. '''Dialing Mode for Inbound Calls''': E164
 +
:: 6. '''Apply changes''' when done.
 +
 
 +
 
 +
That's it! Now the calls to your DID will be redirected to Vapi and answered by your Vapi's AI Assistant.
 +
 
 +
 
 +
<div style="margin-left:50px;
 +
            padding:5px;
 +
            border-left: 6px solid rgb(208, 56, 45, 0.8);
 +
            box-shadow: 8px 6px 9px -2px #f2f2f2;
 +
            background-color: rgba(208, 56, 45, 0.08);
 +
            width:70vw;">
 +
🚨 '''Using multiple DIDs'''
 +
: If you add more numbers to Vapi just route them in VoIP.ms to the same Sub Account. You don't need to add one Sub Account for each.
 +
: Each number in Vapi will have their own UUID, however, you only need to use one of them in your Sub Account's configuration.
 +
 
 +
: However, this is something that depends on how Vapi works. As of now thi has been confirmed to work by the VoIP.ms team by the time this part of the Wiki Article was updated (2/5/2026) but this could change if Vapi make changes on their side.
 +
</div>
 +
 
 +
== Outbound calls ==
 +
 
 +
Coming soon!
 +
 
 +
<div style="margin-left:50px;
 +
            padding:5px;
 +
            border-left: 6px solid rgb(208, 56, 45, 0.8);
 +
            box-shadow: 8px 6px 9px -2px #f2f2f2;
 +
            background-color: rgba(208, 56, 45, 0.08);
 +
            width:70vw;">
 +
🚨 '''Outgoing calls'''
 +
::Outbound calls from Vapi are currently not guaranteed.
 +
 
 +
::We are checking with Vapi.ai to find the right configuration to make outgoing calls work.
 +
</div>
== Useful resources ==
== Useful resources ==
Vapi's documentation: [https://docs.vapi.ai/advanced/sip/sip-trunk SIP Trunking]
Vapi's documentation: [https://docs.vapi.ai/advanced/sip/sip-trunk SIP Trunking]

Latest revision as of 16:26, 5 February 2026

Vapi


Vapi is a platform for building, testing, and deploying voice AI agents. It provides the infrastructure necessary for businesses to create custom voice assistants that can handle call operations for existing customer support, appointment booking, and sales calls, or for building new products using voice AI like prior authorization and product onboarding assistants.

For more details or to sign up to Vapi, visit: Vapi.api


Contents


VoIP.ms Sub Account configuration

To register a SIP trunk in Vapi you will need a Sub Account. To create one, in your VoIP.ms Customer Portal go to Sub Accounts >> Create Sub Account.

Creating a Sub Account for Vapi

Use these parameters for the Sub Account:
1.1 Protocol: SIP
1.2 Authentication type: Static IP Authentication
1.3 Username: Any name of your choice (E.g. 100000_Vapi)
1.4 IP Address or Fully Qualified Domain Name: sip.vapi.ai (Use this for now, we will have to add an UUID generated by Vapi later)
1.5 Device type: Asterisk, IP PBX, Gateway or VoIP Switch
1.6 CallerID Number: I use a system capable of passing its own CallerID.
1.7 Click on Create Account.
 All the settings not mentioned can be left with the default values or be adjusted according to your use-case needs.

Vapi configuration

To use Vapi with VoIP.ms you will need to add a Custom SIP Trunk. To do it, you will need your Sub Account username and the IP address of your preferred VoIP.ms Point of Presence.

Adding the SIP trunk

To add a new SIP trunk in Vapi, follow these steps:
1. Log into your Vapi's dashboard: Vapi - Dashboard
2. Open the sidebar, and click on your username.
3. Click on Settings.
4. Click on Integrations.
5. On the list of integrations search for SIP Trunk.
6. Click on + Configure New SIP Trunk.
Vapi-sip-trunk-option-111111.png


Fill the SIP configuration with these values:
1. Name: Any name of your choice (E.g. VoIPms trunk)
2. IP address/domain: Your Preferred VoIP.ms POP Server IP address (E.g. For example, for losangeles4.voip.ms use 208.100.60.38).

🚨 POP Server

Make sure to use the IP address of the server and not the Domain name. Using the name will cause inbound calls to get rejected by Vapi.
You can check the full list of POP servers and their IP addresses here: Choosing Server


3. Port: 5060.
4. Netmask: 24.
5. Outbound Protocol: UDP or TCP.
6. Allow inbound calls: Checked.
7. Allow outbound calls: Checked (if needed).
8. Username: Your VoIP.ms Sub Account username (E.g. 100000_Vapi).
9. Password: Leave empty.
10.Use SIP Registration: Unchecked.
11. Click on + Save SIP Trunk.
Vapi-sip-trunk-configuration-1.png Vapi-sip-trunk-configuration-2.2.png

Adding a Phone Number

Once you have configured the SIP Trunk, you can start adding your VoIP.ms DID numbers to Vapi.
Follow these steps to add a DID number:
1. On the sidebar click on Phone Numbers.
2. Click on Create Phone Number.
Vapi-phone-number-1-1.png
Add the number using this information:
1. From the options of the top, select BYO SIP Trunk Number'.
2. Phone Number: Your DID number in E.164 format (E.g. +1205XXXXXX).
3. SIP Trunk Credential: The trunk you configured for VoIP.ms.
4. Label: Any name of your choice.
5. Click on Import SIP Phone Number.
Vapi-phone-number-1-2.png

Gathering the info to configure the DID on VoIP.ms

Once the number is added to Vapi you will need to get an Universally Unique Identifier (UUID) that Vapi generated for your phone number.
Follow these steps to get the UUID.
1. On the sidebar click on Phone Numbers
2. Click on the Phone Number that was added to open its configuration.
3. Locate the UUID on the top right corner and click on the Copy icon.
 Paste this somewhere because you'll need it.
4. Assistant: Make sure to assign an AI assistant to your DID.
Vapi-phone-number-3.png


VoIP.ms DID configuration

To make VoIP.ms successfully route the calls to the trunk in Vapi you need to add the UUID to the Sub Account's domain used for IP Authentication and then route the DID to the Sub Account.

Adding the UUID to the Sub Account

Next you need to update the FQDN of the Sub Account by adding the UUID.
Follow these steps to do it.
1. Log into your VoIP.ms Customer Portal.
2. Go to Sub Accounts >> Manage Sub Accounts.
3. Click on Edit for the Sub Account you created and configured for Vapi.
4. On the field IP Address or Fully Qualified Domain Name paste the UUID at the beginning of the domain sip.vapi.ai. It will look something like a81bc81b-dead-4e5d-abff-90865d1e13b1.sip.vapi.ai
5. Click on Update Account.


Route your DID to the Sub Account

Once the Sub Account is ready, all you need to do is route your DID number to this so the calls connect to your Vapi's trunk.
1. Go to DID Numbers >> Manage DIDs.
2. Click on Edit for the DID number you added to Vapi.
3. Main Routing: Select SIP/IAX and from the list the Sub Account you added for Vapi.
4. DID Point of Presence: Make sure is the same server you used in the Vapi's SIP Trunk configuration.
5. Dialing Mode for Inbound Calls: E164
6. Apply changes when done.


That's it! Now the calls to your DID will be redirected to Vapi and answered by your Vapi's AI Assistant.


🚨 Using multiple DIDs

If you add more numbers to Vapi just route them in VoIP.ms to the same Sub Account. You don't need to add one Sub Account for each.
Each number in Vapi will have their own UUID, however, you only need to use one of them in your Sub Account's configuration.
However, this is something that depends on how Vapi works. As of now thi has been confirmed to work by the VoIP.ms team by the time this part of the Wiki Article was updated (2/5/2026) but this could change if Vapi make changes on their side.

Outbound calls

Coming soon!

🚨 Outgoing calls

Outbound calls from Vapi are currently not guaranteed.
We are checking with Vapi.ai to find the right configuration to make outgoing calls work.

Useful resources

Vapi's documentation: SIP Trunking

Personal tools
Namespaces
Variants
Actions
VoIP.ms Wiki
Guides 🇨🇦
Guías 🇲🇽