Методы и права

Все методы API и права ключа. Параметры каждого метода, суточные лимиты и примеры ответа — во вкладке «Документация» раздела API.

Методы

Все методы требуют право «Аккаунты: действия» и выполняются от имени указанного аккаунта.

Метод	Что делает
Найти и проверить
`search_entities`	Глобальный поиск людей, чатов и каналов по запросу
`resolve_username`	Полный профиль по публичному @нику
`get_entity_data`	Свежий полный профиль известного человека или чата
`get_personal_channel_data`	Полная проверка канала: профиль, закреп и последние посты
`resolve_post_author`	Профиль автора поста в канале
Собрать
`fetch_members_page`	Страница участников публичного чата или канала
`fetch_messages_page`	Страница сообщений публичного чата или канала
Переписка
`list_dialogs`	Список диалогов аккаунта
`start_dialog`	Первое сообщение человеку — открывает диалог
`send_reply`	Сообщение в уже открытый диалог
Профиль аккаунта
`set_name`	Сменить имя и фамилию аккаунта
`set_bio`	Сменить «О себе»

Права ключа

Код	Право	Что даёт
`campaigns:read`	Кампании: чтение	Просмотр кампаний, их диалогов и отчётов по аудитории
`campaigns:write`	Кампании: запись	Создание и изменение кампаний, запуск и остановка
`flows:read`	Сценарии: чтение	Просмотр скриптов и их шагов
`flows:write`	Сценарии: запись	Создание и изменение скриптов
`audience:read`	Аудитории: чтение	Просмотр списков, контактов и переменных
`audience:write`	Аудитории: запись	Создание и изменение списков, импорт контактов, запуск задач
`accounts:read`	Аккаунты: чтение	Просмотр аккаунтов и их состояния
`accounts:actions`	Аккаунты: действия	Вызов методов API от имени аккаунта
`wallet:read`	Кошелёк: чтение	Баланс, токены и история операций

Лимиты

Что	Сколько
Запросов	60 в минуту
Действующих ключей	15
Ожидание результата в одном запросе (`wait`)	До 30 секунд
Хранение результата задачи	7 дней
Суточные лимиты методов	На каждый аккаунт, свои у каждого метода — во вкладке «Документация»

Читать дальше