Разработка виджетов для amoCRM

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

Что можно сделать виджетом

• Расчёт в карточке. Калькулятор стоимости, ипотеки, рассрочки или скидки, результат которого записывается в поля сделки.
• Документы. Договор, КП или счёт по шаблону из данных сделки в один клик.
• Данные из внешней системы. Остатки, статус заказа, история оплат из учёта, показанные прямо в карточке.
• Связь со своим продуктом. Например, наша шахматка Kvadrum синхронизирует брони и сделки с amoCRM, и менеджеру не нужно сверять статусы квартир вручную.
• Действия в автоматизации. Шаг, который Salesbot или Digital Pipeline вызывает на определённом этапе: отправить данные во внешний сервис, получить ответ, заполнить поле.

Как устроен виджет технически

Виджет для amoCRM состоит из двух частей. Клиентская часть — архив с манифестом и JavaScript, который amoCRM загружает в интерфейс: в карточку, список, настройки или отдельную страницу. Серверная часть — наш сервис, который общается с amoCRM через REST API v4, авторизуется по OAuth 2.0 и принимает вебхуки о событиях в аккаунте.

Ключи доступа живут только на сервере. В браузере менеджера нет ничего, что позволило бы получить доступ к вашей CRM. Сервер, HTTPS, бэкапы и мониторинг мы берём на себя, код остаётся у вас.

Разработка виджетов для amoCRM: что решить до старта

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

Где виджет нужен. Только в сделке или ещё в контакте, списке, на отдельной странице. От этого зависит объём работы.

Кто им пользуется. Всем менеджерам или только части. Права виджета настраиваются отдельно.

Тариф amoCRM. Возможности API и интеграций зависят от тарифа, проверяем до разработки.

Что вы получаете на выходе

Виджет установлен в ваш аккаунт и проверен на реальных сделках. Исходный код передаём вам или храним в вашем репозитории, доступы к серверу и аккаунтам интеграции тоже ваши. Отдельно описываем, что виджет делает, какие поля использует и что произойдёт, если эти поля переименовать. Это важно: самая частая причина поломки своих виджетов — кто-то в компании поменял поле, не зная, что от него зависит интеграция.

Чем виджет отличается от отдельного сервиса

Если задача живёт внутри работы с конкретной сделкой, виджет удобнее: менеджер не уходит из CRM. Если это отдельный процесс, например склад, кабинет клиента или дашборд для собственника, лучше отдельный сервис, связанный с amoCRM через API. Пример такого подхода в Битрикс24 — наш калькулятор ипотеки, встроенный пунктом меню. Не уверены, что нужно, опишите задачу, подскажем.

Небольшой виджет с расчётом или документом обычно занимает от пяти дней. Если виджет связывает amoCRM с внешней системой, сначала делаем прототип, чтобы проверить, что нужные данные доступны через API с обеих сторон, и только потом пишем всё целиком.