--- title: "Используйте ThunderPhone с Zapier" description: "Подключите приложение ThunderPhone в Zapier к своей организации и создайте Zap, который запускается каждый раз после завершения звонка." --- [Zapier](https://zapier.com) связывает приложения с автоматизированными рабочими процессами, которые называются Zap. Приложение ThunderPhone в Zapier предоставляет: - **Триггеры:** **Звонок завершён** срабатывает, когда завершается телефонный, веб- или тестовый звонок. **Звонок оценён** срабатывает, когда становится доступна оценка завершённого звонка. - **Действия:** **Совершить исходящий звонок**, **Добавить контакты в кампанию** и **Запустить кампанию**. - **Поиск:** **Найти звонок** ищет звонок по ID и возвращает его вместе с расшифровкой и подписанным URL записи, если она доступна. Найдите его в разделе [ThunderPhone в Zapier](https://zapier.com/apps/thunderphone/integrations). Обзор обоих способов использования Zapier с ThunderPhone доступен на [странице интеграции Zapier](https://thunderphone.com/integrations/zapier). ## Подключите организацию Приложение подключается через OAuth. Вы входите в ThunderPhone и подтверждаете доступ для одной организации, при этом ключ API не копируется в Zapier. В редакторе Zap найдите **ThunderPhone** (отображается с меткой Beta) и выберите триггер или действие. Когда Zapier запросит аккаунт, подключите новый. Zapier откроет окно входа в ThunderPhone. Войдите, проверьте запрошенные разрешения, выберите организацию и нажмите **Подтвердить**. Приложение запрашивает разрешение на просмотр ваших агентов и телефонных номеров, просмотр и изменение звонков и кампаний, управление интеграциями, например конечными точками webhook, а также просмотр email вашего аккаунта. Zapier присваивает подключению имя одобренной вами организации, поэтому вы сможете различать подключения, если состоите более чем в одной организации. Подключайтесь с аккаунтом, который имеет роль администратора или владельца в этой организации. Для включения или выключения Zap с триггером, а также для любого действия требуется эта роль. Уже включённый Zap с триггером продолжает получать события звонков после изменения роли или отзыва подключения. Выключите его, чтобы остановить их. Функция «Найти звонок» доступна любому участнику. У приложения нет отдельной платы ThunderPhone. Звонки, которые оно совершает или запускает, тарифицируются по обычным тарифам ThunderPhone, а Zapier учитывает задачи в рамках вашего тарифа Zapier. ## Создайте первый Zap Этот Zap добавляет строку в Google Sheets каждый раз, когда звонок завершается. Откройте агента в конструкторе, нажмите **Поговорить** и завершите звонок. Тестовые звонки в конструкторе запускают событие «Звонок завершён», поэтому триггер получит недавний звонок для загрузки. Выберите **ThunderPhone** в качестве приложения-триггера, установите событие **Звонок завершён** и выберите подключение ThunderPhone. Протестируйте триггер. Zapier загрузит ваши последние завершённые звонки в качестве примеров в том же формате, что и событие в реальном времени. Добавьте действие Google Sheets, которое создаёт строку таблицы. Выберите таблицу со строкой заголовков, затем сопоставьте каждый столбец с полем из триггера (см. таблицу ниже). Опубликуйте и включите Zap. При включении создаётся конечная точка вебхука в вашей организации ThunderPhone с именем **Zapier: Звонок завершён**. При отключении Zap эта конечная точка удаляется. Совершите ещё один тестовый звонок в конструкторе. Когда он завершится, Zap запустится и появится строка. Полезные столбцы: | Столбец | Поле «Звонок завершён» | |---|---| | Идентификатор звонка | Идентификатор звонка | | Агент | Имя агента | | Направление | Направление | | От | Номер отправителя | | Кому | Номер получателя | | Начало | Время начала | | Окончание | Время окончания | | Длительность (с) | Длительность в секундах | | Статус | Статус | | Причина завершения | Причина завершения | | Ссылка на звонок | Введите `https://app.thunderphone.com/dashboard/call-history/`, затем вставьте идентификатор звонка | Ссылка на звонок открывает его в панели управления ThunderPhone для участников вашей организации вместе с расшифровкой и записью, поэтому их не нужно хранить в таблице. Событие также может содержать расшифровку в виде списка реплик и URL записи — подписанную ссылку с ограниченным сроком действия. Добавляйте их только при необходимости. Расшифровки звонков, сводки и записи могут содержать персональную информацию или информацию о здоровье. Отправляйте их только в приложения, которые ваша организация имеет право использовать для таких данных, при наличии BAA, если затрагивается информация о здоровье, и храните только необходимые поля. См. [`telephony.complete` / `web.complete`](/ru/webhooks/call-complete) для просмотра всех полей. Каждая доставка подписывается. Перед запуском Zap приложение проверяет HMAC `X-ThunderPhone-Signature` по секрету конечной точки и останавливает обработку всего неподписанного или недействительного. Если Zapier не принимает доставку, ThunderPhone повторяет попытки до 24 часов. См. [Обзор вебхуков](/ru/webhooks/overview). ## Триггеры, действия и поиск **Оценка звонка** предоставляет ID звонка, ID агента, имя агента и оценку: ID оценки, балл, результат звонка, сводку, модель оценщика и время оценки. При включении Zap создаётся конечная точка с именем **Zapier: Оценка звонка**. Звонок можно оценить несколько раз, и каждый завершённый запуск оценки активирует триггер. См. [`call.graded`](/ru/webhooks/events). **Найти звонок** принимает ID звонка с раскрывающимся списком недавних звонков. Возвращает агента звонка, направление, номера, время начала и окончания, статус, причину завершения, балл оценки и результат звонка, расшифровку и подписанный URL записи, если он доступен. Неизвестный ID звонка не вызывает ошибку, а возвращает пустой результат. **Совершить исходящий звонок** принимает: | Поле | Значение | |---|---| | Агент | Сохранённый агент. В раскрывающемся списке отображаются ваши агенты. | | Номер получателя | Номер назначения в формате E.164, например `+14155552671`. | | Номер отправителя | В раскрывающемся списке отображаются только номера, включённые для исходящих звонков. | | Переменные | Необязательный JSON-объект значений для заполнителей в промпте агента. | | Ключ идемпотентности | Стабильный ID из триггера или исходной записи. Обязательное поле. | Возвращает ID звонка, статус и идемпотентное повторение. **Добавить контакты в кампанию** добавляет контакты в черновик кампании. Для одного контакта заполните **Номер телефона** в формате E.164 и при необходимости **Переменные контакта** — JSON-объект, свойства которого становятся переменными кампании. Для пакета заполните **JSON контактов** массивом до 5 000 объектов. Для каждого требуется `phone_number`, а остальные свойства становятся переменными. Этап завершается ошибкой, если отклонены все контакты, и устанавливает **Частичный успех**, если отклонена только часть контактов. **Запустить кампанию** запускает или возобновляет кампанию, в которой есть хотя бы один контакт. Требуется **Согласие на списание средств**. См. [Исходящие кампании](/ru/guides/outbound-campaigns). ## Перед тем как Zap совершит звонки Совершить исходящий звонок и Запустить кампанию набирают реальные телефонные номера и запускают платные звонки. - Если ThunderPhone просит вашу организацию подтвердить, что её исходящие звонки соответствуют TCPA и другим законам о звонках, администратор должен зафиксировать это подтверждение в панели управления, прежде чем Zap сможет начать звонки. - Номер отправителя должен быть включён для исходящих звонков. Номера, которые вы переносите от своего оператора связи, становятся доступными после проверки. Номера, предоставленные ThunderPhone, изначально доступны только для входящих звонков, а доступ к исходящим звонкам для них можно запросить в панели управления. См. [Получить номер телефона](/ru/guides/get-a-phone-number). - Для действия Совершить исходящий звонок требуется **Ключ идемпотентности**. Сопоставьте стабильный ID из триггера или исходной записи, например ID события ThunderPhone или ID записи CRM. Если Zapier повторит этап, ThunderPhone распознает ключ и вернёт исходный звонок вместо создания второго. Не используйте временные метки, случайные значения или только ID Zap. - Для действия Запустить кампанию требуется **Согласие на списание средств**, которое подтверждает, что Zap может запускать платные исходящие звонки для вашей учётной записи. - Ваша организация отвечает за наличие согласия на звонок по каждому номеру и за соблюдение применимых законов о звонках. См. [законы об исходящих звонках](/ru/guides/outbound-calling-laws). Ключ идемпотентности уникален для всей вашей организации и может содержать не более 128 символов. Повторное использование ключа с другим агентом, номером или переменными приводит к ошибке конфликта, поэтому, если два Zap могут звонить по поводу одной и той же записи, добавьте каждому Zap собственный фиксированный префикс перед ID записи. [Совершение исходящих звонков](/ru/guides/place-outbound-calls) описывает API, лежащий в основе этого действия. ## Примеры Zaps - **Завершённый звонок в CRM.** Регистрируйте действие для каждого завершённого звонка с его статусом, причиной завершения и расшифровкой. - **Оценённый звонок для дальнейшей работы.** Фильтруйте по результату или оценке звонка и направляйте звонок в нужный сценарий дальнейшей работы. - **Новый лид в кампанию.** Добавьте лида в черновик кампании с помощью Add Contacts to Campaign, затем запустите Start Campaign после того, как кто-то утвердит список. Расшифровки, сводки и записи звонков могут содержать персональную информацию или сведения о здоровье. Отправляйте их только в приложения, которые ваша организация имеет право использовать для таких данных, по соглашению BAA, если речь идёт о сведениях о здоровье, и храните только необходимые поля. ## Устранение неполадок **Шаг завершается ошибкой авторизации.** Повторно подключите ThunderPhone в Zapier и снова подтвердите доступ. Подключение перестаёт работать, если человек, который его подключил, отзывает его в ThunderPhone в разделе **Организация → Ключи → Авторизованные приложения**, покидает организацию или если в течение 30 дней не было успешного обновления токена. См. [Подключение через OAuth](/ru/guides/oauth). **Не удаётся включить или отключить Zap либо действие отклоняется.** Человеку, который подключил приложение, нужна роль администратора или владельца в организации. Повторно подключитесь с аккаунтом, у которого есть эта роль. Уже включённый триггерный Zap продолжает получать события звонков после изменения роли или отзыва подключения. Отключите его, чтобы остановить поступление событий. **Вы хотите отключить приложение.** Отключите свои Zaps ThunderPhone до отзыва подключения, так как при отключении Zap удаляется его конечная точка и требуется рабочее подключение. Если вы сначала отозвали подключение, удалите оставшуюся конечную точку **Zapier: …** с помощью `DELETE /v1/developer/webhook-endpoints/{id}`, используя API-ключ администратора. См. [Конечные точки вебхуков](/ru/webhooks/endpoints). **Zap должен использовать другую организацию.** Каждое подключение относится к одной организации. Сначала отключите Zap, чтобы его конечная точка вебхука была удалена из текущей организации. Затем подключите новый аккаунт ThunderPhone в Zapier, выберите другую организацию при подтверждении доступа и укажите это подключение на каждом шаге ThunderPhone. Агенты, номера и кампании различаются между организациями, поэтому снова выберите **Агент**, **Исходящий номер** и **Кампания** на каждом шаге, где они есть. Затем снова включите Zap. **Триггер перестал срабатывать.** Каждый Zap с триггером ThunderPhone использует одну конечную точку вебхука в вашей организации с именем **Zapier: Звонок завершён** или **Zapier: Звонок оценён**. Она создаётся при включении Zap и удаляется при его отключении. Не изменяйте её. Если она была изменена или удалена в ThunderPhone, отключите и снова включите Zap, чтобы создать новую. С API-ключом администратора [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) показывает последние попытки доставки. Хотите, чтобы агент использовал действия Zapier во время звонка, а не после него? Подключите конечную точку Zapier MCP в разделе **Подключения → MCP**. См. [Серверы MCP](/ru/guides/mcp-servers). Чтобы отправлять те же события звонков на собственный сервер, см. [Конечные точки вебхуков](/ru/webhooks/endpoints).