> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Введение в мониторы
> Автоматическое обнаружение сигналов с обогащением — доставка на ваш вебхук или по email в реальном времени.
## Зачем нужны мониторы?
Традиционные API требуют, чтобы вы строили и поддерживали собственный конвейер сигналов — опрашивали эндпоинты, отслеживали состояние, обрабатывали пагинацию и сшивали несколько вызовов для обогащения. Мониторы заменяют всё это единой конфигурацией.
Сигналы обнаруживаются и доставляются по мере появления — без циклов опроса или cron-заданий.
Сочетайте фильтры сигналов с глобальными фильтрами компаний в одном запросе. «Компании с 500+ сотрудниками, нанимающие на роли в ИИ» — одна конфигурация, а не несколько вызовов API.
Профили компаний и контакты людей обогащаются автоматически при каждом триггере. Отдельные вызовы API не нужны.
Логика повторных попыток, обработка сбоев, дедупликация и отслеживание доставки — всё управляется за вас.
***
## Как работают мониторы
Выберите, какие сигналы отслеживать (вакансии, новости, реклама, экспансии), и задайте фильтры на уровне сигналов. При желании наложите **глобальные фильтры компаний**, чтобы сузить результаты — например, показывать сигналы только от компаний с 500+ сотрудниками в США.
При значении `frequency_minute`, равном `0` (по умолчанию), ваш монитор работает в реальном времени — обнаруживая и доставляя сигналы по мере их появления.
Подходящие сигналы обогащаются полными профилями компаний и, опционально, контактами людей — всё в рамках одного триггера. Дополнительные вызовы не нужны.
Результаты приходят на ваш эндпоинт вебхука или в почтовый ящик. Вы также получаете полную статистику и историю журналов через эндпоинты дашборда.
***
## Режимы обнаружения
Каждый монитор работает в одном из двух режимов обнаружения:
**Сигналы управляют обнаружением.** Вы определяете, какие сигналы искать — система находит подходящие сигналы среди всех компаний, а затем обогащает результаты.
Используйте **глобальные фильтры компаний** (`company_filters`) как второй слой, чтобы сузить, какие компании подходят. Например: «Найти все вакансии в сфере ИИ, но только от компаний с 1 000+ сотрудников».
Лучше всего подходит для:
* Широкого сканирования рынка и обнаружения трендов
* Поиска новых компаний, которые вы никогда раньше не отслеживали
* Масштабного поиска потенциальных клиентов на основе сигналов
```
Фильтры сигналов → Подходящие сигналы → Глобальные фильтры компаний (опционально) → Обогащение → Доставка
```
**Конкретные компании управляют обнаружением.** Вы предоставляете список целевых компаний через `companies`, `domains` или `linkedin_urls`, и система отслеживает их на предмет подходящих сигналов.
**Глобальные фильтры компаний** (`company_filters`) здесь также применяются как второй слой — полезно при сочетании списка наблюдения с более широкими критериями.
Лучше всего подходит для:
* Отслеживания именованных аккаунтов («уведоми меня, когда OpenAI опубликует новые вакансии»)
* Конкурентной разведки по конкретным компаниям
* Конвейеров мониторинга на основе аккаунтов
```
Целевые компании (companies / domains / linkedin_urls) → Фильтры сигналов → Глобальные фильтры компаний (опционально) → Обогащение → Доставка
```
***
## Типы сигналов
Мониторы в настоящее время поддерживают четыре типа сигналов, и регулярно добавляются новые:
Новые вакансии — фильтрация по должности, локации, дате публикации и другим параметрам.
Новости о компаниях — запуски, партнёрства, раунды финансирования, смены руководства и многое другое.
Активные рекламные кампании — фильтрация по целевой локации, диапазону дат и ключевым словам.
Доказательства рыночной экспансии — компания выходит на новый рынок или растёт на нём, с фильтрацией по коридору, стадии и силе сигнала.
### Что говорит каждый сигнал
| Тип сигнала | Что раскрывает | Примеры использования |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Вакансии** | Компания активно нанимает — указывает на рост, новые инициативы или выделение бюджета в конкретных подразделениях. | Всплеск найма инженеров часто сигнализирует о разработке нового продукта. Найм в отдел продаж говорит о расширении выручки. |
| **Новости** | Вехи компании — раунды финансирования, запуски продуктов, партнёрства, смены руководства или трудности. | Объявление о финансировании — идеальный момент для обращения. Смены руководства открывают новые возможности для выхода на новых лиц, принимающих решения. |
| **Реклама** | Где и как компания тратит на маркетинг — раскрывает планы экспансии, целевые рынки и конкурентное позиционирование. | Значительные расходы на рекламу в новой географии сигнализируют о выходе на рынок. Конкуренты, запускающие похожие кампании, указывают на рыночную активность. |
| **Экспансии** | Компания выходит на определённый рынок или масштабируется на нём — подтверждается датированными доказательствами из источника, такими как местный найм, офис или регистрация. | Компания, достигшая стадии `expanding` на вашей территории — своевременное открытие возможности. Сигналы сжатия отмечают аккаунты, работу с которыми стоит приостановить. |
### Периодичность доставки
Вы управляете тем, как часто ваш монитор сканирует новые сигналы, с помощью `frequency_minute`:
| Настройка | Поведение | Лучше всего для |
| ---------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------------- |
| **`0` (по умолчанию)** | **Реальное время** — сигналы обнаруживаются и доставляются по мере появления | Чувствительные ко времени оповещения, конкурентная разведка |
| `15` | Каждые 15 минут | Мониторинг высокого приоритета с предсказуемой доставкой |
| `60` | Ежечасно | Сбалансированная частота для мониторов среднего объёма |
| `1440` | Ежедневно | Дайджест-сводки, отслеживание низкого приоритета |
Библиотека сигналов постоянно расширяется. Новые типы сигналов добавляются по мере появления — на ваши существующие мониторы это не влияет при запуске новых типов.
***
## Глобальные фильтры компаний
Одна из самых мощных возможностей мониторов — способность сочетать фильтры сигналов с **глобальными фильтрами компаний**. Это значит, что вы можете задавать критерии вроде:
* «Компании с **500+ сотрудников**, которые **нанимают на роли в ИИ**»
* «**SaaS-компании из США**, упомянутые в **новостях о запуске продукта**»
* «Компании, использующие **конкретные технологии**, которые запускают **рекламные кампании** в Европе»
Глобальные фильтры компаний (`company_filters`) принимают те же параметры, что и эндпоинт [Company Search](/ru/api-reference/endpoint/companies/search) — локации, размер по числу сотрудников, отрасли, технологии, вертикали и другое.
В режиме `company_first` используйте `companies` (domain\_search\_id), `domains` или `linkedin_urls`, чтобы указать список целевых компаний — требуется только один из них. `company_filters` добавляет дополнительные критерии фильтрации в обоих режимах.
***
## Обогащение людьми
Когда вы включаете обогащение людьми, каждый триггер автоматически находит релевантные контакты в подходящих компаниях. Настройте `people_enrichment_configs` с помощью:
* **Фильтров** — уровни управления, отделы, должности, локации — те же параметры, что и у эндпоинта [People Search](/ru/api-reference/endpoint/people/search)
* **Типов контактов** — `email-work`, `email-personal`, `phone` — соответствуют типам контактов эндпоинта [Redeem](/ru/api-reference/endpoint/redeem/people)
* **Максимума людей для возврата** — от 1 до 25 на слой конфигурации
Вы можете определить **несколько слоёв обогащения**, каждый со своими фильтрами. Например, один слой для руководителей C-уровня, другой — для директоров по инженерии. Каждый слой выполняет независимый поиск людей.
Каждый слой обогащения расходует кредиты поиска людей на триггер, независимо от того, сколько людей возвращено. Планируйте свои слои исходя из конкретных аудиторий, которые вам нужны.
***
## Понимание кредитов
Каждый триггер монитора расходует кредиты в зависимости от того, что он обрабатывает. Обратитесь к странице [Тарифы](/ru/get-started/pricing) за актуальными ставками кредитов.
| Тип кредита | Как расходуется |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Кредит триггера** | 10 кредитов за триггер |
| **Кредит компании** | За каждую обогащённую компанию в результатах |
| **Кредит поиска людей** | За каждый слой обогащения в `people_enrichment_configs` — каждый слой выполняет поиск людей (та же стоимость в кредитах, что и у эндпоинта People Search) |
| **Кредит погашения (redeem)** | За каждого погашенного человека — списывается только при успешном получении, независимо от количества email или телефонов, возвращённых на человека |
### Пример
Монитор, настроенный с `is_company_enrichment: true`, одним слоем обогащения людьми с погашением email, и `max_records_per_trigger: 5` срабатывает и находит 3 компании по 2 человека в каждой:
| Компонент | Расчёт | Кредиты |
| --------------- | -------------------------------------------------------------- | -------------------------------- |
| Триггер | 1 триггер | 10 |
| Компании | 3 обогащённые компании | 3 |
| Поиск людей | 1 слой обогащения | кредиты поиска людей |
| Погашение людей | 6 погашенных людей (3 × 2, списывается за человека при успехе) | 6 × ставка погашения |
| **Итого** | | **13 + поиск людей + погашение** |
Ставки кредитов могут меняться — всегда сверяйтесь со страницей [Тарифы](/ru/get-started/pricing) за актуальной информацией. Включайте обогащение людьми только тогда, когда вам нужны контактные данные.
***
## Типы назначения
Получайте результаты в виде JSON payload на ваш HTTP-эндпоинт. Добавляйте пользовательские заголовки и поля тела для аутентификации. Проверяйте подлинность доставки с помощью подписи монитора.
Это рекомендуемое назначение для разработчиков. См. [Настройка вебхуков](/ru/developer-guides/setting-up-webhooks) для полного руководства.
Получайте оформленные результаты по email. Поддерживает white-label брендинг для агентств и команд.
Интересует доставка email под white-label? [Свяжитесь с нами](https://pubrio.com/ru/get-in-touch), чтобы узнать больше.
Автоматически включайте подходящие контакты в последовательность рассылки. Требует `sequence_identifier` и `record_type` в `destination_config`.
Подробности конфигурации см. в справочнике эндпоинта [Create Monitor](/ru/api-reference/endpoint/monitors/create).
***
## Справочник конфигурации
Все параметры конфигурации имеют разумные значения по умолчанию. В большинстве случаев вам нужно задать только фильтры и назначение — всё остальное опционально.
| Параметр | Диапазон | По умолчанию | Описание |
| ------------------------- | --------- | ------------ | ------------------------------------------------------ |
| `frequency_minute` | 0 - 10080 | 0 | Минуты между сканированиями. **`0` = реальное время.** |
| `max_records_per_trigger` | 1 - 100 | 25 | Максимум записей, доставляемых за триггер. |
| `max_daily_trigger` | 0 - 86400 | 500 | Дневной лимит триггеров. `0` = без ограничений. |
| `max_retry_per_trigger` | 0 - 3 | 1 | Попытки повтора при сбое доставки. |
| `retry_delay_second` | 1 - 5 | 1 | Секунды между попытками повтора. |
| `max_failure_trigger` | 1 - 10 | 5 | Последовательных сбоев до автопаузы. |
***
## Справочник фильтров
Фильтры сигналов и компаний используют те же схемы, что и поисковые эндпоинты:
Те же фильтры, что и у Job Search — должности, локации, даты публикации и другое.
Те же фильтры, что и у News Search — категории, галереи, ключевые слова и даты.
Те же фильтры, что и у Advertisements Search — целевые локации, диапазоны дат и ключевые слова.
Те же фильтры, что и у Company Search — локации, размер, отрасли, технологии, вертикали и другое.
Те же фильтры, что и у Expansion Search — `froms` / `tos`, стадии, области охвата, momentum, свежесть и типы сигналов.
Фильтры обогащения людьми (уровни управления, отделы, должности) следуют той же структуре, что и эндпоинт [People Search](/ru/api-reference/endpoint/people/search).
***
## Дальнейшие шаги
Подключите свои системы для получения данных в реальном времени.
Частота, надёжность доставки и обработка сбоев.
Полные пошаговые инструкции company\_first и signal\_first с кодом, готовым к копированию.
Перейти к справочнику эндпоинта Create Monitor.