Как создать бота в вк или про VK Callback API

Всем привет! Недавно на одном проекте мне пришлось столкнуться с ботом вк, который «живёт» в сообщениях группы. До этого я имел самый разный опыт создания ботов из личных страничек. Для того, чтобы бот мог нормально отвечать на сообщения приходилось делать самые разные извращения с кроном, таймерами, «запоминанием» сообщений и другими разными ужасами.
Как же я удивился, когда начав курить VK API групп касаемо сообщений, я увидел это чудо — Callback API.

Для нетерпеливых или любящих разбираться со всем самостоятельно в конце есть готовый пример.

Статья рассчитана не для совсем новичков и я не стал её сильно затягивать, специально опустив разжёвывание совсем очевидных вещей, иначе бы это была бы очень огромная статья. Тема написания ботов в целом так-то не очень новичковая тема.

Для тех кто не знает, что это, расскажу кратко.
При помощи этой фишки вк сам, автоматически, отправляет запросы в формате JSON куда мы укажем сами.
О формате JSON я писал немного инфы в статье про создание авторизации через вк

Так вот, в этом callback запросе вк может уведомлять обо всём: новых сообщениях группы, исходящих от группы сообщениях, видео, аудио, комментариях, новых подписчиках и так далее. И мы, прочитав этот запрос, можем решить, как на этот запрос реагировать.
Прямо как платёжные системы. Магия.

Давайте по порядку. Для того, чтобы воспользоваться callback api для создания бота или ещё чего-бы то ни было, нужно:

Сначала, конечно же, создать группу.
Открыть раздел «Управление сообществом», в котором справа будет вот такое меню:

Выбираем работу с API, где и имеем все настройки.

В первую очередь нужно создать API ключ, который сразу желательно где-то записать, потому что для его повторного отображения нужно будет получать смску на телефон.
Наверху водится вкладка с Callback API.

Откройте её и посмотрите, что там есть. Сразу можете указать в типах событий «Входящее сообщение», остальные пока не трогаем, иначе они будут без нужды напрягать сервер как вк, так и Ваш.

Предлагаю сделать вот что:
Пусть бот будет отвечать на сообщения этим же сообщением, которое ему прислали, только задом-наперёд, ахах

Для начала давайте слепим два файла. callback.php и vk.class.php. Класс нужен чисто для удобства, чтобы не громоздить большую кучу кода в одном файлике. Сделаем всё аккуратно 😀

Забегая наперёд скажу, что локалхосты указывать нельзя, сервер вк их попросту не увидит, для тестов или даже полноценного бота вам в любом случае придётся завести какой-нибудь худо-бедный сервачок.

Перед использованием самого каллбек апи придётся так же для начала подтвердить свой каллбек-скрипт, отдав вк нужную строку. Все запросы от каллбека будут лететь в формате JSON (уже говорил) и вк как бы сам показывает, как они будут выглядеть. Первый из них, это confirmation, который будет смотреться примерно так:

{"type":"confirmation","group_id":ИДГРУППЫ}

Идём теперь в наш callback.php, в котором для начала нужно получить запрос от вк и проверить, что же там пришло и сразу это обработать. О структуре запроса отправляемого от вк можно узнать из официальной документации вк
Ниже приведён сразу полный код файла callback.php, который будет укомплектован тонной комментариев )
Весь код будет максимально упрощен, во многих местах на каком-то большом и серьёзном проекте так лучше не делать ) Нужны будут как минимум обработчики ошибок и так далее, которые вк может вполне себе вернуть. Так же желательно будет использовать секретный ключ и всякое-разное

