stories.sendStory

Uploads a Telegram Story. May also be used in a business connection, not by wrapping the query in invokeWithBusinessConnection », but rather by specifying the ID of a controlled business user in peer.

func (c *Client) StoriesSendStory(ctx context.Context, request *StoriesSendStoryRequest) (UpdatesClass, error)

Calling this method

client.Run(ctx, func(ctx context.Context) error {
	api := client.API()
	
	res, err := api.StoriesSendStory(ctx, &tg.StoriesSendStoryRequest{
		// see Parameters
	})
	if err != nil {
		return err
	}
	_ = res // UpdatesClass
	return nil
})

Parameters

Name	Type	Required	Description
Pinned	bool	—	Whether to add the story to the profile automatically upon expiration. If not set, the story will only be added to the archive, see here » for more info.
Noforwards	bool	—	If set, disables forwards, screenshots, and downloads.
FwdModified	bool	—	Set this flag when reposting stories with fwd_from_id+fwd_from_id, if the media was modified before reposting.
Peer	InputPeerClass	yes	The peer to send the story as.
Media	InputMediaClass	yes	The story media.
MediaAreas	[]MediaAreaClass	—	Media areas associated to the story, see here » for more info.
Caption	string	—	Story caption.
Entities	[]MessageEntityClass	—	Message entities for styled text, if allowed by the stories_entities client configuration parameter ».
PrivacyRules	[]InputPrivacyRuleClass	yes	Privacy rules for the story, indicating who can or can't view the story.
RandomID	int64	yes	Unique client message ID required to prevent message resending.
Period	int	—	Period after which the story is moved to archive (and to the profile if pinned is set) in seconds; must be one of 6 * 3600, 12 * 3600, 86400, or 2 * 86400 for Telegram Premium users, and 86400 otherwise.
FwdFromID	InputPeerClass	—	If set, indicates that this story is a repost of story with ID fwd_from_story posted by the peer in fwd_from_id.
FwdFromStory	int	—	If set, indicates that this story is a repost of story with ID fwd_from_story posted by the peer in fwd_from_id.
Albums	[]int	—	If set, adds the story to the specified albums.
Music	InputDocumentClass	—	Music field of StoriesSendStoryRequest.

Returns

UpdatesClass

Possible errors

Code	Type	Description
400	BOOSTS_REQUIRED	The specified channel must first be boosted by its users in order to perform this action.
403	BOT_ACCESS_FORBIDDEN	The specified method can be used over a business connection for some operations, but the specified query attempted an operation that is not allowed over a business connection.
400	CHANNEL_INVALID	The provided channel is invalid.
400	CHAT_ADMIN_REQUIRED	You must be an admin in this chat to do this.
400	IMAGE_PROCESS_FAILED	Failure while processing image.
400	MEDIA_EMPTY	The provided media object is invalid.
400	MEDIA_FILE_INVALID	The specified media file is invalid.
400	MEDIA_TYPE_INVALID	The specified media type cannot be used in stories.
400	MEDIA_VIDEO_STORY_MISSING	A non-story video cannot be repubblished as a story (emitted when trying to resend a non-story video as a story using inputDocument).
400	PEER_ID_INVALID	The provided peer id is invalid.
400	PHOTO_INVALID_DIMENSIONS	The photo dimensions are invalid.
400	PREMIUM_ACCOUNT_REQUIRED	A premium account is required to execute this action.
400	REACTION_INVALID	The specified reaction is invalid.
400	STORIES_TOO_MUCH	You have hit the maximum active stories limit as specified by the story_expiring_limit_* client configuration parameters: you should buy a Premium subscription, delete an active story, or wait for the oldest story to expire.
400	STORY_PERIOD_INVALID	The specified story period is invalid for this account.
400	VENUE_ID_INVALID	The specified venue ID is invalid.

References

• Official documentation
• Generated Go reference
• TL definition: stories.sendStory#8f9e6898