Overview

Torii integrates with Vonage Business Communications and syncs:

• Users
• Licenses (every synced user gets the Vonage license)
• You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.

Requirements

Accounts & Permissions

To connect this integration, we require the following:

• Access to the Vonage Business Communications (VBC) Admin Portal (admin.vonage.com) to create a dedicated integration user.
• A dedicated integration user with the Account Administrator user type. The user does not need an extension, and single sign-on (SSO) must be disabled for this user.
• A Vonage Business Communications developer account (developer.vonage.com) to create an application and keys. Vonage gives developer accounts to qualifying VBC accounts (50 extensions or more). To request one, contact your Vonage Customer Success Manager or account representative.

Required keys

• Integration User Login (the login name without the @vbc.prod suffix)
• Integration User Password
• Consumer Key
• Consumer Secret

How to Generate the Required Values

Step 1: Create a dedicated integration user

1. Log in to the VBC Admin Portal at admin.vonage.com with your admin account.
2. Go to Phone System >> Users and click Add New.
3. Enter a first name, last name, an email address, and a username (for example, api_user_ followed by your VBC account number).
4. Set the user type to Account Administrator, select User does not need an extension, and save.
5. Open the new user, click Update Password, enter a strong password (at least 20 characters, with mixed capitalization, special characters, and at least one number), and click update.
6. If your VBC account uses SSO, clear Enable single sign-on for this user and save.

Step 2: Create an application and subscribe it to the Provisioning and Vonage Integration Suite APIs

1. Sign in to the Vonage Business Communications Developer Portal at developer.vonage.com with your developer credentials.
2. Choose Applications in the top navigation menu and click Add New Application.
3. Enter a name (for example, Torii) and click Save.
4. In the top navigation menu, select APIs and open the Provisioning API tile.
5. In the left navigation menu, select My Applications.
6. In the Subscribe section, choose your application from the Application drop-down and click Subscribe.
7. Go back to APIs, open the Vonage Integration Suite tile, and subscribe the same application. Torii uses it to read your account ID.

Step 3: Generate Production keys

1. Go to Applications and click the name of your application.
2. Select Production Keys in the left navigation menu.
3. Make sure the grant type is Password (the default). The Callback URL can be left blank.
4. Click Generate Keys. Copy the Consumer Key and Consumer Secret.
5. Optional: on large accounts (more than 1,000 users), raise the Per Token Quota of the application above the default of 10 requests per minute.

How to Connect the Integration

1. Go to the Integrations page in Torii.
2. Search for Vonage and click Connect.
3. Enter the Integration User Login (without @vbc.prod), the Integration User Password, the Consumer Key, and the Consumer Secret.
4. Click Connect.

Q&A

Q: Can I perform actions in Vonage from Torii?

A: No. This integration is read-only and syncs users only. Torii cannot create, update, or remove users in Vonage.

Q: Why do all users appear as active?

A: Vonage's API does not provide a user status, so every synced user is shown as active in Torii.

For any further questions, please contact Torii Support.