Внос на контакти от CSV файл в имейл списък

Как да подготвите файла — колоните, които Push познава, допълнителните колони, датите, — отметката за съгласие, какво става с хората, които вече са в списъка, и грешките при вноса.

Екипът на Monfri

Обновена на 12 октомври 2026 г.·4 мин четене

Най-бързият начин да напълните списък е CSV файл, изнесен от магазина, от стария ви имейл инструмент или от таблица. Push го внася в един списък.

Подгответе файла

CSV файл (.csv или .txt), най-много 10 MB. Всеки файл се проверява за вируси.
На първия ред са имената на колоните. Главни или малки букви — няма значение.
Колона email е задължителна; всички други са по желание.

Колона	Какво попълва
`email`	Адресът. Задължителен и трябва да е валиден имейл адрес.
`name`	Цялото име — разделя се на име и фамилия за обръщенията, когато тези колони са празни.
`first_name`, `last_name`	Името, за `{{first_name}}` в имейлите.
`country`, `city`	Къде е човекът.
`gender`	`male`, `female`, `other` или `prefer_not_to_say`.
`date_of_birth`	Дата във вида `YYYY-MM-DD`, например `1990-05-17`.
всяка друга	Пази се като Custom Metadata на абоната и се ползва като поле за сливане — колона `vip_level` става `{{vip_level}}`.

Запишете файла в UTF-8, за да останат кирилицата и другите букви такива, каквито са.

Внос

Отворете списъка в Push → Email → Lists. За нов: Списъците.
Под Import / Export изберете файла в CSV File (email, name columns).
Отметнете Everyone in this file opted in to marketing email. само ако са се съгласили. Без отметката хората се пазят, но не получават нито една кампания.
Натиснете Import. Push отговаря Import started. The result appears on this page when it has finished — you can leave the page meanwhile.

Вносът тече сам, затова голям файл не се прекъсва по средата. Страницата на списъка показва Importing … — … of … rows, после резултата: Import complete: … created, … updated. — … of them unsubscribed earlier and stay unsubscribed., когато във файла има хора, напуснали през връзка за отписване, … errors. с първите редове, които не са минали, и какво е намерила проверката на адресите: колко адреса не могат да получават поща, кои домейни приличат на грешка (gmial.com → gmail.com) и колко са рискови. Push проверява всеки нов домейн от файла още по време на вноса.

Докато вносът тече, следващият файл за същия списък чака, а също и кампания към списъка — тя тръгва сама, щом вносът свърши.

Хора, които вече са в списъка

Адрес, който вече е в този списък, не се добавя втори път — с каквито и главни и малки букви да е във файла: [email protected] и [email protected] са един човек, а Push пази адреса с малки букви. Името, колоните на профила и метаданните му се обновяват от файла. Състоянието и съгласието му остават каквито са — вносът никога не връща отписал се човек и никога не дава съгласие на някой, който го няма. Човек, напуснал през връзка за отписване в някой от вашите имейли, влиза като Unsubscribed във всеки списък, каквото и да пише във файла.

Същият адрес в друг списък е отделен човек там; вносът в един списък не променя другия.

През API-то

POST /api/v1/email/subscribers/import приема същия файл и веднага отговаря с вноса и адреса му; GET /api/v1/email/imports/{id} дава напредъка, а после резултата. Описанието на API-то: Push → API Reference.

Контактите от ръководството за настройка

Bring your contacts в ръководството за настройка на Hub внася в CRM, а не в имейл списък. За имейл кампании внесете файла в списък тук.

Ако нещо не работи

Missing required "email" column.

Първият ред няма колона с име email. Преименувайте колоната с адресите или добавете ред с имена, ако файлът започва направо с данни.

Column count mismatch.

Този ред има повече или по-малко стойности от първия — обикновено запетая в стойност без кавички. Сложете такива стойности в двойни кавички или запишете файла отново от таблицата.

Empty email. / Invalid email: …

Редът няма адрес или адресът не е валиден — например липсва @. Поправете го във файла и го внесете отново; вече внесените редове само се обновяват.

An import into this list is still running. Import the next file when it has finished.

По един внос на списък. Изчакайте резултата му на страницата на списъка и тогава внесете следващия файл.

The import stopped unexpectedly.

Вносът е бил прекъснат — например при обновяване на Push. Внесете същия файл отново: адресите, които вече са в списъка, само се обновяват, не се добавят втори път.

Всички са внесени, а кампанията не стига до никого

Внесени са без съгласие. Вижте Списъците.