contacts.AddContact
Add an existing telegram user as contact.
Example
const { Api, TelegramClient } = require("telegram");
const { StringSession } = require("telegram/sessions");
const session = new StringSession(""); // You should put your string session here
const client = new TelegramClient(session, apiId, apiHash, {});
(async function run() {
await client.connect(); // This assumes you have already authenticated with .start()
const result = await client.invoke(
new Api.contacts.AddContact({
id: "username",
firstName: "some string here",
lastName: "some string here",
phone: "some string here",
addPhonePrivacyException: true,
})
);
console.log(result); // prints the result
})();
import { Api, TelegramClient } from "telegram";
import { StringSession } from "telegram/sessions";
const session = new StringSession(""); // You should put your string session here
const client = new TelegramClient(session, apiId, apiHash, {});
(async function run() {
await client.connect(); // This assumes you have already authenticated with .start()
const result: Api.Updates = await client.invoke(
new Api.contacts.AddContact({
id: "username",
firstName: "some string here",
lastName: "some string here",
phone: "some string here",
addPhonePrivacyException: true,
})
);
console.log(result); // prints the result
})();
Parameters
Name | Type | Description |
---|---|---|
flags | # | Flags, see TL conditional fields |
addPhonePrivacyException | flags.0?true | Allow the other user to see our phone number? |
id | InputUser | Telegram ID of the other user |
firstName | string | First name |
lastName | string | Last name |
phone | string | User's phone number |
Result
Possible errors
Code | Type | Description |
---|---|---|
400 | CHANNEL_PRIVATE | You haven't joined this channel/supergroup. |
400 | CONTACT_ID_INVALID | The provided contact ID is invalid. |
400 | CONTACT_NAME_EMPTY | Contact name empty. |
400 | MSG_ID_INVALID | Invalid message ID provided. |
Can bots use this method?
No
Related pages
contacts.importContacts
Imports contacts: saves a full list on the server, adds already registered contacts to the contact list, returns added contacts and their info.