Senler Docs
senler.ru
  • Документация
  • Начало работы
    • О сервисе
    • Терминология
    • Регистрация
  • Проект
    • О проектах
    • Тарифы
    • Уведомления
  • Каналы
    • ВКонтакте
      • Подключение
      • Настройка сообщества
      • Получение шаблонов ботов и подписной страницы
      • Подписчики
        • Способы сбора базы подписчиков
        • Статусы
        • Действия с подписчиками
        • Импорт подписчиков
        • Экспорт подписчиков
        • Черный список
        • Способы отписаться
        • Обновление данных
        • Источники подписки
      • Группы подписчиков
        • Создание группы подписчиков
        • Настройки группы
        • Автоматическая подписка при переходе
        • Страница после подписки
        • Рекомендации для баннеров
        • Платная подписка
        • Автоисключение
        • Удаление группы
      • Рассылки
        • Создание рассылки
        • Разовая рассылка
        • Целевая рассылка
        • Статусы рассылок
        • Вложения
        • Шаблоны
        • Статистика рассылок
        • Открываемость
        • Ускоренная рассылка
        • Удаление
      • Чат-боты
        • Создание чат-бота
        • Блок - сообщение
        • Блок - таймер
        • Блок - действие
        • Блок - условие
        • Блок - группа условий
        • Клавиатура
        • Карусель
        • Переменные в ботах
        • Ответ на сообщение
        • Реакции на сообщение
        • Прочтение сообщения
        • Переход по ссылке
        • Настройки
        • Зацикливание
        • Запуск чат-бота
        • Активация новых связей
        • Тестирование
        • Публикация изменений
        • Статистика
        • Копирование
        • Удаление
      • Форматирование
      • Процессы
      • Триггеры
      • Метки
      • Переменные
        • Стандартные переменные
        • Глобальные переменные
        • Пользовательские переменные
      • Аналитика
        • Логирование действий в сообществе
        • Статистика
          • Воронки
        • Ретаргетинг ВКонтакте
        • Пиксель ВКонтакте
        • Яндекс Метрика
        • Google Analytics
        • Пиксель Facebook
        • Google Tag Manager
        • UTM-метки
        • UTM-генератор
        • REF-метки
        • Сквозная аналитика
      • Заказы
      • Интеграции
        • Интеграция с Prodamus
        • Интеграция с Robokassa
        • Интеграция с ApiX-Drive
        • Интеграция с Unitpay
        • Интеграция с VK Pay
        • Интеграция с ЮMoney
        • Интеграция с Пиксель ВКонтакте
        • Интеграция с Яндекс Метрика
        • Интеграция с Google Analytics
        • Интеграция с Facebook Pixel
        • Интеграция с Google Tag Manager
        • Интеграция с Google Sheets
        • Интеграция Уведомления в Telegram
        • Интеграция с ChatGPT (OpenAI)
    • Telegram
      • Подключение
      • Подписчики
        • Способы сбора базы подписчиков
        • Статусы
        • Действия с подписчиками
        • Импорт подписчиков
        • Экспорт подписчиков
        • Черный список
      • Группы подписчиков
        • Создание и настройки
        • Удаление
      • Рассылки
        • Создание рассылки
        • Разовая рассылка
        • Целевая рассылка
        • Статусы рассылок
        • Вложения
        • Шаблоны
        • Статистика рассылок
        • Удаление
      • Чат-боты
        • Создание чат-бота
        • Блок - сообщение
        • Блок - таймер
        • Блок - действие
        • Блок - группа условий
        • Клавиатура
        • Переменные в ботах
        • Ответ на сообщение
        • Реакции на сообщение
        • Переход по ссылке
        • Настройки
        • Зацикливание
        • Запуск чат-бота
        • Активация новых связей
        • Тестирование
        • Публикация изменений
        • Статистика
        • Копирование
        • Удаление
      • Форматирование
      • Процессы
      • Триггеры
      • Метки
      • Переменные
        • Стандартные переменные
        • Глобальные переменные
        • Пользовательские переменные
      • Аналитика
        • UTM-генератор
      • Интеграции
        • Интеграция Уведомления в Telegram
      • Проксирование
        • Серверы
  • Сервис
    • Мини-приложение ВКонтакте
      • Установка приложения
      • Главная страница
      • Подписные страницы
      • Мои подписки
      • Настройки
        • Вид главной страницы
        • Метрики
      • Виджеты
        • Создание виджета
        • Типы виджетов
        • Изображения
        • Аудитории
        • Массовые действия
        • Видимость
        • Публикация
        • Кеширование
      • Лендинги
        • Создание лендинга
        • Блоки
        • Текстовый редактор
        • Публикация изменений
        • Заявка с номером телефона
    • Партнерская программа
    • Отчёты
    • Корпоративным клиентам
    • Короткие ссылки
  • Помощь
    • Правила
      • Правила VK
    • FAQ
      • Общие вопросы
        • Как запретить сообщения от сообщества ВКонтакте?
        • Как разрешить сообщения от сообщества ВКонтакте?
        • Как отписаться от рассылок ВКонтакте?
        • Как получить идентификатор аудиозаписи?
        • Как получить идентификатор голосового сообщения?
        • Как получить ссылку на опрос?
        • Как получить идентификатор ответа в опросе?
        • Настройка сниппета
        • Не открывается ссылка на пост
        • Пишут слово Начать
        • Как получить токен в Telegram
        • Регулярные выражения
        • Удаление сообщений
        • Что такое мультиссылка?
        • Что такое теги?
        • Как узнать свой идентификатор в Telegram?
      • Вопросы о сообществах
        • Как подключить сообщество в Senler?
        • Кто подключил сообщество в Senler?
        • Как перенести сообщество?
        • Как отключить сообщество в Senler?
        • Удаление ключей API в сообществе ВКонтакте
      • Вопросы о рассылках
        • Не отправляются сообщения
        • Может массовая рассылка привести к блокировке сообщества?
      • Вопросы о подписчиках
        • Не добавляются подписчики
        • Не работает триггер
        • Почему важно хранить неактивных подписчиков?
      • Вопросы о чат-ботах
        • Бот не отвечает
        • Не отправляется определенный шаг
        • Не работает условие Ответ на сообщение
        • Изменение бота
        • Не открывается редактирование шага
      • Вопросы о сотрудниках
      • Вопросы о мини-приложении ВКонтакте
        • Почему показывается инструкция?
        • Почему не открывается приложение?
        • Как удалить приложение ВКонтакте?
        • Как вставить видео?
    • Ошибки
      • Ошибки VK
        • VK Oauth: Security Error
        • Only group admins have access to group tokens
        • Group is not allowed to send messages
        • Invalid request: modifying contacts in a shared group is not allowed
        • Error 1 - Unknown error occured
        • Error 5 - User authorization failed: invalid session
        • Error 10 - Internal server error
        • Error 15 - Access denied: group messages are disabled
        • Error 15 Access denied: share post forbidden
        • Error 15 - Access denied: no access to call this method
        • Error 15 - Access denied: at first group admin should install app widget in group
        • Error 15 - Access denied: no access to call this method. It cannot be called with current scopes
        • Error 27 - Group authorization failed: group revoke access for this token
        • Error 27 - Group authorization failed: group is banned
        • Error 100 - One of the parameters specified was missing or invalid: message is empty or invalid
        • Error 100 - One of the parameters specified was missing or invalid: file is undefined
        • Error 121 - Invalid hash
        • Error 129 - Invalid photo
        • Error 600 - Permission denied. You have no access to operations specified with given object(s)
        • Error 901 - Cant send messages for users without permission
        • Error 902 - Can't send messages to this user due to their privacy settings
        • Error 912 - This is a chat bot feature, change this status in settings
        • Error 914 - Message is too long
        • Error 936 - Contact not found
        • Error 2000 - Servers number limit is reached
        • Другие ошибки
      • Сетевые ошибки
        • Сайт отправил недействительный ответ или ERR_SSL_PROTOCOL_ERROR
        • Ошибка ERR_BLOCKED_BY_RESPONSE
        • Ошибка SSL_ERROR_ACCESS_DENIED_ALERT
        • Ошибка ERR_CONNECTION_REFUSED
        • Ошибка ERR_SSL_VERSION_INTERFERENCE
    • Обучающие материалы
    • Разработчикам
      • API
        • Версии API
        • Ключи доступа
        • Формирование подписи
        • Методы
          • Subscribers
            • add
            • del
            • get
            • statSubscribe
            • statCount
          • Subscriptions
            • get
            • add
            • edit
            • del
          • Utms
            • add
            • edit
            • del
            • get
            • getLink
            • statCount
            • statSubscribe
          • Deliveries
            • get
            • stat
            • statCount
          • Bots
            • get
            • getSteps
            • addSubscriber
            • delSubscriber
          • Vars
            • set
            • get
            • del
          • Vars_global
            • get
            • set
            • del
        • Возвращаемые ошибки
      • WebHook API
        • Серверы
        • Шаблоны
        • Обработка ответа запроса
      • Кнопка для сайта
      • Приложения
        • Создание приложения
        • Настройки
        • Руководство
        • Варианты интеграций
          • Шаг в чат-боте
          • Встроенная страница приложения
          • OAuth
        • Интеграции
          • Пользовательский интерфейс
          • Сохранение настроек
          • Чтение настроек
          • Вебхук
          • Публикация
          • Дополнительно
            • dev ссылка iframe
          • Пример #1. react ui
            • front dev
            • front prod
            • backend
          • Библиотеки
    • Техподдержка
