Callback API для разработчиков
Что это такое?
Если вы хоть немного разбираетесь в программировании, вы скорее всего уже знаете ответ. Яркий пример такого API — Callback API VK для сообществ. Если же это вам ничего не говорит, вам следует закрыть статью — она не для вас.
Как начать использовать Callback API Чат-менеджера?
Для начала нужно зайти на сайт менеджера и там авторизоваться через ВК.
После этого нужно сделать запрос на API менеджера — https://api.chatmanager.pro. Чтобы получить данные для дальнейшей авторизации, используется метод account.getToken. Итак, переходим по ссылке.
Поле «token» и есть токен доступа к API Чат-менеджера, который вы будете использовать в дальнейшем.
Установка Вебхука для Callback API
Вам понадобится собственный веб-сервер, способный обрабатывать HTTP запросы. Вот инструкция-пример по установке хука, работающего на PHP.
Для начала нам нужно создать скрипт, который будет обрабатывать запросы от Callback сервера. Пример на PHP можно найти по этой ссылке.
Теперь пройдемся по настройкам, которые там используются.
После установки всех этих параметров сделаем запрос на API Чат-менеджера для установки вебхука.
Метод — account.setWebHook, параметры — ваш token менеджера и url вебхука. В нашем случае это будет:
https://api.chatmanager.pro/?method=account.setWebHook&token=cc3a…b21&url=https://chatmanager.pro/webhook.php
Отлично, это основные настройки именно скрипта. Осталось настроить список бесед — скрипт должен знать, в какую беседу будет пытаться возвращать пользователя. Callback-запрос с информацией об окончании бана выглядит так:
Видно, что id пользователя передается в прямом виде, а вот чат — в виде его UID (!справка). Для всех бесед, в которых мы будем использовать скрипт, мы должны записать в массив $chats его id на нашей странице.
Итак, на моей странице UID чата «aeCa» соответствует моему локальному id чата 191. В примере кода на PHP это уже внесено в список, а вы замените данные на свои.
В общем, все готово — теперь после окончания банов в беседе менеджер будет делать запрос на ваш Callback URL с информацией о событии, а скрипт эти данные обработает и добавит участника обратно (если он есть в друзьях вашей страницы).
Конечно же, вы можете редактировать код на свое усмотрение, текущий здесь только для примера.
Callback api что это
Когда в сообществе произойдет событие выбранного типа, ВКонтакте отправит на Ваш сервер запрос с данными в формате JSON с основной информацией об объекте, вызвавшем событие (например, добавленный комментарий).
В ответ на каждое уведомление о событии Ваш сервер должен отправить строку «ok».
Вам больше не нужно регулярно повторять запросы к API, чтобы отслеживать обновления — теперь Вы будете получать их мгновенно.
Для подключения Callback API нужно открыть раздел «Управление сообществом» («Управление страницей», если у Вас публичная страница), перейти во вкладку «Работа с API».
Далее необходимо указать и подтвердить конечный адрес сервера, куда будут направлены все запросы. Вы можете подключить до 10 серверов для Callback API, задать каждому из них отдельный набор событий и версию API.
После указания адреса сервера и нажатия на кнопку «подтвердить» на указанный Вами адрес отправится запрос с уведомлением типа «confirmation». Ваш сервер должен вернуть заданную строку.
Обратите внимание: строка подтверждения меняется время от времени. Если Вы добавляете новый сервер или редактируете настройки старого, то необходимо указать новую строку подтверждения. Получить строку подтверждения можно с помощью метода groups.getCallbackConfirmationCode. Также ее можно посмотреть в управлении сообществом.
Строку подтверждения, которую возвращает метод, можно использовать только для настройки сервера с помощью API. В настройках Вашего сообщества на сайте ВКонтакте код будет отличаться.
После подтверждения адреса сервера Вам станут доступны настройки уведомлений.
Во вкладке «Запросы» Вы сможете видеть историю событий и содержимое запросов, отправленных на Ваш сервер.
Обратите внимание: после получения уведомления Ваш сервер должен возвращать строку «ok» и статус HTTP 200. Если сервер несколько раз подряд вернет ошибку, Callback API временно перестанет отправлять на него уведомления.
Добавлять, удалять и редактировать сервера для Callback API Вы также можете с помощью методов секции groups.
Для удаления сервера Вы можете отправить remove в ответ на уведомление о любом событии.
В зависимости от указанной версии объекты в событиях будут иметь разный формат. Ознакомиться с отличиями версий можно на этой странице.
В поле «Секретный ключ» Вы можете указать произвольную строку, которая будет передаваться в уведомлении на Ваш сервер в поле secret.
Чтобы гарантировать безопасность передачи данных, мы рекомендуем загрузить SSL-сертификат в настройках Callback API Вашего сообщества.
Подробная информация о сертификате доступна на этой странице.
Обратите внимание!
Фактическое время переотправки уведомления о событии может оказаться больше указанного.
Callback API ВКонтакте
Callback API ВКонтакте — это инструмент для отслеживания активности пользователей в Вашем сообществе ВКонтакте. С его помощью Вы можете реализовать, например:
Чтобы начать использовать Callback API ВКонтакте, подключите свой сервер в настройках сообщества («Управление сообществом» → «Настройки» → «Работа с API»). Выберите типы событий, данные о которых требуется получать, например, новые комментарии и новые фотографии.
Когда в сообществе произойдет событие выбранного типа, ВКонтакте отправит на Ваш сервер запрос с данными в формате JSON с основной информацией об объекте, вызвавшем событие (например, добавленный комментарий).
В ответ на каждое уведомление о событии Ваш сервер должен отправить строку «ok».
Вам больше не нужно регулярно повторять запросы к API, чтобы отслеживать обновления ВКонтакте — теперь Вы будете получать их мгновенно.
1. Подключение Callback API ВКонтакте
Для подключения Callback API ВКонтакте нужно открыть раздел «Управление сообществом» («Управление страницей», если у Вас публичная страница), перейти во вкладку «Работа с API».
Далее необходимо указать и подтвердить конечный адрес сервера, куда будут направлены все запросы. Вы можете подключить до 10 серверов для Callback API ВКонтакте, задать каждому из них отдельный набор событий и версию API.
После указания адреса сервера и нажатия на кнопку «подтвердить» на указанный Вами адрес отправится запрос с уведомлением типа «confirmation». Ваш сервер должен вернуть заданную строку.
После подтверждения адреса сервера Вам станут доступны настройки уведомлений.
Во вкладке «Запросы» Вы сможете видеть историю событий и содержимое запросов, отправленных на Ваш сервер.
Добавлять, удалять и редактировать сервера для Callback API Вы также можете с помощью методов секции groups.
1.1. Версия API ВКонтакте
В зависимости от указанной версии объекты в событиях будут иметь разный формат. Ознакомиться с отличиями версий можно на этой странице.
1.2. Секретный ключ API ВКонтакте
В поле «Секретный ключ» Вы можете указать произвольную строку, которая будет передаваться в уведомлении на Ваш сервер в поле secret.
1.3. SSL-сертификат
Чтобы гарантировать безопасность передачи данных, рекомендуется загрузить SSL-сертификат в настройках Callback API Вашего сообщества ВКонтакте.
Подробная информация о сертификате доступна на этой странице.
1.4. Настройка через API ВКонтакте
Вы можете управлять настройками Callback API ВКонтакте в Вашем сообществе не только в веб-интерфейсе, но и с помощью методов API:
2. Формат данных API ВКонтакте
Когда происходит событие, Вы получаете данные в JSON, имеющем следующую структуру:
2.1. Типы событий API ВКонтакте
Структура объекта в поле object зависит от типа уведомления. Полный список событий Вы найдёте на этой странице.
3. Пример использования API ВКонтакте
В примере ниже скрипт на PHP обрабатывает уведомления о новом сообщении и отправляет ответ его автору от имени сообщества.
4. Поддержка в SDK ВКонтакте
Вы можете работать с Callback API средствами SDK:
Callback API bot Вконтакте — как подключить и настроить?
Опытные SMM-менеджеры и предприниматели серьёзно относятся к ведению личных страниц бренда в социальных сетях. Они знают, что вместе с ростом сообщества растёт и количество задач, которые в нем нужно выполнить.
Каждый день необходимо генерировать контент, отслеживать комментарии под постами, фотографиями, видео, общаться с клиентами. И постоянно мониторить, не появились ли новые сообщения и комментарии от пользователей.
Но процесс отслеживания новых действий пользователей в сообществе Вконтакте легко автоматизировать! Для этого можно использовать бесплатного бота. О том, как его подключить и настроить — в этой статье.
Что такое callback api bot вк?
Это бесплатный бот, который позволяет отслеживать все новые события, происходящие в сообществе с помощью инструмента отслеживания активности пользователей — callback api вконтакте. Для этого необходимо подключить бота к своему сообществу и выбрать категории для отслеживания. Теперь вы получаете личные сообщения о происходящих изменениях:
Как подключить callback api бот Вконтакте?
Подключение бота потребует выполнения нескольких очень простых действий:
Как настроить callback api бот Вк
Настроить бот — не сложнее чем подключить. Но, для начала, нужно разобраться поподробнее с его возможностями.
Обзор функционала callback api бот Вк
Как мы уже говорили, бот позволяет отслеживать изменения, происходящие в сообществе. О каких именно изменениях идет речь?
Пошаговая настройка Callback API бот Вк
После того, как мы подключили бот к сообществу, нужно выбрать типы событий, уведомления о которых вы хотите получать.
Предположим, что мы самостоятельно ведем сообщество Вконтакте и бот нужен нам для мониторинга комментариев и действий пользователей. Исходя из этих данных, выставим следующие настройки:
1 часть 
2 часть 
3 часть
После этого, изменения сохранятся автоматически.
Для того, чтобы настроить работу сервера, достаточно просто вставить в настройки адрес из сообщения:
Нажимаем “Подтвердить” и, тем самым, завершаем основные настройки.
Вы должны получить сообщение о том, что настройка прошла успешно.
В качестве дополнительной настройки, бот предлагает защитить информацию от посторонних секретным ключом — мы советуем не игнорировать этот шаг. Итак:
В Настройках сервера ищем окно для ввода секретного кода, придумываем код (или генерируем его автоматически) и нажимаем сохранить — секретный ключ успешно сохранён. 
Настройка бота завершена.
Проверка работоспособности бота
После подключения и успешной настройки, нам нужно проверить работоспособность бота.
Зайдем с другого аккаунта и выполним следующие действия: выйдем из группы, вступим в группу, напишем комментарий к записи на стене.
После каждого из действий, в личные сообщения пришли вот такие оповещения.
Это значит, что бот настроен корректно и уже работает.
Для кого нужен callback api бот вк и чем он полезен
Мы добрались до финальной части нашего обзора — выводов о том, кто же может использовать бот и зачем?
Во-первых, этот бот полезен всем, кто хочет мониторить комментарии в своих сообществах, чтобы не пропускать обращения клиентов и важные вопросы. Это поможет оперативно реагировать на них.
Во-вторых, могут использовать этот инструмент и те, кто не занимается ведением страницы сам, а нанимает для этого контент-менеджера. Вы в любой момент сможете увидеть, как справляются со своими задачами ваши сотрудники, какие они совершают ошибки и как их исправляют.
Нельзя обойти вниманием тех, кто хочет использовать бота для повышения качества клиентского сервиса. Вы всегда сможете увидеть новых участников вашей группы и моментально поблагодарить их за вступление, проконтролировать закрытие возражений и решение конфликтных ситуаций вашими контент-менеджерами.
Благодаря оперативным ответам, вы не будете терять “теплых” лидов, которые задают вам вопросы о доставке, цене, заказе товара, который вы продаете.
Моментальные сообщения позволяют быстро реагировать на спам и моментально от него избавляться.
Будьте мобильными и оперативными, повышайте качество клиентского сервиса и получайте такие же быстрые результаты, как ваши ответы на вопросы с помощью сервиса CallBack API бот Вконтакте!
Callback API
Концепция
Ни для кого не должно быть секретом, что группы сейчас просто не могут удалять, закреплять сообщения или приглашать участников в беседы. Но зато могут участники.
Конечно, можно было бы просто передать Admin Bot в ЛС свой логин и пароль, и он бы творил всю магию за вас. Однако это запрещено правилами ВКонтакте, и поэтому приходится применять альтернативные средства.
Одним из таких средств называется «Callback». В чём суть? Admin Bot будет посылать определённые запросы на ваш собственный сайт, и на нём уже с вашей страницы ВК будет проводиться магия. Я нарисовал в фотошопе довольно понятную иллюстрацию.
Однако как понять, что именно Admin Bot присылает запросы на ваш сервер, а не кто-то другой? Бот для этого будет использовать подпись, так называемый «секретный ключ», который вы ему установите сами. И ваш сайт должен размышлять таким образом: «если это верный секретный ключ, то я обработаю этот запрос. Иначе — посылаю куда подальше». Само собой разумеется, что вы никому этот ключ передавать не должны.
Хорошо, ещё один вопрос. Для доступа к VK, нужно ведь указывать свои данные? Верно, без этого никак. Это просто необходимо.
Всё ведь понятно? Приступаем к реализации!
Реализация
В данной статье я не буду приводить структуры запросов, ведь предполагается, что вы самые обычные люди, а не сверхразумы-программисты. Однако всё-таки пошевелить мозгами в непривычной обстановке придётся. При желании вы сами можете выстроить всю структуру запроса.
Итак, что нам нужно? Во-первых, нам нужен сайт. Неужели нужно расчехлять кошелёк? Ну это если вы хотите. А в данной статье я воспользуюсь бесплатным сервисом PythonAnywhere.
Заходим на сайт, нажимаем в верхнем правом углу Log in, нажимаем под полем ввода логина на «Sign up here!» → «Create a Beginner account», подтверждаем Email-адрес. Видим перед собой:
Нас интересует раздел Web в верхнем правом углу. Заходим туда. Нажимаем на «Add a new web app» → «Next» → в списке выбираем Flask, Python 3.7 → «Next». Результат должен выглядеть так:
Теперь из раздела Web переходим в Files. Слева находим папку «mysite/», кликаем на «flask_app.py».
Перед собой мы видим кучу заумного хлама. Но уж потерпите.
Теперь подкорректируем кое-что прямо под нас. Нас интересуют строки:
В поле SECRET_KEY мы записываем секретный ключ, с которым будем работать. А в поле VK_TOKEN мы записываем наш токен от страницы ВК.
Если с секретным ключом всё понятно, то с токеном не совсем. Как его получить?
Для это кликаем по ссылке — *клик*, нажимаем «Разрешить», и нас перекинет на какую-то страницу, где написано, чтобы мы никому не передавали данные из адресной строки. И действительно, НИКОМУ НЕ ПЕРЕДАВАЙТЕ это! Держите токен у себя на странице.
Итак. нас интересует именно адресная строка, она выглядит примерно так:
Копируем отрезок с «#access_token=» до «&expires_in», получаем «564czzzzzzzzzzzzzzzzzzz2b73bbbbbbbbba730bfyyyyyyyyyyyyyyyy7e8265d6ee1c831a7xxxxxxxxxx», это то, что нам нужно.
Теперь записываем это всё:
Нажимаем на зелёную кнопочку «Save».
Далее нажимаем на нижнюю синюю кнопку «$ Bash console here», вводим команду:
Переходим обратно в Web, нажимаем на зелёную кнопочку «Reload» и вуаля! Бот запущен.
Обратите внимание, что сайт остановится через 3 месяца, если не нажимать на «Run until 3 months from today».
Привязка к Admin Bot
Самое сложное позади. Теперь для подключения Callback-сервера к боту, идём к нему в ЛС и пишем команду «/cb set ».
Если вы захотите отключить Callback-сервер, напишите «/cb unset».
Что нам дальше нужно сделать? Включить бота-страницу в нужной нам беседе! Переходим в неё, вводим «/cb connect ». ID получаем в адресной строке — «vk.com/im?sel=c14».
Если вы захотите отключить бота от беседы, введите «/cb disconnect» (работает для данного бота или создателя чата).
