AtomsTravel — автоматическое создание сделок
AtomsTravel — это виджет для OkoCRM, который автоматически создаёт сделки по событиям заказов из сервиса atomstravel.com (платформа автоматизации туристических агентств). Виджет принимает вебхуки на четыре типа событий: создание, подтверждение, оплата и отмена заказа — и под каждое событие создаёт в CRM новую сделку в выбранной воронке с назначенным ответственным.
Эта инструкция расскажет, как получить API-ключ, настроить вебхуки и куда CRM будет складывать сделки.
Что внутри
1. Установка виджета
2. Получение API-ключа AtomsTravel
3. Сохранение API-ключа в OkoCRM
4. Настройка четырёх типов событий
5. Подключение вебхуков на стороне AtomsTravel
6. Что происходит при получении вебхука
7. Частые вопросы
1. Установка виджета
AtomsTravel устанавливается из магазина приложений OkoCRM, как любая другая интеграция.
Откройте Настройки → Интеграции и найдите карточку AtomsTravel.
2. Получение API-ключа AtomsTravel
В личном кабинете atomstravel.com перейдите в раздел настроек API и скопируйте access_token. Это длинная строка вида 46c21a7875e443e2930db7acedc95203.
Если такого раздела не видно — обратитесь в поддержку AtomsTravel и попросите выдать API-ключ для интеграции с CRM.
3. Сохранение API-ключа в OkoCRM
На странице интеграции AtomsTravel найдите поле API ключ, вставьте скопированный токен и нажмите Сохранить.
После сохранения станет доступна кнопка Настройка интеграции — переходите к следующему шагу.
4. Настройка четырёх типов событий
Нажмите Настройка интеграции. Откроется страница с четырьмя блоками:
— Заказ создан — когда менеджер только оформил заказ в AtomsTravel;
— Заказ подтверждён — когда поставщик подтвердил бронь;
— Заказ оплачен — когда клиент полностью оплатил;
— Заказ отменён — когда заказ отменён по любой причине.
В каждом блоке есть четыре поля.
Ссылка на вебхук — уникальный URL для этого типа события. Нажмите кнопку Копировать рядом с полем — URL скопируется в буфер обмена. Этот URL вы вставите в AtomsTravel на следующем шаге.
Воронка — выберите воронку, в которую будут попадать сделки этого типа. Например, для «Заказ создан» — воронка «Новые заявки», а для «Заказ оплачен» — «Подготовка документов».
Этап воронки — выберите этап внутри выбранной воронки. Список этапов автоматически фильтруется по выбранной воронке.
Ответственный — выберите либо конкретного пользователя, либо очередь распределения. Если выбрана очередь — сделка распределится по правилам очереди (например, по кругу или по нагрузке).
Если для какого-то события воронка или этап не выбраны — вебхук будет приниматься, но сделка не создастся. Так можно отключить ненужные типы событий, оставив только те, что вам важны.
После заполнения всех блоков нажмите Сохранить.
5. Подключение вебхуков на стороне AtomsTravel
Перейдите обратно в личный кабинет AtomsTravel в раздел вебхуков. Там нужно создать четыре подписки — по одной на каждый тип события — и в каждую вставить соответствующий URL, который вы скопировали в OkoCRM.
Например:
— Событие «Заказ создан» → URL из блока «Заказ создан» в OkoCRM;
— Событие «Заказ подтверждён» → URL из блока «Заказ подтверждён» в OkoCRM;
— И так далее.
После подключения сохраните настройки в AtomsTravel. С этого момента AtomsTravel будет автоматически слать события в OkoCRM.
6. Что происходит при получении вебхука
Когда AtomsTravel шлёт событие на ваш CRM-вебхук, OkoCRM:
1. Находит контакт по телефону или email клиента (или создаёт новый, если такого ещё нет в CRM).
2. Создаёт сделку в той воронке и на том этапе, что вы выбрали для этого типа события.
3. Назначает ответственным выбранного пользователя или передаёт сделку в очередь.
Каждое событие создаёт отдельную сделку. То есть если один и тот же заказ прошёл через все четыре события (создан → подтверждён → оплачен), в CRM появится четыре сделки. Это сделано специально, чтобы каждая стадия была видна в нужной воронке. Если такое поведение вам не подходит — оставьте настройку только для тех событий, что вам важны (например, только «Заказ оплачен» → одна сделка на оплаченный заказ).
7. Частые вопросы
«Сделки не создаются» — проверьте, что API-ключ сохранён, вебхуки подключены в AtomsTravel, а в нужных блоках выбраны воронка и этап. Без воронки или этапа событие игнорируется.
«В сделке нет суммы / имени клиента» — виджет берёт данные из тела вебхука. Если поле не пришло, оно остаётся пустым. Проверьте в AtomsTravel, какие поля включены в вебхук.
«Хочу одну сделку, которая двигается по этапам, а не четыре» — текущая версия виджета создаёт отдельную сделку на каждое событие. Для прохождения по этапам одной сделкой настройте только нужное вам событие или обратитесь к нам — функция запланирована.
«Где взять API-ключ AtomsTravel?» — в личном кабинете atomstravel.com, в настройках API. Точное расположение лучше уточнить у поддержки AtomsTravel.
«Поменял настройки воронки — старые сделки не переехали» — настройки применяются только к новым входящим событиям. Уже созданные сделки остаются там, где были.
