Skip to main content

Connect the Vonage provider

To use the Vonage telephony:

  1. Create an account in Vonage.
  2. Configure the JAICP telephony connection.
  3. Rent and configure a virtual number if you want to receive inbound calls.
  4. Connect a phone channel.
  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 JAICP.

    Vonage developer dashboard

  3. Log in to JAICP. On the top navigation bar, click and select SIP server connection > Add new connection.

  4. In the Main settings section, paste the API key value into the Login field and API secret into Password.

  5. Enter sip.nexmo.com in the Host/IP field.

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

  7. Click Add a connection.

tip
Learn more about configuring telephony connections

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

Call campaigns​

If you want to create a call campaign, connect your bot to a phone channel first. Then go to the Call campaigns article and follow the steps described.

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. Select SIP in the Forward to field.
  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 the JAICP environment. It is 82.202.218.130 for JAICP cloud. Configuring a virtual number
  5. Click Save.

After you connect a phone channel and publish your bot, you can call the rented number and check the bot’s work.