Використовуйте ThunderPhone із Zapier

Підключіть застосунок ThunderPhone у Zapier до своєї організації та створіть Zap, який запускатиметься щоразу після завершення дзвінка.

Zapier з’єднує застосунки за допомогою автоматизованих робочих процесів, які називаються Zap. Застосунок ThunderPhone у Zapier додає:

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

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

Підключіть свою організацію#

Застосунок підключається через OAuth. Ви входите в ThunderPhone і схвалюєте доступ для однієї організації, а ключ API до Zapier не копіюється.

1. Додайте крок ThunderPhone

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

2. Увійдіть і виберіть організацію

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

3. Перевірте назву підключення

   Zapier називає підключення на честь організації, яку ви схвалили, тому ви можете відрізняти підключення, якщо належите до кількох організацій.

Підключайтеся за допомогою облікового запису з роллю адміністратора або власника в цій організації. Увімкнення або вимкнення тригерного Zap, а також кожна дія, потребують цієї ролі. Уже ввімкнений тригерний Zap продовжує отримувати події дзвінків після зміни ролі або відкликання підключення. Вимкніть його, щоб припинити їх отримання. Пошук дзвінків працює для будь-якого учасника.

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

Створіть перший Zap#

Цей Zap додає рядок до таблиці Google щоразу, коли виклик завершується.

1. Здійсніть виклик, щоб використати його як зразок даних

   Відкрийте агента в конструкторі, натисніть Розмова та завершіть виклик. Тестові виклики в конструкторі запускають подію «Виклик завершено», тому тригер отримає нещодавній виклик для завантаження.

2. Додайте тригер

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

3. Додайте Google Таблиці

   Додайте дію Google Таблиць, яка створює рядок у таблиці. Виберіть таблицю з рядком заголовків, а потім зіставте кожен стовпець із полем тригера (див. таблицю нижче).

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, що лежить в основі цієї дії.

Приклади Zap#

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

Транскрипти, підсумки та записи викликів можуть містити персональну інформацію або інформацію про стан здоров’я. Надсилайте їх лише до застосунків, які ваша організація має право використовувати для таких даних, відповідно до угоди BAA, якщо йдеться про інформацію про стан здоров’я, і зберігайте лише потрібні поля.

Усунення несправностей#

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

Не вдається увімкнути або вимкнути Zap, або дію відхилено. Особа, яка створила підключення, повинна мати роль адміністратора або власника в організації. Повторно підключіться за допомогою облікового запису з такою роллю. Zap-тригер, який уже ввімкнено, продовжує отримувати події викликів після зміни ролі або відкликання підключення. Вимкніть його, щоб припинити їх отримання.

Ви хочете відключити застосунок. Вимкніть свої Zap 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 показує нещодавні спроби доставки.