Powered by GitBook
On this page
  1. Помощь
  2. Разработчикам
  3. API
  4. Методы
  5. Subscribers

get

subscribers/get

Получение подписчиков.

Необязательные параметры:

Параметр

Описание

count (int)

количество элементов, информацию о которых нужно вернуть

максимум: 100 пример: 50

offset_id (string)

смещение, которое необходимо передавать для выборки следующего множества (берется из ответа) пример: 5c6992770b295058e641bb86

vk_user_id или tg_user_id (array)

идентификаторы пользователей ВКонтакте или Telegram соответственно пример: [1,2]

subscription_id (array)

идентификаторы групп подписчиков (0 - без группы) пример: [0,123]

ignore_subscription_id (array)

идентификаторы групп, подписчиков которых нужно исключить из выборки (0 - без группы) пример: [0,123]

delivery_id (array)

идентификаторы рассылок которые получили подписчики пример: [123]

ignore_delivery_id (array)

идентификаторы рассылок которые не получили подписчики пример: [123]

error_delivery_id (array)

идентификаторы рассылок, при отправке которых пользователю произошла ошибка при доставке пример: [123]

read_delivery_id (array)

идентификаторы рассылок, которые прочитали пользователи пример: [123]

ignore_read_delivery_id (array)

идентификаторы рассылок, которые не прочитали пользователи пример: [123]

