mention to the participant’s handle, and write the display name in value without an at sign. mention_range is optional and selects the slice of value that the mention covers; without it, the mention covers the whole part. Count the range in UTF-16 code units, not visible characters: most characters are one unit, some emoji are two, and 0 <= start < end <= value.length must hold in JavaScript.
Mentions work only in a group chat, and the target must still be a participant. Send the part through either send path; nothing else about the request changes.
Send a mention
Mentionecho at the start of a request:
202 with the message. When anyone reads it back, each text part carries mentions, ordered by position, or null when there are none.
Each entry has the participant’s stable Contact id, their current handle, and the range it covers. is_me is true when the mention addresses the reader. The range covers the whole value when the send omitted mention_range.
Store the id, not the handle; a handle can be renamed. Branch on is_me rather than comparing handles. The response fields mention and mention_range are deprecated mirrors of the first entry.