Загружайте контакты в колл-листы автоматически — из AmoCRM, Bitrix24, своих систем или любого другого источника. Настроили один раз, дальше контакты попадают в нужный колл-лист сами.

​
Типы интеграций

API — универсальный вариант. Подходит для любых внешних систем: AmoCRM, Bitrix24, своих сервисов или любого источника который умеет отправлять HTTP-запросы. DMP — только для интеграции с dmp.one. Сайт-источник автоматически конвертируется в тег контакта. Bitrix24 — автоматически получает контакты и лиды через исходящий вебхук Bitrix24. Система сама запрашивает полные данные через Bitrix24 REST API. AmoCRM — автоматически получает контакты через вебхуки AmoCRM.

​
Создание интеграции

В интерфейсе платформы два разных сценария: входящие webhook-интеграции (API, DMP) создаются в карточке колл-листа, а Bitrix24 и AmoCRM — в разделе «Интеграции» (вкладка CRM), где отдельно выбирается колл-лист. Через публичный API бэкенда по-прежнему можно создать интеграцию любого из четырёх типов (см. эндпоинт создания интеграции в вашей среде).

​
API и DMP (webhook)

1

Откройте колл-лист

В интерфейсе выберите нужный колл-лист — интеграция привязывается к нему автоматически
2

Создание

Нажмите «Создать интеграцию» на странице интеграций колл-листа
3

Поля формы

Доступны только типы API (Webhook) и DMP:
  • Название (обязательно)
  • Описание (опционально)
  • Тип интеграции — api или dmp
4

Webhook URL

После создания отображается уникальный webhook URL адрес, на который можно отправлять контакты

​
Bitrix24 и AmoCRM (CRM)

1

Раздел «Интеграции»

Откройте Интеграции в меню организации и перейдите на вкладку CRM
2

Добавление

Нажмите «Добавить интеграцию» (или аналогичную кнопку в таблице CRM-интеграций)
3

Поля формы

  • Название (обязательно)
  • Описание (опционально)
  • CRM — Bitrix24 или AmoCRM
  • Колл-лист — выбор из списка (куда загружать контакты)
  • Для Bitrix24 — URL вебхука REST API (settings.bitrixWebhookUrl; в форме указывается как URL вебхука Битрикс24)
4

Webhook URL

После создания вы получите URL, который нужно указать в настройках исходящего вебхука в CRM (см. разделы Bitrix24 и AmoCRM)
Пошаговая настройка на стороне CRM: Интеграция с Битрикс24, Интеграция с AmoCRM.

​
Ограничения

  • Webhook URL является конфиденциальной информацией — не передавайте его третьим лицам
  • Максимальное количество интеграций на один колл-лист: 20
  • Интеграция типа Bitrix24 — не более 1 на организацию
  • Интеграция типа AmoCRM — не более 1 на организацию
  • Максимальное количество контактов в одном запросе: 5000

​
Обработка ошибок

КодЧто значитЧто делать
200 OKКонтакты успешно загружены—
400 Bad RequestНекорректные данныеПроверьте: наличие поля phone, статус интеграции, лимиты, тип интеграции. Для Bitrix24: наличие bitrixWebhookUrl. Для AmoCRM: наличие контактов с телефоном в вебхуке
404 Not FoundИнтеграция не найденаПроверьте правильность webhook URL

​
Технические детали

  • Уникальные контакты определяются по номеру телефона в рамках колл-листа
  • Дубликаты не добавляются повторно
  • Номера телефонов нормализуются к формату 7XXXXXXXXXX
  • Поддерживаются добавочные номера — через запятую или ext
  • При отправке большого количества контактов разбивайте запросы на части до 5000 записей