# Vonage

> Connect your Vonage business phone account once, then import recorded calls and have new ones arrive on their own.

Source: https://app.activelens.ai/help/vonage

Vonage is connected once for the whole workspace, by an admin, from
**Integrations → Vonage**. Once it is connected:

- the calls Vonage recorded become ActiveLens calls — transcribed, summarized,
  with actions drafted;
- you can import recorded calls from the last few weeks;
- new recorded calls arrive by themselves, a few minutes after they end;
- answered and missed calls feed the phone-system numbers on the Active Hub's
  **Dashboard**.

Sending text messages from a call is not available for Vonage.

## Before you start

Two things are needed on the Vonage side:

- **The Company Call Recording add-on.** Only calls Vonage recorded can become
  ActiveLens calls. Without the add-on there is nothing to import or sync, and
  the Vonage page warns you.
- **A Vonage account administrator who signs in without single sign-on.**
  Vonage doesn't accept a single sign-on login for connecting an app, so the
  person connecting needs an administrator login that signs in to Vonage
  directly.

One Vonage account can be connected to one ActiveLens workspace.

## Connect Vonage

On **Integrations → Vonage**, press **Connect Vonage**, sign in to Vonage as
the account administrator and approve access for ActiveLens. **Sync new calls**
is switched on as soon as you are connected.

### Using your own Vonage developer app

If your company has its own app on a Vonage developer account, you can connect
through it instead of the ActiveLens one. Under the connect, choose **Have your
own Vonage developer app?**:

1. In the Vonage developer portal, set your app's **Callback URL** to the
   address shown on the page, allow the **Code** grant type, and subscribe the
   app to the Vonage Business Communications APIs.
2. Paste the app's **Consumer key** and **Consumer secret**, and its **Per
   Token Quota** as the requests per minute, then save.
3. Press **Connect Vonage** and sign in as the account administrator.

While your app is saved, every connect goes through it. To change or remove it
later, disconnect Vonage first.

## Match your people

ActiveLens brings in a Vonage user's calls only once that user is matched to a
member of your workspace. Under **People**, each Vonage user can be:

- **invited** as a new member, under their Vonage email or an address you type;
- **linked** to someone already in the workspace.

One Vonage user is matched to one member. To add people now and invite them
later, switch off **Send invitation emails** before inviting them, then send
each invitation from the **Users** page when you are ready.

Each matched person has two switches of their own: one stops their new calls
from being synced, the other leaves their calls out of the Dashboard's numbers.

## Import recent calls

Pick how far back to go — the last 7, 14 or 30 days — and start the import.

- Everyone matched can import their own calls. Admins can also pick other
  matched people.
- Calls shorter than 30 seconds are skipped.
- Imported calls count toward your plan's call limit. When the limit is
  reached, the import stops and the remaining calls stay at Vonage.
- During a trial, one import brings in at most 50 calls.

## Sync new calls

Vonage doesn't tell ActiveLens when a new recording is ready, so ActiveLens
checks every few minutes. A call usually appears 5 to 10 minutes after it
ends.

- Calls shorter than 10 seconds are skipped.
- A synced call counts toward your plan's call limit. A call past the limit is
  left at Vonage, so you can import it later, once your plan has room.
- An admin can switch **Sync new calls** off at any time; a person's own switch
  leaves just their calls out.

## The Dashboard

When your plan includes the Active Hub's **Dashboard**, Vonage's call log —
the calls that were answered and the ones that were missed — feeds its
phone-system numbers, such as the answer rate and missed calls.

## Disconnect Vonage

An admin can press **Disconnect** on the Vonage page. The sync stops and the
links between Vonage users and members are removed; the members stay in the
workspace, and calls already brought in stay where they are. To withdraw
ActiveLens's access completely, a Vonage administrator can also remove it in
Vonage.

## Troubleshooting

- **Vonage needs to be reconnected.** Vonage stopped accepting the connection.
  Press **Connect Vonage** and sign in again as an account administrator. A
  Vonage connection that goes unused for a week lapses; ActiveLens keeps it in
  use for as long as Vonage is connected.
- **Vonage refused a read.** The connected login can't see what ActiveLens
  needs. Check that it belongs to an account administrator and that the Company
  Call Recording add-on is on, then reconnect if needed.
- **A Vonage call is missing.** Check that the person is matched under
  **People**, that their own switch and **Sync new calls** are both on, that
  the call was long enough, that Vonage recorded it, and that your plan had
  room for it. A call left out by the plan limit can still be imported later.

## Related

- [Connect an integration](/help/connecting-an-integration)
- [My call did not appear](/help/call-not-showing-up)
- [Plans and billing](/help/plans-and-billing)
