Как настроить интеграцию облачной АТС и CRM через вебхуки и не потерять лиды

Интеграция облачной АТС и CRM через вебхуки связывает входящие звонки с карточкой клиента ещё до того, как менеджер снимет трубку. В статье разберём по шагам, какие события телефонно отдаёт облачная АТС, как настроить приём webhook в CRM, что учесть при смене тарифа оператора и как не потерять лиды, если вебхук однажды не дошёл. Подойдёт малому и среднему бизнесу, который ведёт продажи в Bitrix24, amoMe или аналогичной системе и хочет видеть историю звонков рядом с перепиской.

Зачем вообще связывать АТС и CRM через вебхуки

В облачной АТС для бизнеса каждый звонок — это событие: входящий вызов, ответ менеджера, завершение разговора, пропущенный вызов, запись разговора. Если эти события не попадают в CRM, менеджер узнаёт о клиенте только когда сам перезвонит. А webhook — это способ доставить событие из АТС прямо в CRM за секунду.

В итоге связка решает три задачи. Первая — входящий звонок автоматически открывает карточку контакта и поднимает историю прошлых обращений. Вторая — пропущенный вызов сразу создаёт задачу или сделку, чтобы никто не забыл перезвонить. Третья — отчёт по звонкам и записям разговоров хранится в одном месте, рядом с почтой и чатами. Для небольшого отдела продаж на 3–5 человек это разница между «наверное, перезвоним» и контролируемой работой с клиентами.

Какие события телефонно передаёт облачная АТС

Перед настройкой важно понять, какие события АТС готова отдавать наружу. У разных провайдеров набор отличается, но ядро одинаковое:

• incoming_call — поступил входящий звонок на номер компании.
• call_answered — менеджер снял трубку.
• call_ended — звонок завершён, есть длительность и статус.
• missed_call — звонок пропущен, никто не ответил.
• recording_ready — запись разговора сохранена и доступна по ссылке.
• voicemail — клиент оставил голосовое сообщение.

Для интеграции с CRM ключевые — incoming_call, call_ended и missed_call. Этих трёх событий обычно хватает, чтобы карточка клиента открывалась автоматически, а пропущенные вызовы не терялись.

Как технически устроен webhook от АТС

Webhook — это обычный HTTP-запрос, который АТС отправляет на ваш адрес, когда случается событие. Схема простая:

1. АТС фиксирует событие, например, входящий звонок.
2. АТС формирует JSON-пакет с номером клиента, временем, внутренним номером менеджера.
3. АТС делает POST-запрос на URL вида https://ваш-сервис/crm/webhook/atc.
4. CRM получает запрос, ищет контакт по номеру телефона и открывает карточку.

Чтобы webhook заработал, в личном кабинете АТС нужно указать URL приёмника и иногда — секретный ключ для подписи запросов. Без ключа любой, кто угадает адрес, сможет слать вам фейковые «звонки». С ключом — нет.

Что учесть при смене тарифа или переезде на новую версию АТС

Самый частый сценарий потери лидов — смена тарифа у оператора связи или обновление API. Выглядит это так: вчера webhook работал, сегодня в CRM перестали появляться входящие. Причины почти всегда одни и те же:

• URL приёмника сбросился на пустой после обновления интерфейса.
• Изменился формат JSON, и CRM не распознаёт поле с номером.
• На новом тарифе webhook доступен только как платная опция.
• Сменился домен API, а в настройках CRM остался старый.

До перехода на новый тариф стоит заглянуть в раздел «Интеграции» и проверить три вещи: поддерживает ли выбранный тариф отправку webhook на внешние системы, остался ли URL и секретный ключ, и не нужно ли заново выпускать токен. После перехода — открыть тестовый звонок и убедиться, что событие дошло до CRM. Если события не видно — лиды потеряются.

Как не потерять лиды, если вебхук однажды не дошёл

Webhook — это обычный HTTP-запрос, а значит, он может не дойти: сервер CRM был на обслуживании, сетевая ошибка, превышен таймаут. Хорошая связка «АТС + CRM» учитывает это и страхуется.

Минимальная страховка для малого бизнеса — журнал webhook и виджет телефонии. Если у АТС нет встроенной очереди, попросите поддержку включить повторные попытки, обычно это делается за один тикет.

Типичные ошибки при интеграции АТС и CRM

• Указывают webhook без секретного ключа — CRM принимает запросы от кого угодно.
• Используют http:// вместо https:// — современные CRM такие адреса блокируют.
• Не делают тестовый звонок после любых изменений в ЛК АТС — лиды теряются сразу после смены тарифа.
• Слушают только событие call_ended и забывают про missed_call — половина входящих остаётся без реакции.
• Хранят токен доступа в открытом виде в коде сайта — при утечке доступ к webhook смогут получить посторонние.
• Платят за дорогой тариф АТС только ради интеграции, хотя для 3–5 менеджеров достаточно базового пакета с webhook.

Что важно проверить перед запуском

Перед тем как открывать интеграцию для всей команды, прогоните сценарий от звонка до сделки. Позвоните на корпоративный номер с личного телефона — карточка в CRM должна открыться. Сбросьте вызов — должна появиться задача или сделка с помогой «пропущенный, перезвонить». Позвоните ещё раз и дождитесь записи — через пару минут запись должна появиться в карточке контакта. Если хотя бы один шаг не сработал, лиды уйдут в первую же неделю.

Дополнительно стоит заглянуть в раздел «Интеграции» в личном кабинете АТС и убедиться, что стоит галочка «отправлять события при ошибке повторно». Без неё одна неудачная попытка — и клиент остаётся без внимания.