<?php
	$body = file_get_contents('php://input'); //Получаем в $body json строку
	$arr = json_decode($body, true); //Разбираем json запрос на массив в переменную $arr
	
	if ($arr['type'] == 'confirmation') { //Если нам пришел запрос на подтверждение callback скрипта, то
		exit("xxxxxxxx");  //отдаём в ответ свой код подтверждения выданный вк и останавливаем скрипт, дальше ему ничего не требуется
	}
	//Если скрипт выполняется дальше, значит это не confirmation, а одно из уведомлений.
	//Т.к. на данном этапе мы обрабатываем только входящее письмо, значит это входящее письмо
	if ($arr['type'] == 'message_new') { //Проверим на всякий случай, точно ли это входящее письмо
		function cir_strrev($stroka){ //Так как функция strrev не умеет нормально переворачивать кириллицу, нужен костыль через массив. Создадим функцию
			preg_match_all('/./us', $stroka, $array); 
			return implode('',array_reverse($array[0]));
		}
	
		//Значит точно входящее. Можно уже и наш класс подключить
		include_once ('vk.class.php'); //Меж дела подключаем наш vk.class.php
		
		//Сразу и создадим этот класс, который будет написан чуть позже
		//Сюда пишем ключ апи, который создавали в самом начале
		$vk = new vk('xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx');
		
		$sms = $arr['object']['body']; //Получаем текст сообщения, которое нам пришло.
		//О структуре этого массива который прилетел нам от вк можно узнать из официальной документации. Ссылка выше, до кода
		
		//Сразу и user_id получим, которому нужно отправлять всё это назад
		$vk_id = $arr['object']['user_id'];
		
		//Перевернём строку задом-наперёд используя php функцию strrev
		$sms_rev = cir_strrev($sms);
		
		//Используем наш ещё не написанный класс, для отправки сообщения в ответ
		$vk->send($vk_id, $sms_rev);
	}
	exit('ok'); //Обязательно возвращаем "ok", иначе вк отправит уведомление несколько раз

Теперь, собственно, сам vk.class.php:

<?php
//Задаём класс
class VK {

	public $token = ''; //Создаём публичную переменную для токена, который нужно отправлять каждый раз при использовании апи вк

	public function __construct($token) {
		$this->token = $token; //Забиваем в переменную токен при конструкте класса
	}
	
	public function send($id, $message) {	//Задаём публичную функцию send для отправки сообщений
		//Заполняем массив $data инфой, которую мы через api отправим до вк. О функции api "messages.send" можно почитать в официальной документации вк
		$data = array( 
			'peer_id'      => $id,
			'message' 	   => $message,
			'v'            => '5.46', //Версия для функции. Её передавать нужно обязательно. Узнать нужную можно через официальную документацию вк
		);
		//Получаем ответ через функцию отправки до апи, которую создадим ниже
		$out = $this->request('messages.send', $data);
		//И пусть функция вернёт ответ. Правда в данном примере мы это никак не будем использовать, пусть будет задаток на будущее
		return $out;
	}	
	
	public  function request($method, $data = array()) {
		$curl = curl_init(); //мутим курл-мурл в переменную. Для отправки предпочтительнее использовать курл, но можно и через file_get_contents если сервер не поддерживает
		
		$data['access_token'] = $this->token; //токен, который нужно отправить вместе с запросом тоже нужно добавить в дату

		curl_setopt($curl, CURLOPT_URL, 'https://api.vk.com/method/' . $method); //Ссылки до разных методов апи вк выглядят так: https://api.vk.com/method/И_ТУТ_САМ_МЕТОД, поэтому метод вполне можно забивать в эту функцию и без всяких ссылок
		curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
		curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST'); //Отправляем через POST
		curl_setopt($curl, CURLOPT_POST, true);
		curl_setopt($curl, CURLOPT_POSTFIELDS, $data); //Сами данные отправляемые
		
		$out = json_decode(curl_exec($curl), true); //Получаем результат выполнения, который сразу расшифровываем из JSON'a в массив для удобства
		
		curl_close($curl); //Закрываем курл
		
		return $out; //Отправляем ответ в виде массива
	}
}

Рабочий пример, так сказать, демо, можно посмотреть вот здесь. )