Подключение приложения

Страница Интеграции соединяет Ringhum с инструментами, которыми уже пользуется ваша команда. После подключения приложения Ringhum отправляет в него звонки, сообщения, бронирования и заказы по мере их появления. Некоторые приложения также передают информацию обратно, например занятое время из календаря или заказы звонящего из вашего магазина. Каждое приложение подключается один раз на всё рабочее пространство, и им пользуется каждый ассистент в этом пространстве.

Прежде чем начать

• Подключать, изменять или отключать приложения могут только Владелец и Администраторы рабочего пространства. Участники и Наблюдатели видят страницу, а на карточках отображается Попросите администратора подключить это приложение.
• Большинство приложений доступны на любом тарифе. Google Calendar (двусторонняя синхронизация) и Calendly входят в тарифы Team и Scale. На других тарифах их карточки вместо кнопки Подключить показывают замок тарифа.
• Вам понадобится аккаунт в другом приложении, а обычно и права администратора там, чтобы создать API-ключ или вебхук.

Каталог приложений

Откройте Интеграции в боковом меню. Используйте поле поиска или кнопки категорий, чтобы найти приложение. Кнопка Подключено показывает только уже подключённые вами приложения.

Если вашего инструмента нет в списке, обычно до него можно добраться через Zapier, Make или n8n, либо с помощью собственной конечной точки вебхука в разделе Разработчикам. Кнопка Webhooks и API в верхней части страницы ведёт туда.

Три способа подключения

Каждое приложение использует один из трёх типов подключения. Карточка и диалог подключения показывают, какой именно.

Две группы работают иначе. Карточка Лента календаря (ICS) даёт вам ссылку, которую нужно вставить в приложение календаря; подключать ничего не нужно. Каналы отелей (Booking.com, Airbnb, Vrbo) настраиваются для каждого номера отдельно: на их карточках есть кнопка Настроить в «Номерах», которая открывает Номера и тарифы.

Подключение приложения с помощью ключа или URL вебхука

1. Откройте Интеграции и найдите приложение.
2. Нажмите Подключить на его карточке. Откроется диалог Подключить с кратким описанием, где найти учётные данные в другом приложении. У многих приложений также есть ссылка Документация.
3. Заполните поля, например API-ключ, субдомен, идентификатор списка или проекта, либо URL вебхука.
4. В разделе Отправка отметьте события, которые должно получать приложение. См. Выбор того, что отправляется.
5. Если в диалоге отображается переключатель Только звонки, требующие внимания, решите, должно ли приложение узнавать о каждом звонке или только о тех, что требуют чьих-то действий.
6. Нажмите Подключить.

Ringhum проверяет подключение, прежде чем что-либо сохранить. Если проверка не проходит, ничего не сохраняется, а диалог показывает Не удалось подключиться с причиной от другого приложения, например отклонённым ключом. Исправьте поле и попробуйте снова.

Примечание: Учётные данные хранятся в зашифрованном виде и используются только с наших серверов.

Подключение приложения через вход в аккаунт

1. Нажмите Подключить на карточке. Вы перейдёте в другой сервис.
2. Войдите и одобрите запрашиваемый доступ.
3. Вы вернётесь в Интеграции с сообщением о подтверждении.

Некоторым приложениям с входом через аккаунт нужен ещё один шаг. Для Google Sheets нажмите Настройки на карточке и вставьте идентификатор таблицы. Пока вы этого не сделаете, доставки пропускаются с сообщением «Добавьте идентификатор таблицы в настройках интеграции». Google Drive работает сразу же и сохраняет файлы в «Моём диске», если вы не добавите идентификатор папки в Настройках.

Проверка подключения

Подключённая карточка показывает значок статуса: Подключено, Ошибка или Приостановлен. Также отображается время последней доставки и события, которые получает приложение.

• Отправить тест (приложения для мессенджеров и автоматизации) публикует тестовое сообщение, чтобы вы увидели, что оно доходит до канала или сценария.
• Тест (все остальные приложения) проверяет, что учётные данные всё ещё действительны.

Результат отображается сообщением в верхней части экрана. Для Zapier и Make отправьте тестовое событие перед сопоставлением полей, чтобы сценарий мог изучить структуру данных.

Управление подключением

На подключённой карточке есть некоторые или все из этих кнопок:

• Настройки (у приложений с полями для заполнения) снова открывает диалог, чтобы изменить учётные данные или события. Нажмите Сохранить настройки. Перед сохранением изменения подключение проверяется заново.
• Переподключить (у приложений со входом через аккаунт) повторяет вход, например после смены пароля или истечения доступа.
• Приостановить останавливает все доставки, не теряя настройки. Возобновить запускает их снова.
• Отключить удаляет подключение и хранящиеся учётные данные.

Решение проблем

Кнопка «Подключить» отсутствует. Возможно, вы не Владелец и не Администратор, приложению требуется более высокий тариф (карточка показывает замок тарифа), либо приложение со входом через аккаунт показывает Требуется настройка — это значит, что оно сейчас недоступно. Если этот значок не исчезает, обратитесь в поддержку.

Баннер сообщает «Нативные коннекторы отключены для этого рабочего пространства». Приложения для CRM, хелпдесков, задач, таблиц, маркетинга, аналитики и электронной коммерции отключены для вашего рабочего пространства. Приложения для мессенджеров, автоматизации и календарей по-прежнему работают. Обратитесь в поддержку, чтобы их снова включили.

Мой тестовый звонок не появился в Slack или моей CRM. Обновления звонков, элементы входящих и заказы из тестовых звонков не отправляются в подключённые приложения. Совершите настоящий звонок на номер.

Карточка показывает «Ошибка». Нажмите на строку последней доставки на карточке, чтобы увидеть, что пошло не так. См. Решение проблем с доставкой.