Перейти к основному содержимому

Все методы

Полный список методов API. Колонка «Способ» показывает, каким запросом метод вызывается: изменяющие методы принимают только POST. Колонка «Право» — какое право ключа нужно, чтобы метод сработал; ключ аккаунта может всё.

Готовые файлы для клиента

Аккаунт

МетодЧто делаетСпособПраво
/account/balance/getБаланс аккаунта (метод первой очереди)GET, POSTaccount:read
/account/getАккаунт, тариф и расходGET, POSTaccount:read
/account/summaryСводка: боты, проекты, цепочки, спискиGET, POSTaccount:read
/log/getЖурнал вызовов APIGET, POSTaccount:read

Подписчики

МетодЧто делаетСпособПраво
/subscriber/getКарточка подписчикаGET, POSTsubscribers:read
/subscriber/findПоиск по имени, нику, коду или заметкеGET, POSTsubscribers:read
/subscriber/listСписок подписчиков с фильтрамиGET, POSTsubscribers:read
/subscriber/tag/listТеги подписчикаGET, POSTsubscribers:read
/subscriber/data/getПеременные подписчика по цепочкамGET, POSTsubscribers:read
/subscriber/chat/getПереписка с подписчикомGET, POSTsubscribers:read
/subscriber/chains/getВ каких цепочках находится подписчикGET, POSTsubscribers:read
/subscriber/createСоздать или обновить подписчикаPOSTsubscribers:write
/subscriber/updateИзменить имя, ник или заметкуPOSTsubscribers:write
/subscriber/tag/addДобавить тегPOSTsubscribers:write
/subscriber/tag/removeСнять тегPOSTsubscribers:write
/subscriber/data/setЗаписать переменные подписчикуPOSTsubscribers:write
/subscriber/blockЗаблокировать подписчикаPOSTsubscribers:write
/subscriber/unblockРазблокировать подписчикаPOSTsubscribers:write
/subscriber/deleteУдалить подписчика из базы (метод первой очереди)POSTsubscribers:write

Отправка и запуск

МетодЧто делаетСпособПраво
/message/sendОтправить сообщение подписчикуPOSTmessages:send
/block/startЗапустить блок у подписчикаPOSTchains:write
/chain/startЗапустить цепочку с первого шагаPOSTchains:write
/chain/stopОстановить цепочку у подписчикаPOSTchains:write
/broadcast/sendРассылка по сегментуPOSTmessages:send
/broadcast/stopОтменить запланированную рассылкуPOSTmessages:send
/message/next/clearОтменить отложенный запуск следующего сообщения (метод первой очереди)POSTchains:write

Списки

МетодЧто делаетСпособПраво
/list/allВсе списки аккаунтаGET, POSTlists:read
/list/rows/getСтроки спискаGET, POSTlists:read
/list/rows/findПоиск строк по колонкамGET, POSTlists:read
/list/createСоздать списокPOSTlists:write
/list/row/addДобавить строкуPOSTlists:write
/list/rows/addДобавить много строкPOSTlists:write
/list/row/editИзменить строкуPOSTlists:write
/list/row/deleteУдалить строку или несколькоPOSTlists:write
/list/clearОчистить списокPOSTlists:write

CRM

МетодЧто делаетСпособПраво
/crm/stage/listЭтапы воронкиGET, POSTcrm:read
/crm/boardДоска: сколько клиентов на этапахGET, POSTcrm:read
/crm/stage/getЭтап и ответственный подписчикаGET, POSTcrm:read
/crm/stage/subscribersПодписчики одного этапаGET, POSTcrm:read
/crm/manager/listСотрудники, получающие заявкиGET, POSTcrm:read
/crm/assignee/listОтветственныеGET, POSTcrm:read
/crm/stage/setПеревести подписчика на этапPOSTcrm:write
/crm/stage/createСоздать этап воронкиPOSTcrm:write
/crm/assignee/setНазначить ответственногоPOSTcrm:write

Платежи

МетодЧто делаетСпособПраво
/payment/system/listПодключённые платёжные системыGET, POSTpayments:read
/payment/statusСтатус платежаGET, POSTpayments:read
/payment/listПлатежи за периодGET, POSTpayments:read
/payment/link/createСоздать ссылку на оплатуPOSTpayments:write

Боты

