MadelineProto/docs/TD_docs/methods/getChatHistory.md
Daniil Gentili 9d77dc0919 AMP fixes
2017-08-20 09:05:56 +00:00

2.5 KiB

title description
getChatHistory Returns messages in a chat. Automatically calls openChat. Returns result in reverse chronological order, i.e. in order of decreasing message.message_id

Method: getChatHistory

Back to methods index

YOU CANNOT USE THIS METHOD IN MADELINEPROTO

Returns messages in a chat. Automatically calls openChat. Returns result in reverse chronological order, i.e. in order of decreasing message.message_id

Params:

Name Type Required Description
chat_id InputPeer Yes Chat identifier
from_message_id long Yes Identifier of the message near which we need a history, you can use 0 to get results from the beginning, i.e. from oldest to newest
offset int Yes Specify 0 to get results exactly from from_message_id or negative offset to get specified message and some newer messages
limit int Yes Maximum number of messages to be returned, should be positive and can't be greater than 100. If offset is negative, limit must be greater than -offset. There may be less than limit messages returned even the end of the history is not reached

Return type: Messages

Example:

$MadelineProto = new \danog\MadelineProto\API();
if (isset($token)) { // Login as a bot
    $MadelineProto->bot_login($token);
}
if (isset($number)) { // Login as a user
    $sentCode = $MadelineProto->phone_login($number);
    echo 'Enter the code you received: ';
    $code = '';
    for ($x = 0; $x < $sentCode['type']['length']; $x++) {
        $code .= fgetc(STDIN);
    }
    $MadelineProto->complete_phone_login($code);
}

$Messages = $MadelineProto->getChatHistory(['chat_id' => InputPeer, 'from_message_id' => long, 'offset' => int, 'limit' => int, ]);

Or, if you're using the PWRTelegram HTTP API:

As a bot:

POST/GET to https://api.pwrtelegram.xyz/botTOKEN/madeline

Parameters:

  • method - getChatHistory
  • params - {"chat_id": InputPeer, "from_message_id": long, "offset": int, "limit": int, }

As a user:

POST/GET to https://api.pwrtelegram.xyz/userTOKEN/getChatHistory

Parameters:

chat_id - Json encoded InputPeer from_message_id - Json encoded long offset - Json encoded int limit - Json encoded int

Or, if you're into Lua:

Messages = getChatHistory({chat_id=InputPeer, from_message_id=long, offset=int, limit=int, })