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 bot w php 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.php
W 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.