Скрипт исключения из беседы VK и не только, написанный на PHP

Статьи / PHP

В этой статье я продолжу рассказывать как писать бота ВК. Когда я задался поиском скрипта для кика из бесед, на удивление я ничего рабочего и годного не нашел. Поэтому в этой статье я расскажу и покажу как сделать своего бота для исключения из бесед VK с помощью PHP 5.6+ и API VK.

В прошлой статье я рассказывал как настроить и создать своего бота в социальной сети VK, неожиданный ажиотаж и более 1000 просмотров за месяц и постоянные обращения помочь сделать ту или иную функцию для будущего бота, но дело в том, что я могу лишь подсказать, писать код я за вас бесплатно не буду, имейте в виду.

И так давайте приступим, готовый и рабочий проект можете скачать в самом низу этой статьи, настройку для сообщества читайте в прошлой статье

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



Копируем его и переходим к редактированию файла bot.php

Подключаем библиотеку, указываем константы, где укажем ключ сообщества, версию API и ключ для подтверждения сервера.

<?php

include "vk_api.php";


const VK_KEY = "b48c23e7e4aa9c7c02f61a51aff85b90e59a4c52567f8604e25074a9a82b2ccf8258f9b938095be8c5e9d"; //тот самый длинный ключ доступа сообщества
const ACCESS_KEY = "2835bc2f"; //например c40b9566, введите свой
const VERSION = "5.81"; //ваша версия используемого api

Да, в этот раз я использую программу PHPSTORM и советую скачать ее Вам, если планируете писать своего бота, она условна бесплатная, ну Вы сами знаете что делать   

Теперь составим список задач что наш бот должен уметь:
1) Кик из беседы по команде /kick
2) Проверку на администратора
3) Остальное придумывайте сами :)

Начнем по порядку, первая задача создать команду, которая будет уметь исключать пользователя из беседы.

Пишем код:

<?php

include "vk_api.php";



const VK_KEY = "b48c23e7e4aa9c7c02f61a51aff85b90e59a4c52567f8604e25074a9a82b2ccf8258f9b938095be8c5e9d"; //тот самый длинный ключ доступа сообщества
const ACCESS_KEY = "2835bc2f"; //например c40b9566, введите свой
const VERSION = "5.81"; //ваша версия используемого api



$vk = new vk_api(VK_KEY, VERSION); // создание экземпляра класса работы с api, принимает ключ и версию api
$data = json_decode(file_get_contents('php://input')); //Получает и декодирует JSON пришедший из ВК
//print_r($data);
if ($data->type == 'confirmation') { //Если vk запрашивает ключ
    exit(ACCESS_KEY); //Завершаем скрипт отправкой ключа
}
$vk->sendOK(); //Говорим vk, что мы приняли callback

// Создаем необходиммые переменные
$peer_id = $data->object->peer_id; // Узнаем ИД беседы 2000000.....
$id = $data->object->from_id; // Узнаем ид пользователя который отправляет команду
$message = $data->object->text; // Текст самого сообщения


if ($data->type == 'message_new') { // Если это новое сообщение то выполняем код указанный в условии


}

В комментарии к коду я оставил описание что есть что, поэтому тут вопросов у Вас возникать не должно. Теперь создаем команду и как-то пытаемся обработать ее:

if ($data->type == 'message_new') { // Если это новое сообщение то выполняем код указанный в условии


    if ($message == '/kick') {

        $vk->sendMessage($peer_id, "Тут должен быть кик но его еще не доделали"); // Отправляем ответ

    }


}

Да, это лишь статичная команда с одним ответом, нам же нужно понять что сообщение содержит кроме команды еще какие-то аргументы, для этого я буду использовать не совсем стандартное решение как использую в своих ботах (Свой код, увы, не сливаю :-))

Пишем следующий код:

if ($data->type == 'message_new') { // Если это новое сообщение то выполняем код указанный в условии


    if (mb_substr($message,0,5) == '/kick'){ // Обрезаем сообщение и сравниваем что получилось

        $kick_id = mb_substr($message ,6); // еще раз обрезаем и получаем все что написано после /kick_
        $vk->request('messages.removeChatUser', ['chat_id' => $chat_id, 'member_id' => $kick_id]);
        $vk->sendMessage($peer_id, "id - {$kick_id} был исключен :-)");

    }


}

Если посмотреть на скриншот, можно увидеть дополнительные слова в коде, такие как: str, start, length их не нужно писать, это подсказки IDE (PhpStorm). Это уже действующая команда, давайте проверим.

Подтверждаем адрес сервера 

Добавляем в беседу и пробуем кого-нибудь исключить.
Хм, не работает...



Проверяем включили ли мы тип событий который бот должен принимать, если нет, включаем.

Снова не работает


Ну конечно, нужно создать еще одну переменную 

$chat_id = $peer_id - 2000000000;

Проверяем:


Все работает, всего 6 строк кода для команды, не плохо не правда ли? Да, тут есть некоторые проблемы, дело в том что нужно указывать именно ID пользователя, иначе работать не будет, а так же допишем проверку на пустой аргумент, например если пользователь просто написал /kick

