send_contact()

async Client.send_contact()

Send phone contacts.

Usable by Users Bots
Parameters:

  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat. For your personal cloud (Saved Messages) you can simply use “me” or “self”. For a contact that exists in your Telegram address book you can use his phone number (str).

  • phone_number (str) – Contact’s phone number.

  • first_name (str) – Contact’s first name.

  • last_name (str, optional) – Contact’s last name.

  • vcard (str, optional) – Additional data about the contact in the form of a vCard, 0-2048 bytes

  • disable_notification (bool, optional) – Sends the message silently. Users will receive a notification with no sound.

  • reply_to_message_id (int, optional) – If the message is a reply, ID of the original message.

  • schedule_date (datetime, optional) – Date when the message will be automatically sent.

  • protect_content (bool, optional) – Protects the contents of the sent message from forwarding and saving.

  • reply_markup (InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply, optional) – Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.

  • ephemeral_message_parameters (EphemeralMessageParameters, optional) – Send the message as an ephemeral message, visible only to the user it names and absent from the chat’s history, rather than as an ordinary one. The ephemeral RPC has no field for silent, background, clear_draft, schedule_date, repeat_period, send_as, effect_id, quick_reply_shortcut, allow_paid_broadcast, paid_message_star_count, suggested_post_parameters or update_stickersets_order; any of those that is set is logged and dropped.

  • reply_to_chat_id (int | str, optional) – Unique identifier for the chat to which the replied message belongs. Only applicable in combination with reply_to_message_id.

  • reply_parameters (ReplyParameters, optional) – Describes reply parameters for the message that is being sent.

  • message_thread_id (int, optional) – Unique identifier for a message thread in a forum topic.

  • allow_paid_broadcast (bool, optional) – If True, you will be allowed to send up to 1000 messages per second. Ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot’s balance. For bots only.

  • paid_message_star_count (int, optional) – The number of Telegram Stars the user agreed to pay to send the messages.

  • business_connection_id (str, optional) – Unique identifier of the business connection.

  • quote_text (str, optional) – Text of the quote to reply to.

  • quote_entities (List of MessageEntity) – List of special entities that appear in quote_text, which can be specified instead of parse_mode.

  • effect_id (int, optional) – Unique identifier of the effect to apply to the message.

  • show_caption_above_media (bool, optional) – Pass True, if the caption must be shown above the message media.

  • repeat_period (int, optional) – New period in seconds for the message to be sent repeatedly.

  • suggested_post_parameters (SuggestedPostParameters, optional) – Parameters of the suggested post.

  • direct_messages_topic_id (int, optional) – Unique identifier of the topic in a channel direct messages chat administered by the current user. For directs only only.

  • background (bool, optional) – Send the message in background.

  • clear_draft (bool, optional) – Clear the draft of the chat.

  • update_stickersets_order (bool, optional) – Move the sticker set to the top of the list.

  • send_as (int | str, optional) – Unique identifier (int) or username (str) of the chat or channel to send the message as.

  • quick_reply_shortcut (int, optional) – Unique identifier of the quick reply shortcut the message belongs to.

Returns:

Message – On success, the sent contact message is returned.

Example

await app.send_contact("me", "+1-123-456-7890", "Name")