away_delivery_id (array)

идентификаторы рассылок, в которых пользователи перешли по ссылкам пример: [123]

ignore_away_delivery_id (array)

идентификаторы рассылок, в которых пользователи не перешли по ссылкам пример: [123]

utm_id (array)

идентификаторы меток Senler пример: [0,123]

source (array)

источник подписки

  • 'subscriptions' - Список групп в приложении

  • 'subscription' - Прямая ссылка на группу подписчиков

  • 'widget' - Виджет в сообществе

  • 'keyword' - Ключевое слово

  • 'api' - API

  • 'site' - Сайт

  • 'hand' - Вручную

  • 'other' - Другое пример: ['subscription']

utm_source (array)

источник кампании пример: ['vk']

utm_medium (array)

тип трафика пример: ['cpc']

utm_campaign (array)

название кампании пример: ['skidka_po_karte']

utm_content (array)

идентификатор объявления пример: ['banner']

utm_term (array)

ключевое слово пример: ['заказать стул онлайн']

date_subscription_from (string)

дата и время, с которой подписались на группу подписчиков формат: d.m.Y H:i:s пример: 26.11.2018 10:00:00

date_subscription_to (string)

дата и время, до которой подписались на группу подписчиков формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

date_first_from (string)

дата и время, с которой произошла первая подписка формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

