Интеграция amoCRM и U-ON.Travel под ключ

Что синхронизировать между amoCRM и U-On-Travel

Для корректного ведения воронки продаж и учета в туристическом бэк-офисе необходимо маппить следующие сущности через API:

• Клиент (amoCRM /api/v4/contacts) → Турист (U-On-Travel /crm.client.add): Перенос ФИО, email и телефона для создания карточки в базе U-On.
• Сделка (amoCRM /api/v4/leads) → Заявка (U-On-Travel /crm.lead.add): Синхронизация статуса оплаты и даты вылета для автоматического формирования договора.
• Бюджет сделки (amoCRM custom_fields_values) → Стоимость тура (U-On-Travel cost_sum): При изменении суммы в amoCRM через метод PATCH /api/v4/leads/{id} обновляется поле цены в заявке U-On.
• Дата начала тура (amoCRM custom_fields) → Дата вылета (U-On-Travel date_begin): Передача метаданных сделки в поля типа "дата" в U-On-Travel.
• Ответственный менеджер (amoCRM responsible_user_id) → Менеджер (U-On-Travel manager_id): Привязка карточки к конкретному сотруднику по ID в обеих системах.

Технические детали интеграции amoCRM ↔ U-On-Travel

• Направление синхронизации: Двусторонняя. Изменения в amoCRM отправляются через Webhooks (событие leads_add, leads_update), изменения в U-On-Travel — через опрос API методом /crm.lead.list с фильтром по date_update.
• Формат данных: JSON. Требуется строгая типизация полей (особенно для дат в формате YYYY-MM-DD и телефонных номеров в E.164).
• Обработка конфликтов: Используется стратегия "последний по времени записи выигрывает". При расхождении данных приоритет отдается timestamp в поле date_update каждой системы.
• Частота обновления: Webhooks для amoCRM срабатывают моментально. Опрос API U-On-Travel настроен с интервалом в 1-5 минут для предотвращения превышения лимитов (Rate Limit 60 запросов/мин).
• Обработка удалений: Удаление сделки в amoCRM (через /api/v4/leads/{id}) помечает статус заявки в U-On-Travel как «Аннулирована» через /crm.lead.update. Полное удаление данных из базы U-On не рекомендуется для сохранения истории отчетности.
• Retry-логика: При получении HTTP-кодов 429 (Too Many Requests) или 5xx реализуется экспоненциальная задержка (backoff) до 5 попыток перед логированием ошибки в системе мониторинга.

Частые вопросы про amoCRM + U-On-Travel

Как настроить авторизацию API?
Для amoCRM используйте OAuth 2.0 (получение access_token через /oauth2/access_token). Для U-On-Travel необходимо сгенерировать API-ключ в разделе «Настройки» — «Интеграция» и передавать его в заголовке api_key каждого запроса.

Что происходит, если один из сервисов недоступен?
Система интеграции использует очередь сообщений (Queue). При сбоях запросы накапливаются и автоматически повторяются после восстановления связи, исключая потерю данных по сделкам.

Существуют ли лимиты API?
amoCRM ограничивает запросы в зависимости от тарифа, U-On-Travel допускает до 1000 запросов в сутки на базовых тарифах. При превышении необходимо использовать кэширование данных на промежуточном сервере.

Как система обрабатывает дубликаты?
Перед созданием клиента выполняется поиск по методам /api/v4/contacts?query={phone} в amoCRM и /crm.client.list?phone={phone} в U-On-Travel. Если ID найден, система обновляет существующую карточку вместо создания новой.

Насколько быстро обновляются данные?
При создании лида в amoCRM данные попадают в U-On-Travel в течение 2-5 секунд через Webhook. Обратная синхронизация статусов из U-On-Travel занимает до 5 минут в зависимости от частоты Cron-задачи.

Настроить связку amoCRM + U-On-Travel под ключ — flowframe.ru, от 40 000 ₽, срок 7-21 день.