Используйте ThunderPhone с Zapier

Подключите приложение ThunderPhone в Zapier к своей организации и создайте Zap, который запускается каждый раз после завершения звонка.

Zapier связывает приложения с автоматизированными рабочими процессами, которые называются Zap. Приложение ThunderPhone в Zapier предоставляет:

• Триггеры: Звонок завершён срабатывает, когда завершается телефонный, веб- или тестовый звонок. Звонок оценён срабатывает, когда становится доступна оценка завершённого звонка.
• Действия: Совершить исходящий звонок, Добавить контакты в кампанию и Запустить кампанию.
• Поиск: Найти звонок ищет звонок по ID и возвращает его вместе с расшифровкой и подписанным URL записи, если она доступна.

Найдите его в разделе ThunderPhone в Zapier. Обзор обоих способов использования Zapier с ThunderPhone доступен на странице интеграции Zapier.

Подключите организацию#

Приложение подключается через OAuth. Вы входите в ThunderPhone и подтверждаете доступ для одной организации, при этом ключ API не копируется в Zapier.

1. Добавьте шаг ThunderPhone

   В редакторе Zap найдите ThunderPhone (отображается с меткой Beta) и выберите триггер или действие. Когда Zapier запросит аккаунт, подключите новый. Zapier откроет окно входа в ThunderPhone.

2. Войдите и выберите организацию

   Войдите, проверьте запрошенные разрешения, выберите организацию и нажмите Подтвердить. Приложение запрашивает разрешение на просмотр ваших агентов и телефонных номеров, просмотр и изменение звонков и кампаний, управление интеграциями, например конечными точками webhook, а также просмотр email вашего аккаунта.

3. Проверьте имя подключения

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

Подключайтесь с аккаунтом, который имеет роль администратора или владельца в этой организации. Для включения или выключения Zap с триггером, а также для любого действия требуется эта роль. Уже включённый Zap с триггером продолжает получать события звонков после изменения роли или отзыва подключения. Выключите его, чтобы остановить их. Функция «Найти звонок» доступна любому участнику.

У приложения нет отдельной платы ThunderPhone. Звонки, которые оно совершает или запускает, тарифицируются по обычным тарифам ThunderPhone, а Zapier учитывает задачи в рамках вашего тарифа Zapier.

Создайте первый Zap#

Этот Zap добавляет строку в Google Sheets каждый раз, когда звонок завершается.

1. Совершите звонок для использования в качестве примера данных

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

2. Добавьте триггер

   Выберите ThunderPhone в качестве приложения-триггера, установите событие Звонок завершён и выберите подключение ThunderPhone. Протестируйте триггер. Zapier загрузит ваши последние завершённые звонки в качестве примеров в том же формате, что и событие в реальном времени.

3. Добавьте Google Sheets

   Добавьте действие Google Sheets, которое создаёт строку таблицы. Выберите таблицу со строкой заголовков, затем сопоставьте каждый столбец с полем из триггера (см. таблицу ниже).

4. Опубликуйте Zap

   Опубликуйте и включите Zap. При включении создаётся конечная точка вебхука в вашей организации ThunderPhone с именем Zapier: Звонок завершён. При отключении Zap эта конечная точка удаляется.

5. Протестируйте

   Совершите ещё один тестовый звонок в конструкторе. Когда он завершится, Zap запустится и появится строка.

Полезные столбцы:

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

Событие также может содержать расшифровку в виде списка реплик и URL записи — подписанную ссылку с ограниченным сроком действия. Добавляйте их только при необходимости. Расшифровки звонков, сводки и записи могут содержать персональную информацию или информацию о здоровье. Отправляйте их только в приложения, которые ваша организация имеет право использовать для таких данных, при наличии BAA, если затрагивается информация о здоровье, и храните только необходимые поля. См. telephony.complete / web.complete для просмотра всех полей.

Триггеры, действия и поиск#

Оценка звонка предоставляет ID звонка, ID агента, имя агента и оценку: ID оценки, балл, результат звонка, сводку, модель оценщика и время оценки. При включении Zap создаётся конечная точка с именем Zapier: Оценка звонка. Звонок можно оценить несколько раз, и каждый завершённый запуск оценки активирует триггер. См. call.graded.

Найти звонок принимает ID звонка с раскрывающимся списком недавних звонков. Возвращает агента звонка, направление, номера, время начала и окончания, статус, причину завершения, балл оценки и результат звонка, расшифровку и подписанный URL записи, если он доступен. Неизвестный ID звонка не вызывает ошибку, а возвращает пустой результат.

Совершить исходящий звонок принимает:

