Tworzenie bota na Telegram w PHP
Napiszemy prostego bota na Telegram w PHP.
Najpierw musimy utworzyć bota w Telegramie. Wejdź do aplikacji Telegram i odszukaj użytkownika BotFather. Następnie wpisz komendę /newbot.
Podaj nazwę bota i unikalny login kończący się na bot. Po utworzeniu otrzymasz token API, np. 123456789:AAExampleTokenXXXXXXXXXXXXXXXX.
Telegram wysyła wiadomości do naszego skryptu PHP przez tzw. Webhook. Schemat działania jest następujący: Użytkownik -> Telegram -> webhook PHP -> odpowiedź bota.
Bot odbiera dane JSON od Telegrama, analizuje wiadomość i wysyła odpowiedź przez API Telegrama.
Struktura naszego projektu projektu:
telegram-bot/ │ ├── bot.php └── config.phpW pliku config.php przechowujemy token naszego bota.
<?php
define('BOT_TOKEN', 'TU_WSTAW_TOKEN_BOTA');
define('API_URL', 'https://api.telegram.org/bot' . BOT_TOKEN . '/');
Poniżej znajduje się główny kod bota (plik bot.php).
<?php
require_once 'config.php';
/*
|--------------------------------------------------------------------------
| Pobranie danych wysłanych przez Telegram
|--------------------------------------------------------------------------
*/
$content = file_get_contents("php://input");
$update = json_decode($content, true);
/*
|--------------------------------------------------------------------------
| Sprawdzenie czy przyszła wiadomość
|--------------------------------------------------------------------------
*/
if (!isset($update["message"])) {
exit;
}
$message = $update["message"];
/*
|--------------------------------------------------------------------------
| Dane użytkownika
|--------------------------------------------------------------------------
*/
$chatId = $message["chat"]["id"];
$text = trim($message["text"] ?? "");
/*
|--------------------------------------------------------------------------
| Funkcja wysyłająca wiadomość
|--------------------------------------------------------------------------
*/
function sendMessage($chatId, $text)
{
$url = API_URL . "sendMessage";
$data = [
"chat_id" => $chatId,
"text" => $text
];
$options = [
"http" => [
"header" => "Content-type: application/x-www-form-urlencoded\r\n",
"method" => "POST",
"content" => http_build_query($data),
]
];
$context = stream_context_create($options);
file_get_contents($url, false, $context);
}
/*
|--------------------------------------------------------------------------
| Obsługa komend
|--------------------------------------------------------------------------
*/
switch ($text) {
case "/start":
sendMessage(
$chatId,
"Witaj jestem botem napisanym w PHP."
);
break;
case "/help":
sendMessage(
$chatId,
"Dostępne komendy:\n/start\n/help\n/date"
);
break;
case "/date":
sendMessage(
$chatId,
"Aktualna data: " . date("Y-m-d H:i:s")
);
break;
default:
sendMessage(
$chatId,
"Napisałeś: " . $text
);
}
Bot musi być dostępny publicznie przez HTTPS np. https://domena.pl/bot.php. Kolejnym krokiem jest ustawienie webhooka.
W przeglądarce wpisz: https://api.telegram.org/botTOKEN/setWebhook?url=https://domena.pl/bot.php np. https://api.telegram.org/bot123456:ABCDEF/setWebhook?url=https://domena.pl/bot.php.
Po poprawnym ustawieniu otrzymasz:
{
"ok": true,
"result": true,
"description": "Webhook was set"
}
Omówmy teraz pokrótce jak działa kod.
Odbieramy dane za pomocą:
$content = file_get_contents("php://input");
Telegram wysyła JSON do naszego pliku. Następnie konwertujemy JSON na tablicę PHP.
$update = json_decode($content, true);W celu odczytania tekstu wpisanego przez użytkownika:
$text = $message["text"];Bot korzysta z endpointu sendMessage czyli https://api.telegram.org/botTOKEN/sendMessage. Do naszego bota można dodać na przykład obsługę zdjęć:
if (isset($message["photo"])) {
sendMessage($chatId, "Wysłałeś zdjęcie!");
}
lub przyciski:
$data = [
"chat_id" => $chatId,
"text" => "Wybierz opcję",
"reply_markup" => json_encode([
"keyboard" => [
[["text" => "Opcja 1"]],
[["text" => "Opcja 2"]]
],
"resize_keyboard" => true
])
];
Zamiast file_get_contents() możesz użyć cURL:
function sendMessage($chatId, $text)
{
$url = API_URL . "sendMessage";
$data = [
"chat_id" => $chatId,
"text" => $text
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_exec($ch);
curl_close($ch);
}
Więcej można przeczytać w Dokumentacji Telegram API.