Send an in-call message to all participants of a video chat/livestream or live story, including in RTMP mode, see here » for more info.
The send_as field can only be populated for live stories, where it optionally selects the displayed author. If omitted, the server automatically selects the appropriate author. Do not populate it for video chats/livestreams.
Video chats/livestreams and live stories support animated emoji reactions », encoded as messages containing only a standard available reaction emoji or a single custom emoji entity.
For a paid live story comment, pass the user-confirmed donation amount in allow_paid_stars. For commenters other than the live story owner, this amount must be at least the current groupCall.send_paid_messages_stars minimum. A higher amount may be donated to highlight the comment. The live story owner may comment without populating allow_paid_stars. To send a standalone paid live story donation, pass a positive allow_paid_stars value and an empty message, see here » for the full flow.
updatesTooLong#e317af7e = Updates;
updateShortMessage#313bc7f8 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int user_id:long message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
updateShortChatMessage#4d6deea5 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int from_id:long chat_id:long message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
updateShort#78d4dec1 update:Update date:int = Updates;
updatesCombined#725b04c3 updates:Vector<Update> users:Vector<User> chats:Vector<Chat> date:int seq_start:int seq:int = Updates;
updates#74ae4240 updates:Vector<Update> users:Vector<User> chats:Vector<Chat> date:int seq:int = Updates;
updateShortSentMessage#9015e101 flags:# out:flags.1?true id:int pts:int pts_count:int date:int media:flags.9?MessageMedia entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
---functions---
phone.sendGroupCallMessage#b1d11410 flags:# call:InputGroupCall random_id:long message:TextWithEntities allow_paid_stars:flags.0?long send_as:flags.1?InputPeer = Updates;| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| call | InputGroupCall | Video chat/livestream or live story that should receive the message, reaction or donation |
| random_id | long | Fresh client-generated random ID used to deduplicate the message or donation |
| message | TextWithEntities | Message text or emoji reaction; pass an empty value when sending a standalone paid live story donation |
| allow_paid_stars | flags.0?long | User-confirmed number of Telegram Stars to donate with a live story comment or standalone donation |
| send_as | flags.1?InputPeer | Optional peer to display as the author of a live story message or reaction; can only be used for live stories |
| Code | Type | Description |
|---|---|---|
| 400 | GROUPCALL_INVALID | The specified group call is invalid. |
| 400 | GROUPCALL_JOIN_MISSING | You haven't joined this group call. |
How to start, join and manage group calls and video chats.
Describes a group call.
If the min flag is set, this is a partial (min) constructor: only a subset of its fields contains up-to-date information, and it must be merged into a previously cached non-min constructor as described below. If no full (non-min) constructor for this call was cached previously, the min constructor must be discarded.
When min is set, the following mandatory fields may be used: id, access_hash, participants_count and version. In addition, only the following conditional fields may be used if present, subject to the usual version check:
conferencertmp_streamlisteners_hiddentitlemessages_enabledrecord_start_date and record_video_activeschedule_datesend_paid_messages_starsWhen min is set, the following fields must be ignored, keeping the values from the previously cached non-min constructor:
join_mutedcan_change_join_mutedschedule_start_subscribedcan_start_videocreatorcan_change_messages_enabledunmuted_video_countunmuted_video_limitstream_dc_idinvite_linkdefault_send_asThe join_date_asc flag is set only when the call is created and never changes afterwards, so it too is not applied from a min constructor.