Какие файлы читает импортёр
Импортёр читает CSV, TXT и XLSX размером до 50 МБ, до 1 000 000 номеров на кампанию, со строкой заголовков или без неё. Первый столбец, похожий на телефонные номера, используется как список получателей; все остальные столбцы становятся переменными, которые можно использовать в тексте, например {first_name}. Короткий список можно просто вставить.
Меньше всего неожиданностей даёт такая структура: одна строка на человека, сначала номер телефона, затем только те столбцы, которые нужны сообщению, с короткими названиями строчными буквами, которые легко набрать в фигурных скобках:
phone,first_name,store
+447400123456,Amelia,Leeds
+33612345678,Louis,Lyon
+4915123456789,Jonas,HamburgВсё остальное, что вы знаете о человеке, включая запись о его согласии, должно храниться в вашем основном списке, а не в загружаемом файле.
E.164 за одну минуту
E.164 — международный формат нумерации, определённый Международным союзом электросвязи: знак плюса, код страны и национальный номер без национального префикса и без пробелов. +44 7700 900123 превращается в +447700900123. Это единственный формат, который понимают операторы связи, и единственный, по которому мы определяем, тариф и правила какой страны применяются.
Всё держится на двух понятиях. Код страны состоит из одной, двух или трёх цифр: 1 для США и Канады, 44 для Великобритании, 234 для Нигерии. Национальный префикс — это то, что набирают перед национальным номером внутри страны: 0 в большинстве стран, 1 в США и Канаде, 8 в России, а в некоторых странах, например в Испании, его нет вовсе. Он относится к набору внутри страны, а не к самому номеру, поэтому в E.164 исчезает. В полном номере после плюса никогда не бывает больше 15 цифр. В глоссарии есть короткая статья: E.164.
Примеры по странам
Метод везде одинаков: уберите форматирование, отбросьте национальный префикс, добавьте плюс и код страны.
| Страна | Местная запись | Код страны | E.164 |
|---|---|---|---|
| Великобритания | 07400 123456 | 44 | +447400123456 |
| Франция | 06 12 34 56 78 | 33 | +33612345678 |
| Германия | 01512 3456789 | 49 | +4915123456789 |
| Испания | 612 34 56 78 | 34 | +34612345678 |
| США | (201) 555-0123 | 1 | +12015550123 |
| Бразилия | (11) 91234-5678 | 55 | +5511912345678 |
| Нигерия | 0803 123 4567 | 234 | +2348031234567 |
| Индия | 98765 43210 | 91 | +919876543210 |
Несколько случаев требуют большего, чем общее правило:
- США и Канада. Номер, записанный как 1-201-555-0123, уже содержит код страны 1 — повторно добавлять его не нужно. К номеру из десяти цифр без кода нужно добавить 1.
- Бразилия. При междугородном наборе внутри страны перед кодом региона могут стоять 0 и двузначный код оператора. И то и другое — префиксы набора, а не часть номера.
- Индия. Мобильные номера обычно записывают десятью цифрами; начальный 0, если он есть, — это национальный префикс.
- Италия. Исключение, которое ломает универсальные правила: стационарные номера сохраняют начальный 0 в международном формате (+39 06 для Рима), потому что там 0 — часть номера. Итальянские мобильные номера начинаются с 3, и отбрасывать в них 0 не приходится.
- 00 и 011. Это коды выхода на международную связь: 00 — из большинства стран, 011 — из США и Канады. 0044 7400 123456 и 011 44 7400 123456 — это один и тот же номер +447400123456.
Поэтому формула в таблице, удаляющая все начальные нули, — плохая идея, а страна по умолчанию в импортёре — более подходящий инструмент: он применяет правило той страны, которую вы указали.
Ловушки электронных таблиц
Многие номера портит электронная таблица ещё до того, как они попадают в импортёр. Таблица, которая воспринимает номер телефона как число, делает с ним три вещи:
- Удаляет начальный 0: 07400123456 превращается в 7400123456.
- Удаляет знак плюса: +447400123456 превращается в 447400123456.
- Может показывать длинные номера в экспоненциальной записи, например 4.47E+11, а в CSV, сохранённом из такого представления, могут остаться только цифры, видимые на экране. Тогда остальные цифры исчезают из файла навсегда.
Решение — задать столбцу с номерами текстовый формат до того, как вводить или вставлять в него данные, или сразу импортировать исходные данные как текст. При сохранении CSV выберите кодировку UTF-8, чтобы имена вроде Zoë, Łukasz или Siobhán сохранились для персонализации без искажений. Если файл пришёл уже повреждённым, вернитесь к исходной выгрузке, а не восстанавливайте цифры наугад.
Что делает нормализация
Номера в местном формате преобразуются, если известна страна: задайте для файла страну по умолчанию или добавьте столбец со страной. Пробелы, точки, дефисы и скобки удаляются. Начальные 00 воспринимаются как знак плюса. Номера, которые всё равно не удаётся распознать — слишком короткие, слишком длинные, с неизвестным префиксом, — исключаются и перечисляются в отчёте; они не отправляются и не оплачиваются.
Страна по умолчанию применяется только к номерам в местном формате. Номер, который уже начинается с плюса или с 00, содержит собственный код страны, поэтому +33 6 12 34 56 78 остаётся французским в файле, где страной по умолчанию указана Великобритания. Файл, в котором номера разных стран записаны в местном формате, — единственный случай, который одна страна по умолчанию не решает: добавьте столбец со страной или преобразуйте иностранные номера в источнике.
Удаление дубликатов
Один номер, записанный двумя способами, — это один получатель. После нормализации дубликаты объединяются, а переменные сохраняются из первой строки. В отчёте об импорте указано, сколько записей объединено, чтобы вы могли проверить источник, если это число вас удивит.
Если страной по умолчанию указана Великобритания, 07400 123456, +44 7400 123456 и 0044 7400 123456 превращаются в +447400123456: один получатель, одно сообщение, одно списание. Отсюда три привычки:
- Сортируйте перед экспортом. Поскольку сохраняется первая строка, поставьте первой строку с лучшими данными — обычно самую свежую запись.
- Объединяйте списки до импорта. Две кампании по двум пересекающимся спискам отправят по два сообщения всем, кто есть в обоих; один файл, собранный из обоих списков, отправит одно.
- Считайте большое число объединений симптомом. Форма, которая сохраняет каждую заявку, или выгрузка магазина с одной строкой на заказ вместо одной на клиента раздувает файл.
Дедупликация работает с номерами, а не с людьми. Клиент с личным и рабочим телефоном получит два сообщения, если вы не выберете один из номеров в источнике.
Столбцы согласия
Файлу кампании нужны номера и переменные, а доказательство того, что каждый человек дал согласие, хранится рядом с каждым номером в основном списке, из которого этот файл выгружается. Вопрос «когда этот человек дал согласие и на что?» всегда возникает по одному номеру, и на него отвечают эти столбцы:
| Столбец | Что в нём хранится | Пример |
|---|---|---|
consent_source | Где получен номер | Форма оформления заказа, подписка в магазине |
consent_at | Дата и время подписки | Метка времени в формате ISO 8601 |
consent_scope | На что человек дал согласие | Рекламные SMS или только сервисные сообщения |
consent_wording | Текст или версия формы, которую видел человек | signup-form-v3 |
opted_out_at | Когда человек отписался, если отписался | Пусто для активных подписчиков |
Перед каждой кампанией выгружайте только строки, область согласия которых охватывает сообщение, исключайте всех, у кого указана дата отписки, и удаляйте столбцы согласия из самого загружаемого файла. Что считается доказательством, зависит от страны; общие требования описаны в руководстве о правилах рекламных SMS. Списки, собранные парсингом, запрещены правилами допустимого использования, а купленные списки почти везде не проходят проверку на согласие.
Стационарные номера и другие тупики
Большинство стационарных линий не принимают SMS, а правильно отформатированный стационарный номер всё равно остаётся стационарным. Там, где мобильные и стационарные номера различаются префиксами, фильтруйте в источнике: мобильные номера Великобритании начинаются с 07, Франции — с 06 или 07, Германии — с 015, 016 или 017. В США и Канаде мобильные и стационарные номера используют одни и те же коды регионов, и по самому номеру их не различить, поэтому самый надёжный список для Северной Америки — тот, что изначально собирался как список мобильных номеров. Сообщение на стационарный номер, которое дошло до оператора и не было доставлено, оплачивается как любая другая попытка, поэтому удалять такие номера дешевле в источнике.
То же касается номеров, которые никогда не были личными: коммутаторов, факсов, общей стойки ресепшена. Общее поле телефона в CRM содержит тот номер, который ввёл клиент; если у вас есть и поле с пометкой «мобильный», используйте его.
Отчёт об импорте
Отчёт показывает прочитанные строки, готовые строки, неверные строки с причиной, объединённые дубликаты, найденные направления с количеством номеров по странам и разбивку стоимости по текущим тарифам. Прочитайте его до составления текста: список, который на 40% состоит из бразильских номеров, требует стратегии для цифрового отправителя, которая не нужна европейскому списку, — это объясняют правила для имени отправителя.
Три вопроса помогают прочитать отчёт быстро. Объяснима ли разница между прочитанными и готовыми строками? Знакомы ли вам причины неверных строк — например, столбец номеров, потерявших нули, — или это что-то новое? И совпадают ли страны с теми, где вы собирали номера? Неожиданная страна или слишком мало номеров в ожидаемой обычно означают, что номера были записаны без кода страны и прочитаны как местные.
Как поддерживать качество списка
Список устаревает сам по себе: люди меняют номера, операторы повторно выдают отключённые номера, а давно данное согласие забывается. Поддержание качества — это регулярная процедура, а не разовый проект:
- После каждой кампании удаляйте номера, отмеченные как неизвестные. Для этого в отчёте есть действие в одно нажатие.
- Недоступных абонентов оставляйте для повторной отправки позже, но удаляйте номера, которые недоступны от кампании к кампании.
- Храните все отписки в собственном стоп-листе и удаляйте эти номера из каждого файла перед импортом, какой бы инструмент или команда ни отправляли следующую рассылку.
- Храните источник согласия вместе с каждым номером.
- Перед большой кампанией перепроверьте давно не использовавшийся список небольшой отправкой на случайную выборку: доля неизвестных номеров в выборке покажет, сколько потратила бы впустую полная отправка.
- Дайте людям возможность обновить номер, например поле в личном кабинете, чтобы список следовал за ними.
Записи по каждому сообщению хранятся 90 дней, а сводки по кампаниям — бессрочно: этого достаточно, чтобы сравнить две кампании по одному списку и понять, стареет ли он; самый явный признак — растущая доля неизвестных номеров. Если нужна более длинная история, экспортируйте результаты по сообщениям. Руководство о причинах недоставки SMS объясняет каждую причину ошибки, а пошаговое руководство по первой рассылке показывает, как пустить список в работу.
Что-то непонятно или устарело? Сообщите нам на странице поддержки. Мы внесём исправления в руководство и обновим дату.
