Подключение Albato к Битрикс24 подтверждает только то, что сервисы видят друг друга. Рабочая связка должна еще создать нужную запись, заполнить ее без потери полей и предсказуемо обработать повторное событие. Если проверить лишь первый запуск, ошибка может обнаружиться позже, когда в CRM уже появились дубли или пустые карточки.
Ниже порядок для одной связки, например передачи заявки из формы в Битрикс24. Это условный сценарий, а не описание клиентского проекта. Сервис-источник может быть другим. Проверки остаются теми же: событие, данные, поиск существующей записи, действие и результат.
Сначала запишите, что должно появиться в CRM
До конструктора связки сформулируйте результат в терминах Битрикс24. Нужен новый контакт, новая сделка, обновление существующей карточки или задача менеджеру? Слово «заявка» не отвечает на этот вопрос: в разных CRM-процессах ее хранят по-разному.
Для условной формы карта выглядит так:
Таблица прокручивается по горизонтали
| На входе | Проверка до настройки | Ожидаемое действие |
|---|---|---|
| ID отправки формы | Сохраняется ли он при повторной передаче | Найти уже обработанную заявку или записать ID для контроля |
| Телефон и email | Приходят ли значения и в каком формате | Найти контакт по согласованному правилу или создать новый |
| Выбранная услуга | Есть ли соответствующее поле в CRM | Записать значение в нужное поле сделки |
| Согласие на связь | Передается ли его состояние | Не отправлять обращение в неподходящую коммуникацию |
| Ответственный | Кто принимает новую сделку | Назначить сотрудника или очередь по принятому правилу |
Таблица не означает, что в Albato есть готовое действие для каждой строки. Доступные триггеры, поля и действия надо проверить в конкретных подключениях. Если на этом этапе неизвестно, кто владеет данными и что считать дублем, конструктор лишь закрепит неопределенность.
Подключите сервисы и проверьте права
Официальная инструкция Albato по Битрикс24 предлагает сначала установить приложение в портале, затем создать подключение в Albato. При создании указывают адрес портала, формат телефона и регион, после чего подтверждают доступ. Возможность установки приложения и доступ к нужным функциям зависят от тарифа и подписки: актуальные правила Маркетплейса Битрикс24 нужно сверить для своего портала до начала работ.
После подключения проверьте не только сообщение об успехе, но и доступность нужного действия. Например, связка может видеть сделки, но у подключенного пользователя не будет права менять поле или создавать задачу в нужном подразделении. Для проверки достаточно одной тестовой записи с известными значениями. Работать с реальными контактами клиента без согласованного порядка доступа не нужно.
Настройте событие, фильтр и соответствие полей
Связка Albato состоит из триггера и действий. Триггер сообщает о событии в исходной системе, затем действия работают с полученными данными. Справка Albato о принципе связки отдельно объясняет, что при получении нескольких объектов обрабатываются отдельные циклы. Поэтому проверка одного успешного цикла не заменяет проверку всей порции данных.
Выберите событие, которое действительно означает готовую заявку. Если форма сохраняет черновик, а затем отправляет его, запуск на любое изменение может обработать обращение раньше времени. В фильтре входящих данных Albato можно задать условие, при котором связка продолжит работу. Проверяйте условие на реальном значении поля из тестового события, а не только по названию поля в интерфейсе.
Затем сопоставьте каждое обязательное поле с источником. Нельзя считать телефон переданным потому, что он есть в форме: откройте образец данных триггера и проверьте значение, которое получило действие Битрикс24. Если поле пустое уже на входе Albato, настройка CRM его не восстановит. Если оно есть на входе и пропало в карточке, искать нужно в сопоставлении или ответе действия.
Повторите одно событие до запуска в рабочую базу
Первая отправка проверяет создание записи. Вторая проверяет логику повторной обработки. До теста решите, что должно произойти с тем же человеком и той же заявкой: обновление контакта, новая сделка по новой потребности или отсутствие повторного создания. Это бизнес-правило, а не универсальная настройка «убрать дубли».
Albato описывает отдельные сценарии обработки дублей для Битрикс24. В одном из них контакт ищут по телефону и email, а затем выбирают действие в зависимости от результата поиска. Копировать схему целиком не стоит: у вашего процесса могут быть другие ключи и правила обновления. Особенно проверьте, не перезапишет ли повторная заявка сведения, которые менеджер уже исправил вручную.
Для приемки достаточно нескольких разных исходов:
- Новый человек, новая заявка: появилась ожидаемая карточка со всеми обязательными полями.
- То же событие передано повторно: не возникла лишняя карточка.
- Существующий контакт отправил новую заявку: решение по новой сделке соответствует правилу процесса.
- В форме нет обязательного поля: связка показывает контролируемую ошибку или передает заявку в согласованный разбор, а не создает молча неполную запись.
Это сценарии проверки, не обещание, что Albato сам выберет правильное действие. Его задают в связке и проверяют на контрольных данных.
Тест шага и рабочий запуск отвечают на разные вопросы
В Albato можно протестировать отдельные шаги и всю связку. Справка о тестировании уточняет два важных ограничения: тесты отдельных шагов не попадают в журнал связки, а фильтры первого шага проверяют при тесте всей связки. Поэтому зеленый результат одного действия еще не доказывает, что событие будет проходить фильтр в рабочем режиме.
Тест действия выполняет его один раз, поэтому для проверки создания контакта или сделки используйте тестовые данные и согласованную среду. После тестов запустите связку на контролируемом событии. Сопоставьте запись в журнале Albato с исходной заявкой и карточкой Битрикс24. В задаче на приемку сохраните время, ID входного события, ID созданного или обновленного объекта и результат каждого действия. Если данные клиента нельзя хранить в общем доступе, используйте обезличенный пример с сохранением технических идентификаторов только в защищенной системе проекта.
Назначьте человека, который увидит сбой
Связка может перестать выполнять часть сценария после изменения прав, поля или ответа внешнего сервиса. Albato показывает ошибки в журнале и описывает повторную отправку. Повторный запуск следует делать после проверки причины и результата предыдущих шагов: иначе можно создать вторую запись, пока первая уже есть в CRM.
Передайте ответственному короткий регламент: где смотреть ошибку, какой ID сверять с CRM, когда допустим повтор и кому сообщать о проблеме с доступом. Проверка заканчивается не надписью «связка включена», а понятным ответом на вопрос, кто заметит следующую неудачную передачу.
Если правило движения данных еще не согласовано или неизвестно, какие действия доступны в двух системах, начните с разбора сценария интеграции через Albato. Там можно описать источник, событие, объекты Битрикс24 и ожидаемое число запусков до выбора конкретной связки.
