# Как добавить источник

Добавление источника через вход в сервис занимает несколько минут. С токеном или вебхуком дольше: ключ нужно сначала получить в кабинете сервиса, а вебхук настраивает разработчик. Визард проведёт через четыре шага: выбор источника → доступ → поля → дополнительные настройки. Четвёртый шаг есть не у всех коннекторов.

Перейдите в раздел **Подключения** и нажмите **\+ Добавить источник**.

![Страница подключений — пустое состояние](https://help-ru.romi.center/images/kak-dobavit-istochnik/01-empty-state.png)

## Шаг 1. Выберите источник

Откроется каталог источников. Они разбиты на четыре категории:

*   **Реклама** — Яндекс Директ, Google Ads, VK Реклама, Telegram Ads, TikTok Ads, Авито, Facebook Ads и другие
*   **Аналитика** — Яндекс Метрика, Google Analytics 4, Google Search Console, Яндекс Вебмастер и другие
*   **CRM** — amoCRM, Битрикс24, GetCourse, EnvyCRM, U-ON Travel, Своя CRM
*   **Прочее** — Google Таблицы, Импорт CSV

Если не знаете в какой категории искать — используйте строку поиска, она ищет по названию и синонимам.

![Каталог источников](https://help-ru.romi.center/images/kak-dobavit-istochnik/02-catalog.png)

Нажмите на карточку нужного источника и перейдите к следующему шагу.

## Шаг 2. Предоставьте доступ

Здесь нужно дать ROMI center разрешение читать данные из вашего аккаунта. Способ зависит от источника.

Найдите свой источник в таблице и перейдите к нужному подразделу ниже.

| Способ | Источники | Что делать |
| --- | --- | --- |
| Вход через сервис (OAuth) | Яндекс Директ, Яндекс Метрика, Яндекс Метрика Logs API, Яндекс Вебмастер, Google Ads, Google Analytics 4, Google Search Console, VK Реклама, TikTok Ads, Facebook Ads, Авито, amoCRM | Нажать кнопку входа и разрешить доступ |
| Токен, ключ или вебхук | Битрикс24, GetCourse, EnvyCRM, U-ON Travel, LiveDune, Salebot, Senler | Взять ключ в кабинете сервиса и вставить в ROMI center |
| Доступ в рекламном кабинете | Telegram Ads | Выдать доступ нашему аккаунту и указать своё название |
| Вебхук ROMI center | Своя CRM | Настроить отправку данных из вашей системы |
| Файл или таблица | Google Таблицы, Импорт CSV | Войти через Google и указать файл либо загрузить CSV |

### Вход через сервис (OAuth)

Большинство рекламных платформ, аналитики и amoCRM работают через OAuth: Яндекс Директ, Яндекс Метрика, Яндекс Метрика Logs API, Яндекс Вебмастер, Google Ads, Google Analytics 4, Google Search Console, VK Реклама, TikTok Ads, Facebook Ads, Авито, amoCRM.

Нажмите кнопку «Войти через Яндекс» (или Google / VK — в зависимости от источника). Откроется окно авторизации сервиса. Войдите в нужный аккаунт и разрешите доступ. После этого вы вернётесь в ROMI center автоматически.

Если у вас несколько рекламных аккаунтов в одном сервисе — после авторизации выберите нужный из списка.

В amoCRM так же: поддомен аккаунта (например `acme` для `acme.amocrm.ru`) вводить не нужно, после авторизации вы выбираете его из списка.

![Шаг авторизации — OAuth](https://help-ru.romi.center/images/kak-dobavit-istochnik/03-oauth.png)

> **Важно**
> Сменить аккаунт после создания подключения нельзя. Если нужен другой аккаунт — создайте новое подключение.

### API-токен

Некоторые источники используют токен, ключ или вебхук: Битрикс24, GetCourse, EnvyCRM, U-ON Travel, LiveDune, Salebot, Senler и другие.

Ключ — это строка вида `a1b2c3d4e5f6...`, которую вы берёте в настройках своего кабинета. Для работы нужны права администратора в подключаемом аккаунте. Если ключ выдан пользователю с ограниченными правами — авторизация не пройдёт или данные будут неполными.

| Источник | Что ввести в ROMI center | Где взять | Документация |
| --- | --- | --- | --- |
| Битрикс24 | «Вебхук для вызова rest api» — адрес вида `https://ваш-портал.bitrix24.ru/rest/1/секретный_код/` | **Приложения → Разработчикам → Другое → Входящий вебхук**. В правах доступа отметьте **CRM** и **Пользователи**. Если пункта «Входящий вебхук» нет, создание вебхуков вам не разрешено: попросите администратора включить его в **Настройки → Настройки Битрикс24 → Безопасность → Интеграции Битрикс24** | [Входящие и исходящие вебхуки](https://apidocs.bitrix24.ru/local-integrations/local-webhooks.html) |
| GetCourse | Адрес аккаунта и секретный ключ API | **Профиль → Настройки аккаунта → API**, кнопка создания ключа. Создать ключ может владелец аккаунта или администратор с правом «Может настраивать аккаунт». Полный ключ показывается один раз — скопируйте его сразу | [Ключ API в GetCourse](https://getcourse.ru/blog/1053682) |
| EnvyCRM | API-ключ пользователя с правами администратора. Домен и часовой пояс аккаунта ROMI center подтянет сам | Ключ выдаётся в настройках EnvyCRM | — |
| U-ON Travel | Адрес аккаунта вида `mycompany.u-on.ru` и API-ключ | **Настройки → Интеграции → API / WebHooks**: создайте ключ и включите для него методы GET и POST | [Документация API U-ON](https://api.u-on.ru/doc) |
| LiveDune | API-токен кабинета LiveDune | Токен выдаётся в кабинете LiveDune | — |
| Salebot | API-токен проекта Salebot и название подключения. Название входит в имя таблицы и после создания не меняется | Токен берётся в кабинете Salebot | — |
| Senler | API-ключ, название подключения, платформа (VK или Telegram) и ID группы VK или бота Telegram | **Настройки → Работа с API**, кнопка создания ключа доступа | [Ключи доступа Senler](https://help.senler.ru/senler/help/razrabotchikam/api/klyuchi-dostupa) |

Адрес аккаунта у U-ON Travel после создания подключения изменить нельзя: на нём построены имена таблиц. Название подключения у Senler сменить можно, но запись тогда пойдёт в новые таблицы, а прежние останутся с накопленными данными. У LiveDune токен у готового подключения не меняется — другой токен означает новое подключение.

### Доступ в рекламном кабинете (Telegram Ads)

У Telegram Ads нет API, поэтому токен здесь не нужен. Коннектор работает как робот в рекламном кабинете `ads.telegram.org`, и сначала ему нужно дать доступ к вашему аккаунту.

1.  Выдайте доступ к рекламному аккаунту Telegram Ads аккаунту [@romi\_center\_tg\_ads](https://t.me/romi_center_tg_ads).
2.  В ROMI center при создании подключения укажите название вашего рекламного аккаунта Telegram Ads.

Единой инструкции по выдаче доступа нет: она зависит от того, как вы покупаете рекламу. Чаще всего рекламу закупают через сервисы-посредники, и доступ к аккаунту выдаётся через них. В этом случае попросите поддержку или менеджера вашего сервиса добавить [@romi\_center\_tg\_ads](https://t.me/romi_center_tg_ads) к вашему рекламному аккаунту. Если вы работаете с кабинетом `ads.telegram.org` напрямую, доступ выдаётся в нём.

Как коннектор забирает данные: [Telegram Ads: как работает коннектор](https://help-ru.romi.center/telegram-ads-kak-rabotaet-konnektor). Если вам нужно передавать расходы Telegram Ads в счётчики аналитики, это отдельная настройка: [Передача расходов из Telegram Ads](https://help-ru.romi.center/peredacha-rashodov-iz-telegram-ads).

### Вебхук ROMI center (Своя CRM)

Если вашей CRM нет в каталоге, используйте коннектор «Своя CRM». Он ничего не запрашивает сам: ваша система (CRM, личный кабинет, биллинг) отправляет данные на адрес ROMI center, и каждый запрос становится строкой в таблице. Настройка требует участия разработчика.

**В ROMI center**

1.  На шаге «Доступ» введите название источника. ROMI center сразу покажет токен и адрес вебхука: скопируйте их и передайте разработчику. После создания подключения они не меняются.
2.  На шаге «Выбор полей» добавьте поля, которые будет присылать ваша система. У Своей CRM рекомендованного набора нет, поля задаёте вы сами: для каждого указываются «Имя поля (как в вебхуке)» — ключ в запросе, «Название в ROMI center» и тип. Нужно хотя бы одно поле.

**В вашей системе**

Разработчик должен отправлять POST-запрос на адрес вебхука каждый раз, когда нужно передать событие, например при смене статуса сделки. Один запрос — одно событие. Токен передаётся в адресе (`?token=…`, в показанный адрес он уже вставлен) или полем `token` в теле запроса. Данные — в теле в формате JSON с заголовком `Content-Type: application/json`. В таблицу попадают только те ключи, которые вы добавили в поля.

```
curl -X POST "АДРЕС_ВЕБХУКА_ИЗ_МАСТЕРА" \
  -H "Content-Type: application/json" \
  -d '{"token": "ВАШ_ТОКЕН", "id": "1020", "utm_source": "yandex", "sum": "1100"}'
```

В примере `id`, `utm_source` и `sum` — ключи, которые вы сами добавили в поля.

> **Важно**
> Тестовые запросы отправляйте после сохранения настроек мастера: события, присланные раньше, в таблицу не попадут. При неверном токене вебхук всё равно отвечает `status: ok`, но `matched_statuses` будет равен `0` — проверяйте это число.

Данные появляются в таблице в течение нескольких минут. Все правила и ограничения (размер запроса, повторы, вложенные объекты) — в статьях [Своя CRM: как работает коннектор](https://help-ru.romi.center/svoya-crm-kak-rabotaet-konnektor) и [Своя CRM: описание выгружаемых полей](https://help-ru.romi.center/svoya-crm-opisanie-vygruzhaemyh-polej).

### Файл или таблица (Google Таблицы, Импорт CSV)

**Google Таблицы.** Войдите через Google (у аккаунта должен быть доступ к файлу), вставьте ссылку на файл или его id и отметьте листы, которые нужно выгружать. Ссылка после создания подключения не меняется. Подробнее: [Google Таблицы: как работает коннектор](https://help-ru.romi.center/google-tablicy-kak-rabotaet-konnektor).

**Импорт CSV.** Перетащите файл в окно или выберите его на компьютере. Подойдёт файл `.csv` в кодировке UTF-8 до 100 МБ, первая строка становится названиями колонок. Это разовая загрузка: чтобы обновить данные, удалите подключение и загрузите файл заново. Подробнее: [Импорт CSV: как работает коннектор](https://help-ru.romi.center/import-csv-kak-rabotaet-konnektor).

## Шаг 3. Выберите поля

На этом шаге вы определяете, какие именно данные ROMI center будет выгружать. Рекомендованный набор уже отмечен — он покрывает большинство задач.

Подробнее о том как выбрать поля и как это влияет на стоимость хранения → [Как выбрать поля](https://help-ru.romi.center/kak-vybrat-polya).

## Шаг 4. Дополнительные настройки

Этот шаг есть только у части источников — рекламных платформ и некоторых CRM. Если у выбранного источника дополнительных настроек нет, визард пропускает этот шаг.

**НДС.** Яндекс Директ передаёт расходы с учётом НДС — переключатель включён по умолчанию. У остальных платформ НДС по умолчанию выключен. Настройте согласно тому, как источник отдаёт данные.

**UTM-метки.** Если в кампаниях метки не проставлены — можно задать их здесь, и ROMI center подставит их к выгружаемым данным. В самом рекламном кабинете ничего не изменится.

**Валюта.** Если кабинет ведётся не в рублях — ROMI center пересчитает расходы по курсу ЦБ на дату транзакции и добавит отдельную колонку. Исходная сумма в валюте кабинета сохраняется.

**Для CRM:** вместо перечисленного выше здесь задаётся часовой пояс аккаунта и глубина перезагрузки прошлых дней при обновлении.

![Шаг дополнительных настроек](https://help-ru.romi.center/images/kak-dobavit-istochnik/05-settings.png)

## После создания подключения

Нажмите **Создать подключение** (или **Сохранить** — на последнем шаге). Вы вернётесь на страницу Подключений и увидите новый источник со статусом «Загрузка истории».

Это значит, что ROMI center начал загружать данные за прошлые периоды. Это нормально — данные за этот период будут неполными, пока загрузка не завершится. Сколько это займёт и как отслеживать прогресс → [Статусы подключений и журнал выгрузок](https://help-ru.romi.center/statusy-podklyuchenij-i-zhurnal-vygruzok).

## Что дальше

*   Разобраться со статусами → [Статусы подключений и журнал выгрузок](https://help-ru.romi.center/statusy-podklyuchenij-i-zhurnal-vygruzok)
*   Посмотреть что за данные загрузились → [Как просмотреть данные](https://help-ru.romi.center/kak-prosmotret-dannye-podklyucheniya)
*   Изменить состав полей → [Как выбрать поля](https://help-ru.romi.center/kak-vybrat-polya)
*   Загрузить данные за конкретный период вручную → [Историческая выгрузка](https://help-ru.romi.center/istoricheskaya-vygruzka)
*   Узнать подробности по своему коннектору → [Документация по коннекторам](https://help-ru.romi.center/docs). Статьи «Как работает коннектор»:
    *   **Реклама:** [Яндекс Директ](https://help-ru.romi.center/yandex-direct-kak-rabotaet-konnektor), [Google Ads](https://help-ru.romi.center/google-ads-kak-rabotaet-konnektor), [VK Реклама](https://help-ru.romi.center/vk-reklama-kak-rabotaet-konnektor), [Telegram Ads](https://help-ru.romi.center/telegram-ads-kak-rabotaet-konnektor), [TikTok Ads](https://help-ru.romi.center/tiktok-ads-kak-rabotaet-konnektor), [Facebook Ads](https://help-ru.romi.center/facebook-ads-kak-rabotaet-konnektor), [Авито](https://help-ru.romi.center/avito-kak-rabotaet-konnektor)
    *   **Аналитика:** [Яндекс Метрика](https://help-ru.romi.center/yandeks-metrika-kak-rabotaet-konnektor), [Яндекс Метрика Logs API](https://help-ru.romi.center/yandeks-metrika-logs-api-kak-rabotaet-konnektor), [Google Analytics 4](https://help-ru.romi.center/google-analytics-4-kak-rabotaet-konnektor), [Google Search Console](https://help-ru.romi.center/google-search-console-kak-rabotaet-konnektor), [Яндекс Вебмастер](https://help-ru.romi.center/yandeks-vebmaster-kak-rabotaet-konnektor)
    *   **CRM:** [amoCRM](https://help-ru.romi.center/amocrm-kak-rabotaet-konnektor), [Битрикс24](https://help-ru.romi.center/bitrix24-kak-rabotaet-konnektor), [GetCourse](https://help-ru.romi.center/getcourse-kak-rabotaet-konnektor), [EnvyCRM](https://help-ru.romi.center/envycrm-kak-rabotaet-konnektor), [U-ON Travel](https://help-ru.romi.center/u-on-travel-kak-rabotaet-konnektor), [Своя CRM](https://help-ru.romi.center/svoya-crm-kak-rabotaet-konnektor)
    *   **Чат-боты и рассылки:** [Salebot](https://help-ru.romi.center/salebot-kak-rabotaet-konnektor), [Senler](https://help-ru.romi.center/senler-kak-rabotaet-konnektor), [LiveDune](https://help-ru.romi.center/livedune-kak-rabotaet-konnektor)
    *   **Прочее:** [Google Таблицы](https://help-ru.romi.center/google-tablicy-kak-rabotaet-konnektor), [Импорт CSV](https://help-ru.romi.center/import-csv-kak-rabotaet-konnektor)