if ($data->type == 'message_new') { // Если это новое сообщение то выполняем код указанный в условии


    if (mb_substr($message,0,5) == '/kick'){ // Обрезаем сообщение и сравниваем что получилось

        $kick_id = mb_substr($message ,6); // еще раз обрезаем и получаем все что написано после /kick_
        if($kick_id == ""){
            $vk->sendMessage($peer_id, "Вы забыли указать аргумент");

        } else {

        $chat_id = $peer_id - 2000000000;
        $vk->request('messages.removeChatUser', ['chat_id' => $chat_id, 'member_id' => $kick_id]);
        $vk->sendMessage($peer_id, "id - {$kick_id} был исключен :-)");

    }
    }

}

Простая проверка на пустоту, если аргумент не указан, сообщаем об этом, иначе выполняем функцию исключения из беседы.


Отлично, давайте упростим немного кик из беседы и создадим мини админку.
Что бы исключать из беседы, нужно понимать в каком виде приходит сообщение при упоминании пользователя [id1|Павел Дуров] нам нужен только ID, получить его можно с помощью функции explode, давайте вернемся в PhpStorm и напишем код:

 $kick_id = explode("|", mb_substr($kick_id, 3))[0]; // Делитель |, обрезаем первые 3 символа (@id) и получаем чистый ID :-)

Давайте проверим, будет ли работать наш код:

Отлично, теперь у вас есть свой личный бот, который умеет исключать из бесед, но, если Вам нужен более профессиональный бот с большим функционалом и мощным инструментом администрирования бесед, то советую наш продукт Conference Kot



С первым пунктом покончено, давайте теперь создадим мини админку, где будем указывать ID’s пользователей, которым разрешено использовать команду, так как она сейчас доступна для всех.

К нашим переменным добавляем новую:

$is_admin = [87444494, 183657]; // создаем массив с ID's наших будущих админов через запятую 

Теперь добавляем еще 1 проверку, где будем перебирать массив и искать схожесть, иначе просто не выполняем команду   

$is_admin = [87444494, 183657]; // создаем массив с ID's наших будущих админов через запятую
$chat_id = $peer_id - 2000000000;

if ($data->type == 'message_new') { // Если это новое сообщение то выполняем код указанный в условии


    if (mb_substr($message,0,5) == '/kick'){ // Обрезаем сообщение и сравниваем что получилось

            if (in_array($id, $is_admin)) { // С помощью in_array проверяем схожесть переменной $id с массивом с ID's

        $kick_id = mb_substr($message ,6); // еще раз обрезаем и получаем все что написано после /kick_
        $kick_id = explode("|", mb_substr($kick_id, 3))[0];

        if($kick_id == ""){
            $vk->sendMessage($peer_id, "Вы забыли указать аргумент");

        } else {

        $vk->request('messages.removeChatUser', ['chat_id' => $chat_id, 'member_id' => $kick_id]);
        $vk->sendMessage($peer_id, "id - {$kick_id} был исключен :-)");

    }
    } else {
            $vk->sendMessage($peer_id, "У Вас нет доступа к этой команде!");

        }
    }
}

Весь код целиком:

<?php

include "vk_api.php";



const VK_KEY = "b48c23e7e4aa9c7c02f61a51aff85b90e59a4c52567f8604e25074a9a82b2ccf8258f9b938095be8c5e9d"; //тот самый длинный ключ доступа сообщества
const ACCESS_KEY = "be20ea35"; //например c40b9566, введите свой
const VERSION = "5.81"; //ваша версия используемого api



$vk = new vk_api(VK_KEY, VERSION); // создание экземпляра класса работы с api, принимает ключ и версию api
$data = json_decode(file_get_contents('php://input')); //Получает и декодирует JSON пришедший из ВК
//print_r($data);
if ($data->type == 'confirmation') { //Если vk запрашивает ключ
    exit(ACCESS_KEY); //Завершаем скрипт отправкой ключа
}
$vk->sendOK(); //Говорим vk, что мы приняли callback
// Создаем необходимые переменные
$peer_id = $data->object->peer_id; // Узнаем ИД беседы 2000000.....
$id = $data->object->from_id; // Узнаем ид пользователя который отправляет команду
$message = $data->object->text; // Текст самого сообщения
$is_admin = [87444494, 183657]; // создаем массив с ID's наших будущих админов через запятую
$chat_id = $peer_id - 2000000000;

if ($data->type == 'message_new') { // Если это новое сообщение то выполняем код указанный в условии


    if (mb_substr($message,0,5) == '/kick'){ // Обрезаем сообщение и сравниваем что получилось

            if (in_array($id, $is_admin)) { // С помощью in_array проверяем схожесть переменной $id с массивом с ID's

        $kick_id = mb_substr($message ,6); // еще раз обрезаем и получаем все что написано после /kick_
        $kick_id = explode("|", mb_substr($kick_id, 3))[0];

        if($kick_id == ""){
            $vk->sendMessage($peer_id, "Вы забыли указать аргумент");

        } else {

        $vk->request('messages.removeChatUser', ['chat_id' => $chat_id, 'member_id' => $kick_id]);
        $vk->sendMessage($peer_id, "id - {$kick_id} был исключен :-)");

    }
    } else {
            $vk->sendMessage($peer_id, "У Вас нет доступа к этой команде!");

        }
    }
}

Проверим:



Изменим ID на другой:

Работает   

Если данная статья окажется такой же полезной как и прошлая то в следующей статье мы рассмотрим уже подключение к базе данных и хранение в ней информации, в том числе отображение. Ставим лайки и пишем комментарии, удачного кодинга вам   


Скачать архив с библиотекой и исходным кодом (требуется регистрация на сайте)