МетодЧто делаетСпособПраво
/bot/listБоты аккаунтаGET, POSTbots:read
/bot/countКоличество подписчиков бота (метод первой очереди)GET, POSTbots:read
/group/listПроекты (группы ботов)GET, POSTbots:read
/chain/listЦепочки и их кодыGET, POSTbots:read
/chain/stepsШаги цепочки и блоки внутри нихGET, POSTbots:read
/stat/getСтатистика по днямGET, POSTstats:read
/bot/generate/statusХод генерации ботаGET, POSTbots:read
/bot/state/setВключить или выключить ботаPOSTbots:write
/bot/webhook/refreshПереустановить вебхук ботаPOSTbots:write
/bot/generateСобрать бота нейросетьюPOSTbots:write
/bot/exportВыгрузить проекты файломPOSTbots:read
/bot/importЗагрузить проект из выгрузкиPOSTbots:write
/file/uploadЗагрузить файл в аккаунтPOSTfiles:write
/link/createСоздать короткую ссылкуPOSTlinks:write
/link/listКороткие ссылки и переходыGET, POSTlinks:read
/lead/listЗаявки с виджетов и бот-лендинговGET, POSTcrm:read

Календарь

МетодЧто делаетСпособПраво
/webapp/listМини-приложения аккаунтаGET, POSTbots:read
/gcalendar/syncСинхронизация с Google Календарём (метод первой очереди)GET, POSTcalendar:write
/calendar/addДобавить приложение-календарь (метод первой очереди)POSTcalendar:write
/calendar/editИзменить приложение-календарь (метод первой очереди)POSTcalendar:write
/calendar/event/addЗаписать клиента (метод первой очереди)GET, POSTcalendar:write
/calendar/check/busyПроверить занятость времени (метод первой очереди)GET, POSTcalendar:read
/calendar/schedule/getЗаписи календаря (метод первой очереди)GET, POSTcalendar:read
/calendar/schedule/deleteУдалить запись (метод первой очереди)GET, POSTcalendar:write
/webapp/deleteУдалить мини-приложение (метод первой очереди)GET, POSTcalendar:write
/webapp/calendar/schedule/getЗаписи календаря (прежний адрес) (метод первой очереди)GET, POSTcalendar:read
/webapp/calendar/schedule/deleteУдалить запись (прежний адрес) (метод первой очереди)GET, POSTcalendar:write

Ключи и события

МетодЧто делаетСпособПраво
/key/scopesСписок всех правGET, POSTkeys:read
/key/listКлючи аккаунтаGET, POSTkeys:read
/key/createСоздать ключ с правамиPOSTkeys:write
/key/editИзменить ключPOSTkeys:write
/key/revokeОтозвать ключPOSTkeys:write
/hook/eventsСписок событийGET, POSThooks:read
/hook/listПодписки на событияGET, POSThooks:read
/hook/logЖурнал доставокGET, POSThooks:read
/hook/createПодписаться на событияPOSThooks:write
/hook/editИзменить подпискуPOSThooks:write
/hook/deleteУдалить подпискуPOSThooks:write
/hook/testПробная доставкаPOSThooks:write

Каталог товаров

МетодЧто делаетСпособПраво
/catalog/getСсылка на каталог (метод первой очереди)GET, POSTcatalog:read
/catalog/item/createСоздать товар (метод первой очереди)POSTcatalog:write
/catalog/item/editИзменить товар (метод первой очереди)POSTcatalog:write
/catalog/item/deleteУдалить товар (метод первой очереди)POSTcatalog:write
/catalog/item/bulk/createСоздать товары массово (метод первой очереди)POSTcatalog:write
/catalog/item/bulk/editИзменить товары массово (метод первой очереди)POSTcatalog:write
/catalog/item/bulk/deleteУдалить товары массово (метод первой очереди)POSTcatalog:write
/catalog/items/deleteУдалить все товары (метод первой очереди)POSTcatalog:write

Прочее

МетодЧто делаетСпособПраво
/proxyЗапрос через зарубежный сервер (метод первой очереди)GET, POSTproxy:use
/getПроверка ключа (метод первой очереди)GET, POSTaccount:read

Методы первой очереди

Пометка (метод первой очереди) стоит у методов, которые появились раньше остальных: каталог товаров, календарь, прокси, баланс, счётчик подписчиков, удаление подписчика. Они работают как работали, и менять в своих интеграциях ничего не нужно.

Отличий от новых методов два:

  1. Формат ответа об ошибке у них прежний — поле Error без машинного кода. Новые методы отдают ещё и code, см. Ошибки.
  2. Изменяющие методы календаря принимают и GET — так исторически сложилось.

Ключи с правами работают и с ними: право проверяется до вызова.