Возвращает ID звонка, статус и идемпотентное повторение.

Добавить контакты в кампанию добавляет контакты в черновик кампании. Для одного контакта заполните Номер телефона в формате E.164 и при необходимости Переменные контакта — JSON-объект, свойства которого становятся переменными кампании. Для пакета заполните JSON контактов массивом до 5 000 объектов. Для каждого требуется phone_number, а остальные свойства становятся переменными. Этап завершается ошибкой, если отклонены все контакты, и устанавливает Частичный успех, если отклонена только часть контактов.

Запустить кампанию запускает или возобновляет кампанию, в которой есть хотя бы один контакт. Требуется Согласие на списание средств. См. Исходящие кампании.

Перед тем как Zap совершит звонки#

Совершить исходящий звонок и Запустить кампанию набирают реальные телефонные номера и запускают платные звонки.

• Если ThunderPhone просит вашу организацию подтвердить, что её исходящие звонки соответствуют TCPA и другим законам о звонках, администратор должен зафиксировать это подтверждение в панели управления, прежде чем Zap сможет начать звонки.
• Номер отправителя должен быть включён для исходящих звонков. Номера, которые вы переносите от своего оператора связи, становятся доступными после проверки. Номера, предоставленные ThunderPhone, изначально доступны только для входящих звонков, а доступ к исходящим звонкам для них можно запросить в панели управления. См. Получить номер телефона.
• Для действия Совершить исходящий звонок требуется Ключ идемпотентности. Сопоставьте стабильный ID из триггера или исходной записи, например ID события ThunderPhone или ID записи CRM. Если Zapier повторит этап, ThunderPhone распознает ключ и вернёт исходный звонок вместо создания второго. Не используйте временные метки, случайные значения или только ID Zap.
• Для действия Запустить кампанию требуется Согласие на списание средств, которое подтверждает, что Zap может запускать платные исходящие звонки для вашей учётной записи.
• Ваша организация отвечает за наличие согласия на звонок по каждому номеру и за соблюдение применимых законов о звонках. См. законы об исходящих звонках.

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

Примеры Zaps#

• Завершённый звонок в CRM. Регистрируйте действие для каждого завершённого звонка с его статусом, причиной завершения и расшифровкой.
• Оценённый звонок для дальнейшей работы. Фильтруйте по результату или оценке звонка и направляйте звонок в нужный сценарий дальнейшей работы.
• Новый лид в кампанию. Добавьте лида в черновик кампании с помощью Add Contacts to Campaign, затем запустите Start Campaign после того, как кто-то утвердит список.

Расшифровки, сводки и записи звонков могут содержать персональную информацию или сведения о здоровье. Отправляйте их только в приложения, которые ваша организация имеет право использовать для таких данных, по соглашению BAA, если речь идёт о сведениях о здоровье, и храните только необходимые поля.

Устранение неполадок#

Шаг завершается ошибкой авторизации. Повторно подключите ThunderPhone в Zapier и снова подтвердите доступ. Подключение перестаёт работать, если человек, который его подключил, отзывает его в ThunderPhone в разделе Организация → Ключи → Авторизованные приложения, покидает организацию или если в течение 30 дней не было успешного обновления токена. См. Подключение через OAuth.

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

Вы хотите отключить приложение. Отключите свои Zaps ThunderPhone до отзыва подключения, так как при отключении Zap удаляется его конечная точка и требуется рабочее подключение. Если вы сначала отозвали подключение, удалите оставшуюся конечную точку Zapier: … с помощью DELETE /v1/developer/webhook-endpoints/{id}, используя API-ключ администратора. См. Конечные точки вебхуков.

Zap должен использовать другую организацию. Каждое подключение относится к одной организации. Сначала отключите Zap, чтобы его конечная точка вебхука была удалена из текущей организации. Затем подключите новый аккаунт ThunderPhone в Zapier, выберите другую организацию при подтверждении доступа и укажите это подключение на каждом шаге ThunderPhone. Агенты, номера и кампании различаются между организациями, поэтому снова выберите Агент, Исходящий номер и Кампания на каждом шаге, где они есть. Затем снова включите Zap.

Триггер перестал срабатывать. Каждый Zap с триггером ThunderPhone использует одну конечную точку вебхука в вашей организации с именем Zapier: Звонок завершён или Zapier: Звонок оценён. Она создаётся при включении Zap и удаляется при его отключении. Не изменяйте её. Если она была изменена или удалена в ThunderPhone, отключите и снова включите Zap, чтобы создать новую. С API-ключом администратора GET /v1/developer/webhook-deliveries показывает последние попытки доставки.