date_first_to (string)

дата и время, до которой произошла первая подписка формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

date_delivery_from (string)

дата и время, с которой получена рассылка формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

date_delivery_to (string)

дата и время, до которой получена рассылка формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

date_first_delivery_from (string)

дата и время, с которой была получена первая рассылка формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

date_first_delivery_to (string)

дата и время, до которой была получена первая рассылка формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

date_last_delivery_from (string)

дата и время, с которой была получена последняя рассылка формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

date_last_delivery_to (string)

дата и время, до которой была получена последняя рассылка формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

date_away_from (string)

дата и время, с которой был переход по ссылка в рассылке формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

date_away_to (string)

дата и время, до которой был переход по ссылка в рассылке формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

bot_id (int)

идентификатор бота в котором состоят подписчики пример: 1

step_id (array)

идентификаторы шагов в боте, который передан в параметре bot_id пример: ['5c6992770b295058e641bb86']

ignore_bot_id (int)

идентификатор бота, участников которого нужно исключить из выборки пример: 1

ignore_step_id (array)

идентификаторы шагов в боте, участников которого нужно исключить из выборки. Принимаются шаги бота, который передан в параметре bot_id пример: ['5c6992770b295058e641bb86']

lead_status (int)

фильтрация подписчиков по статусу. Принимает значения 1 или 2, где 1 - Активный, а 2 - Неактивный.

var_name (string)

имя переменной.

Пример: 'age'

var_value (string)

значение переменной.

Пример: '30'

Ответ:

Параметр

Описание

success (bool)

true операция прошла успешно

false при возникновении ошибки

offset_id (string)

смещение, которое необходимо передавать для выборки следующего множества пример: 5c6992770b295058e641bb86

items (array)

Структура элемента массива с подписчиками (items):

Параметры

Описание

date (string)

дата первой подписки формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

vk_user_id или tg_user_id (int)

идентификатор подписчика ВКонтакте или Telegram соответственно пример: 1

ignore (int)

если пользователь в черном списке - значение "1", иначе "0" пример: 0

first_name (string)

имя подписчика пример: Иван

last_name (string)

фамилия подписчика пример: Иванов

photo (string)

subscriptions (array)

utms (array)

vars (array)

переменные и их значения. Пример:

Структура элемента массива с подписками на группу (subscriptions):

Параметры

Описание

date (string)

Дата подписки формат: d.m.Y H:i:s пример: 27.11.2018 10:00:00

subscription_id (int)

Идентификатор группы подписчиков пример: 123

source (string)

Источник подписки

  • subscriptions Список групп в приложении

  • subscription Прямая ссылка на группу подписчиков

  • widget Виджет в сообществе

  • keyword Ключевое слово

  • api API

  • site Сайт

  • hand Вручную

  • other Другое

Структура элемента массива метками (utms):

Параметр

Описание

utm_id (int)

идентификатор меток Senler пример: 123

utm_source (string)

источник кампании пример: vk

utm_medium (string)

тип трафика пример: cpc

utm_campaign (string)

название кампании пример: skidka_po_karte

utm_content (string)

идентификатор объявления пример: banner

utm_term (string)

ключевое слово пример: заказать стул онлайн

PreviousdelNextstatSubscribe

Last updated 3 days ago

ссылка на изображение подписчика пример:

[
    {
        "n": "rew",
        "v": 123
    },
    {
        "n": "rew2",
        "v": 456
    }
]
https://sun6-6.userapi.com
список подписчиков
список подписок на группы
список меток Senler и utm-меток