Skip to main content

Connect the Vonage provider

To use the Vonage telephony:

  1. Create an account in Vonage.
  2. Configure the Tovie DialogStudio telephony connection.
  3. Rent and configure a virtual number if you want to receive inbound calls.
  4. Create a bot for outbound or inbound calls.
  5. Create call campaigns or test inbound calls.

Configure telephony

  1. Sign up or log in to the Vonage developer dashboard.

  2. Copy the values from the API key and API secret fields. You will need them when configuring telephony in Tovie DialogStudio.

    Vonage developer dashboard

  3. Log in to Tovie DialogStudio and go to the telephony connection settings.

  4. Click Add a connection.

  5. Paste the API key value into the SIP login field and API secret into SIP password.

  6. Enter sip.nexmo.com in the Host/IP address field.

  7. Enable Allow inbound calls if you want to receive inbound calls.

  8. Click Save.

Now you can create an outbound call campaign or set up receiving inbound calls.

Call campaigns

If you want to start a call campaign, create a bot for outbound calls first. Then go to the How to create a call campaign article and follow the steps described.

tip
You can learn more about working with call campaigns in the Outbound calls section.

Inbound calls

Rent a virtual number

To configure receiving inbound calls, you need to rent a virtual number in Vonage.

  1. Log in to the Vonage developer dashboard.
  2. In the left sidebar, go to the Numbers → Buy numbers section.
  3. In the Feature field, select Voice. Customize other settings as desired, for example, choose a country code and click Search.
  4. Click Buy next to the number you want and validate your purchase. Your virtual number is now listed in Your numbers.

Renting virtual numbers

caution
Each virtual number is rented by the month. You can enable auto-reload payments if you want to use the number permanently. Learn more about renting numbers in the Vonage documentation.

Configure a virtual number

  1. In the developer dashboard, go to Numbers → Your numbers.

  2. Click the edit icon next to the number you want to configure.

  3. In the Forward to field, select SIP.

  4. In the SIP URI field, enter data in the <your_api_key>@<sip_proxy_ip> format, where:

    • <your_api_key> is your Vonage API key.
    • <sip_proxy_ip> is your SIP proxy address in Tovie DialogStudio: 188.34.156.160.

    Configuring a virtual number

  5. Click Save.

After you create a bot for inbound calls and publish it, you can call the rented number and check the bot’s work.