Telephony

Cloud PBXs connect under Integrations. The general rules (kinds of connection, card statuses, Read only, disconnecting) are on the Connecting services page. How the agent asks before actions such as a call or a forwarding change is described in Action confirmation.

In the catalog telephony sits in the Messengers category together with chats and conversation aggregators (Wazzup24, Umnico, Chat2Desk and others): their connection is described on their integration pages.

Mango Office

Virtual PBX: calls, callback, SMS, statistics, call recordings. More on the integration page.

What the agent can do

Gathers call statistics by group and employee, finds missed calls, reads call recordings, starts a callback and sends SMS within the API connector's rights.

Create a report from @mango_office for June 1–14 for the Support group: total incoming, answered and missed calls; separately: called back on their own, we called back, could not reach, spam.

Open in chat

Before you start

The virtual PBX owner or administrator account at lk.mango-office.ru.

Steps

1

Open the API connector

In the Mango Office account: «Интеграции» → «API коннектор» (Integrations, API connector).

2

Turn on the API connector

If the service is not active, click «Подключить API коннектор» (connect the API connector), tick «Я принимаю условия» (I accept the terms) and confirm. While the connector is off, the credentials are not shown.

3

Move two values

«Уникальный код вашей АТС» (your PBX's unique code) into API Key, «Ключ для создания подписи» (signing key) into API Salt. They are different values, do not mix them up: the salt is used to sign requests.

4

Turn on call events

Copy the Webhook address from the connection card whole and paste it into the API connector settings as the external system address.

Limitations

  • Three events arrive: call ended, call state changed, call recording ready. Tasks run on them, for example a review of every missed call.
  • Call statistics in the Mango Office API are prepared in two steps: the agent orders a report and waits for it, so the answer is not instant.

How to revoke access

Click Disconnect here. In the Mango Office account the API connector is turned off in the same «Интеграции» section.

Troubleshooting

  • Credentials not accepted: the PBX code and the signing key are swapped, or the connector is off.
  • Events do not arrive: the webhook address was not pasted whole or went into another API connector.

Beeline Cloud PBX

Cloud PBX: calls, forwarding, call recording, blacklists, call detail records. More on the integration page.

What the agent can do

Reads call detail records and recordings and manages forwarding and blacklists.

Before you start

Access to cloudpbx.beeline.ru with the credentials from the contract, and the «Интеграция по API» (API integration) service turned on. Beeline charges for the service.

Steps

1

Turn on API integration

«Настройки» → «API» tab → «Интеграция по API» switch (Settings, API, API integration).

2

Issue a token

On the «Version 2.0» tab click «Создать новый токен» (create a new token) and paste it into Portal API token.

Without a token, the «Version 1.0» tab issues a login and password pair: paste them into Username and Password and leave Portal API token empty. These are the credentials of the API tab, not your account sign-in.

Limitations

While «Интеграция по API» is off, requests to the PBX fail. Beeline sends us no call events: a scheduled task checks new calls.

How to revoke access

Click Disconnect here. In the Beeline account turn off «Интеграция по API» or delete the token.

Troubleshooting

  • Credentials not accepted: the account login and password were pasted instead of the API tab credentials.

Gravitel Cloud PBX

Cloud PBX: calls, SMS, history, employees, numbers, caller ID, call campaigns. More on the integration page.

What the agent can do

Reads call history, employees and numbers, starts calls, SMS and call campaigns.

Steps

1

Install the REST API integration

At gravitel.ru click «Войти в АТС» (sign in to the PBX), then the «Интеграции» → «Интеграция по REST API» → «Установить» menu (Integrations, REST API integration, Install). The neighbouring «Интеграция по API Гравител» is the previous generation and will not work.

2

Open its settings

Any «Название интеграции» (integration name) will do. Leave «Адрес вашей CRM» and «Ключ для авторизации в Вашей CRM» empty.

3

Move the address and key

The «Авторизация» (authorization) subsection holds the PBX address and key. Paste the key into API Key, and into Gravitel domain only your PBX domain (the part of the path after /v1/), not the whole address.

Limitations

Gravitel sends us no call events: a scheduled task checks new calls.

How to revoke access

Click Disconnect here. In the PBX account remove the REST API integration.

Troubleshooting

  • Credentials not accepted: the whole address went into Gravitel domain instead of the PBX domain, or the previous-generation integration is installed.

Sipuni

IP telephony: call history and missed calls, call recordings, employee statuses. More on the integration page.

What the agent can do

Reads call history and missed calls, call recordings and employee statuses.

Before you start

The statistics API service turned on in the Sipuni account.

Steps

1

Turn on the statistics API

In the old account: «Настройки» → «API» → «Статистика» → «Подключить услугу». In the new one: «Интеграции» → «Интеграция по API» → «Статистика».

2

Copy the integration key

«Настройки» → «Интеграция по API» (in the old account «Настройки» → «API»). If there is no key, click «Сгенерировать» (generate) and «Сохранить» (save). Paste it into Secret Key.

3

Move the account number

The number is shown in the top right corner. Paste it into Sipuni account number whole, with its leading zeros.

Limitations

The account number and the integration key must belong to one account. Sipuni sends us no call events: a scheduled task checks new calls.

How to revoke access

Click Disconnect here. The integration key is managed in the Sipuni account, in the «Интеграция по API» section.

Troubleshooting

  • Credentials not accepted: the account number lost its leading zeros, so the request signature does not match.

Frequently asked questions

Where do I get the Mango Office keys?

In lk.mango-office.ru as the virtual PBX owner or administrator: «Интеграции» → «API коннектор». Paste «Уникальный код вашей АТС» into API Key and «Ключ для создания подписи» into API Salt.

How does the agent learn about missed calls right away?

Mango Office sends call events: copy the Webhook address from the connection card and paste it into the API connector settings. Tasks run on the events, for example a review of every missed call. Other PBXs send no events, so a scheduled task checks the calls.

The Sipuni connection fails. Why?

Most often the account number lost its leading zeros: without them the request signature does not match. Copy the number whole from the top right corner of the account.

See also

Was this page helpful?

Didn't find an answer? How to reach us