Import Leads

Import adds or updates leads by external ID in the selected channel. VK, Telegram, and MAX currently support import.

Managing leads permission is required.

In the side menu, open Leads. On the list page, select Import to open the import form.

Which IDs to provide

the list must contain from 1 to 10000 values;
values are trimmed at the beginning and end;
empty values and duplicates are not accepted;
for MAX, use chatId;
for VK and Telegram, use userId;
use IDs from the same platform as the selected channel.

The cabinet does not infer the platform from the digits in an ID. Do not mix IDs from different platforms in one run, and do not use a userId instead of a chatId for MAX.

How to import

In the channel field, select a VK, Telegram, or MAX connection.
Paste IDs into the external ID field, one per line or separated by commas.
Check the recognized ID count and start the import with the form button.
Follow progress and check the final result dialog. The import history later shows the status and summary counts for recent runs.

Import Leads. Highlighted elements: 2. import form; 3. channel field; 4. external ID field; 5. form button; 6. import history — 2. import form · 3. channel field · 4. external ID field · 5. form button · 6. import history

Import runs in the background. When it finishes, the result dialog shows the number of added, updated, and failed leads. An existing record is updated and counted separately from a new record. If individual IDs failed, expand the error list before closing the dialog: history keeps summary counts, but not the detailed error list.

If some leads were not imported

In the result dialog, expand Show errors. Each failed ID is shown with the reason returned while contacting the platform or saving the lead.

For VK, the profile and the community's permission to send messages to that person are checked before saving. This message permission determines the subscription status; community membership is not checked for this purpose. The ID fails if VK does not return the profile or the message permission cannot be verified.
For MAX, a chatId fails when the platform does not return a chat for it.
For Telegram, a record can be added with only the specified userId and the Not subscribed status when the platform does not return profile fields. Open that lead after import and check its profile.

If the entire process fails before per-ID results appear, check the selected channel and its connection. The field can currently list other channel types, but import works only with VK, Telegram, and MAX connections.