Забирать данные опросом: Google Таблицы, API, CSV

Третий канал источника: платформа сама по расписанию забирает JSON или CSV с адреса и складывает строки событиями источника. Раздел «Опрос по адресу» — в карточке источника на вкладке «Источники».

Какие адреса годятся

• Лист Google Таблиц. В таблице: «Файл → Поделиться → Опубликовать в интернете», выберите лист и формат CSV, скопируйте ссылку. Каждая строка листа — событие, шапка — имена полей. Подходит и ссылка на экспорт …/spreadsheets/d/<id>/export?format=csv, если таблица открыта «всем, у кого есть ссылка». Опубликованная копия отстаёт от правок примерно на полминуты — для опроса по расписанию это не важно.
• API с токеном. Адрес и заголовок авторизации, например Authorization и Bearer …. Имя и значение заголовка — латиница, цифры и знаки: кириллицу HTTP-заголовок не несёт, и кабинет откажет словами ещё при «Проверить». Значение заголовка хранится и показывается маской; пустое поле при сохранении оставляет прежнее. Если массив лежит внутри ответа ({"data": {"items": [...]}}), укажите путь к нему: data.items.
• Выгрузка CRM или любой публичный CSV по ссылке.

Как настроить

1. Раскройте «Опрос по адресу» и впишите адрес (и заголовок, если нужен).
2. Нажмите «Проверить» — кабинет сходит по адресу сейчас и скажет, сколько строк и какие столбцы получились бы. Ничего не сохраняется.
3. Выберите, как часто опрашивать: каждые 15 минут, раз в час, раз в 6 часов или раз в сутки.
4. Нажмите «Сохранить опрос». Первый запуск — по расписанию или кнопкой «Запустить сейчас»: ручной запуск сдвигает расписание от этого момента, плановый следом не бежит.

Что стоит знать

• Строки, которые уже есть в источнике, на следующем опросе пропускаются («уже были»). Изменившаяся строка — новое событие. Строка, удалённая из листа, из кабинета не исчезает: событие — факт.
• Первый запуск считается историей — вебхуки по нему не идут. Со второго запуска новые строки уходят вебхукам как живые обращения.
• Ошибка (адрес не отвечает, токен не принят, JSON не разобрался) — причина словами — в журнале запусков под формой; следующий запуск — по расписанию, опрос сам не выключается. После пяти отказов подряд в строке источника загорается «опрос не работает» — загляните в журнал.
• Адрес — только публичный http(s), ответ — до 10 МБ, у кабинета идёт один опрос в момент времени.
• «Выключить» останавливает опрос, настройки и журнал остаются. «Удалить опрос» снимает настройки и журнал; полученные события остаются.