Skip to main content
Vonage is a cloud communications platform for voice, SMS and video. Connecting it to BeRocker takes three values and one key file from the Vonage dashboard, plus an optional signature secret.

​
What BeRocker asks for

The API secret is a credential for your whole Vonage account. BeRocker never shows a saved secret or key again: the fields read Saved. Type a new one to replace it. Leave them empty to keep what is saved.
BeRocker checks the API key, secret, application ID and key with Vonage before saving them. If Vonage rejects them, the dialog says which one and nothing is saved.

​
Connect it

1

Open Integrations

Settings → Integrations → Communications → Vonage → Configure. The dialog is called Vonage settings.
2

Paste the values and upload the key file

API key, API secret, Application ID, then Upload the private.key file. Paste the Signature secret if you have one. Set Status to Active and click Save.
3

Point your number at it

Settings → Profile → User Contacts → Add user contact → your Vonage number with Provider = Vonage, Channel = Call/SMS (same number) (saves one Call and one SMS contact in one go), Status = Active, and tick Is Default?.→ Profile
4

Test the connection

Back on the Vonage card, click Test Connection. Fix anything marked in red, then use Register webhooks and Provision users in the same dialog if the checks ask for them.
A Signature secret can only be saved when the Vonage application signs its call webhooks. If the dialog refuses it, open the application in the Vonage dashboard, turn on Use signed webhooks under Voice, save, and try again.

​
Check that it works

The Vonage card has three test buttons once Vonage is connected. Inside Test Connection:
  • Register webhooks points the Vonage application’s call and text webhooks, and the account’s SMS webhooks, at BeRocker. It asks you to confirm first, because anything else using those addresses stops receiving them.
  • Provision users sets up every user who has a Vonage calling number so calls can ring in their browser.

​
Backup ring and voicemail

In Vonage settings, turn on Backup ring and voicemail to change what happens on an incoming call:
  1. The lead owner’s BeRocker phone rings for 25 seconds.
  2. If nobody answers, the owner of the line rings next.
  3. If still nobody answers, the caller hears the Voicemail greeting and can leave a message.
The message appears in the conversation as a call marked Voicemail, with the recording attached. Leave Voicemail greeting empty to use the standard greeting.

​
Sending texts with the Messages API

Turn on Send texts with the Messages API when your Vonage account’s default SMS setting is the Messages API. Picture messages always use the Messages API. Incoming texts work either way.

​
Calls in the browser

  • Your BeRocker phone stays connected for as long as the app is open, including after sleep or a network drop.
  • If BeRocker is open in more than one tab, calls ring in one of them. The other tabs show Calls are open in another tab with a Use this tab button.
  • The first call asks for microphone access. If the browser blocks it, BeRocker says so.

​
Adding a developer to your Vonage account

If the BeRocker team or your own developer needs access to set this up, invite them rather than sharing your login.
1

Log in to Vonage — Communications APIs

The Vonage Communications APIs dashboard
2

Go to the Home page and click "Invite your team"

Inviting your team in Vonage
3

Add the user with these permissions

The permissions to grant the invited user

​
Before you send at volume

US application-to-person SMS needs 10DLC registration with Vonage, exactly as it does with every other provider. Unregistered traffic is filtered by the carriers, not by Vonage — the messages look sent and never arrive. Watch Messaging health after you start sending.

Integrations

All communication providers.

Messaging health

Delivery rates per sending number.