MadelineProtoDocs/docs/API_docs/methods/photos.uploadContactProfilePhoto.md
2024-08-02 18:49:34 +02:00

3.0 KiB

title description grand_parent parent image redirect_from
photos.uploadContactProfilePhoto Upload a custom profile picture for a contact, or suggest a new profile picture to a contact. Telegram RPC API Methods https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png /API_docs/methods/photos_uploadContactProfilePhoto.html

Method: photos.uploadContactProfilePhoto

Back to methods index

Upload a custom profile picture for a contact, or suggest a new profile picture to a contact.

The file, video and video_emoji_markup flags are mutually exclusive.

Parameters:

Name Type Description Required
suggest Bool If set, will send a messageActionSuggestProfilePhoto service message to user_id, suggesting them to use the specified profile picture; otherwise, will set a personal profile picture for the user (only visible to the current user). Optional
save Bool If set, removes a previously set personal profile picture (does not affect suggested profile pictures, to remove them simply deleted the messageActionSuggestProfilePhoto service message with messages.deleteMessages). Optional
user_id Username, chat ID, Update, Message or InputUser The contact Optional
file File path or InputFile Profile photo Optional
video File path or InputFile Animated profile picture video Optional
video_start_ts double Floating point UNIX timestamp in seconds, indicating the frame of the video/sticker that should be used as static preview; can only be used if video or video_emoji_markup is set. Optional
video_emoji_markup VideoSize Animated sticker profile picture, must contain either a videoSizeEmojiMarkup or a videoSizeStickerMarkup constructor. Optional

Return type: photos.Photo

Can bots use this method: NO

MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->start();

$photos_Photo = $MadelineProto->photos->uploadContactProfilePhoto(suggest: $Bool, save: $Bool, user_id: $InputUser, file: $InputFile, video: $InputFile, video_start_ts: $double, video_emoji_markup: $VideoSize, );