Skip to main content

Getting Updates

As mentioned in the introduction, the Bot class provides a method to get updates.

Updates Methods

You can pass 3 updates methods:

  • null: No updates are expected from Telegram, is set as default.
  • Update::UPDATES_FROM_GET_UPDATES: Get updates from the getUpdates() method.
  • Update::UPDATES_FROM_WEBHOOK: Get updates from php://input.

Get Updates

<?php

use TelegramSDK\BotAPI\Telegram\Bot;

// With getUpdates()
$bot = new Bot("YOUR_BOT_TOKEN", Bot::UPDATES_FROM_GET_UPDATES);

$updates = $bot->updates();
foreach($updates->result as $update){
echo json_encode($update) . "\n";
}

Webhook

<?php
use TelegramSDK\BotAPI\Telegram\Bot;

// A webhook must be set
$bot = new Bot("YOUR_BOT_TOKEN", Update::UPDATES_FROM_WEBHOOK);

$update = $bot->updates();
echo (json_encode($update) ?? "No updates found.") . "\n";

Default Updates

The library provides general default updates to use.

$update = $bot->updates();
$message = $update->getMessage();

Here's a list of the currently available methods:

  • getLastUpdateId(): The last update's identifier.
  • `getMessage: New incoming message of any kind - text, photo, sticker, etc.
  • `getChat: The chat object of the last update.
  • `getUser: The user object of the last update.
  • getTrigger: Returns the trigger of the update. (i.e. A command, a caption, a callback data, ...)