Объединение CSV-файла Carrier Lookup с исходными записями контактов
Практическое руководство по объединению данных Carrier Lookup с исходными записями контактов с учетом ограничений запросов и этапов проверки для команд.
Чтобы объединить CSV-файл Carrier Lookup с записями контактов, создайте локальный вспомогательный файл (sidecar) перед загрузкой: сопоставьте каждый подготовленный номер с кодом страны с каждым идентификатором исходной строки контакта, который его предоставил.
Чтобы объединить CSV-файл Carrier Lookup с записями контактов, создайте локальный вспомогательный файл перед загрузкой: сопоставьте каждый подготовленный номер с кодом страны с каждым идентификатором исходной строки контакта, который его предоставил. Отправляйте только подготовленные идентификаторы для выбранной страны, а затем выполняйте сверку полученного CSV-файла по идентификатору, а не по позиции строки в файле. Это позволяет сохранить дубликаты контактов, не предполагая, что пакетная служба возвращает одну строку для каждой исходной записи.
Подготовьте вспомогательный файл перед созданием пакетного файла
Решение Original Carrier Lookup от CarrierLookup в режиме реального времени возвращает оператора, которому номер был выделен изначально, базового оператора, тип номера и географию выделения. Отдельный продукт Global carrier lookup предназначен для асинхронных файловых задач. Страница Global carrier lookup является соответствующим разделом продукта. Пакетная обработка принимает одностолбцовые файлы TXT или CSV, где на каждой строке указан номер с кодом страны, а также одна выбранная страна ISO. Подготовленный файл должен быть предназначен преимущественно для этой выбранной страны. Не предполагайте, что продукт принимает файлы XLSX, смешанные схемы или файлы, содержащие идентификаторы строк CRM.
Экспорт из CRM-системы может содержать повторяющиеся номера, различные форматы отображения, пустые значения и номера вне целевой страны. Перед отправкой создайте локальное сопоставление канонического номера с кодом страны со списком идентификаторов исходных строк. Сохраняйте исходный текст и решение о нормализации рядом с каждой строкой для аудита. Например, два контакта могут использовать один и тот же номер офисной АТС; вспомогательный файл должен сохранять оба идентификатора строк, даже если отправленный список содержит этот номер только один раз. Это структура данных, принадлежащая клиенту, а не столбец, возвращаемый пакетным продуктом.
Отделяйте отклоненную исходную строку от исключенного подготовленного идентификатора. Строка может быть непригодна для использования перед загрузкой, если в ней недостаточно контекста для нормализации, в то время как пакетная предварительная обработка может позже исключить дубликаты или номера вне выбранной страны. Четко фиксируйте этап.
Используйте значение идентификатора, а не позицию строки, в качестве ключа объединения
Успешная пакетная задача возвращает один CSV-файл с идентификатором и полями исходного выделения. Пакетные идентификаторы представляют собой цифры с кодом страны без знака «плюс» или пробелов. Исходная CRM может хранить номера E.164 с ведущим плюсом, в национальном формате или с пунктуацией. Нормализуйте обе стороны в единую форму сравнения, принадлежащую клиенту, прежде чем объединять их, сохраняя при этом каждое исходное представление отдельно. Не предполагайте, что порядок строк в CSV-файле совпадает с порядком строк контактов; предварительная обработка может исключить недействительные или дублирующиеся записи.
Объединение имеет тип «многие-к-одному»: несколько строк контактов могут указывать на один подготовленный номер и одну возвращенную строку поиска. Разворачивайте результат обратно к этим исходным строкам только после проверки ключа. И наоборот, если возвращенный идентификатор отсутствует в отправленном манифесте, поместите его в карантин для проверки, а не прикрепляйте к ближайшей строке. Это правило сверки, а не утверждение о том, что неожиданные строки являются нормальным поведением продукта.
Компактный манифест может содержать идентификатор исходной строки, исходный текст телефона, нормализованное значение для сравнения, выбранную страну, имя подготовленного файла и ссылку на пакет отправки. Это локальные поля метаданных. Их нельзя рекламировать как столбцы CSV-файла CarrierLookup. Для отправки текущих задач и получения сведений о результатах следует использовать документацию API.
Проверьте исключения и дубликаты перед обновлением записей
Пакетная предварительная обработка исключает недействительные строки, дубликаты, номера без кода страны и номера вне выбранной страны. За исключенные строки плата не взимается. Именно поэтому количество строк при загрузке, количество подготовленных действительных номеров и количество результатов могут различаться. Сверяйте их как три отдельных показателя. Не заполняйте данные об операторе для исключенной строки из соседней строки вывода. Если дублирующиеся исходные контакты имеют один нормализованный номер, приложение может сопоставить один завершенный результат с обоими, с тем же временем наблюдения и источником.
Задача может завершиться с ошибкой во время подготовки, если оценено слишком мало действительных мобильных номеров или не выполнено другое условие приемлемости. В этом случае не создавайте фиктивные строки результатов из входного файла. Сохраняйте манифест для диагностики и обращайтесь к документации по продукту для уточнения текущих ограничений для каждого продукта. В этой статье намеренно не указываются конкретные минимумы, максимумы или нормальное время завершения задачи. Пакетная задача является асинхронной, поэтому дождитесь успешного завершения, прежде чем использовать ее CSV-файл.
Поля CSV-файла описывают исходное выделение, а не текущего оператора после переноса номера. Регион и город — это география выделения диапазона, а не местоположение контакта. Завершенная строка с пустыми полями выделения должна оставаться завершенной строкой с недоступными значениями, а не отбрасываться как недействительное объединение.
Подготовьте отчет о сверке перед записью в CRM
Итоговый отчет, принадлежащий клиенту, должен содержать список отправленных уникальных идентификаторов, возвращенных идентификаторов, несовпадающих отправленных ключей, неожиданных возвращенных ключей, исходных строк, номера которых были отклонены перед загрузкой, и дублирующихся исходных строк, которые получат одинаковый результат. Рецензент должен утвердить политику объединения для несовпадающих случаев до начала записи. Храните исходный CSV-файл и вспомогательный файл в соответствии с политикой доступа и хранения вашей организации, чтобы последующий аудит мог воспроизвести сопоставление.
Для каждого обновления CRM проверяйте, что контакт по-прежнему имеет тот же нормализованный номер. Если он изменился во время выполнения задачи, отметьте конфликт, а не перезаписывайте текущую запись устаревшим контекстом оператора. Дополнительная проверка версии записи может помочь интеграции клиента обеспечить соблюдение этого правила; это не является функцией CarrierLookup. Храните источник поиска и время наблюдения вместе с полями исходного выделения.
После пробного запуска проверьте повторяющийся номер, номер, исключенный во время подготовки, завершенный результат с пустыми полями и контакт, отредактированный во время выполнения задачи. Ожидаемыми результатами являются, соответственно, преднамеренное расширение «многие-к-одному», отсутствие выдуманного результата оператора, сохранение пустых значений и отложенный конфликт. Эта проверка направлена на реальный риск рабочего процесса с файлами: сопоставление технически корректного поиска с неверным контактом.
Если одна исходная строка содержит несколько полей телефона, записывайте, какое поле сгенерировало каждый подготовленный идентификатор. Основной контактный номер и дополнительный номер не должны получать взаимозаменяемые значения оператора. Вспомогательный файл может затем объяснить, почему завершенная строка CSV-файла обновила одно поле, но оставила другое нетронутым, даже если оба значения принадлежат одному и тому же лицу или записи компании.
Часто задаваемые вопросы
Должны ли команды объединять строки пакетного CSV-файла по позиции?
Нет. Используйте возвращенный идентификатор с кодом страны и локальное сопоставление вспомогательного файла с идентификаторами исходных строк; предварительная обработка может удалять строки.
Как следует обрабатывать дублирующиеся контакты с одним номером телефона?
Сохраняйте каждый идентификатор исходной строки во вспомогательном файле, отправляйте подготовленный идентификатор один раз, где это уместно, и преднамеренно сопоставляйте завершенный результат с каждой соответствующей строкой.
Что происходит с номером, исключенным во время подготовки?
Сохраняйте его в отчете об исключениях и не выдумывайте результат оператора для этой исходной строки.
Может ли CSV-файл показывать текущую сеть или местоположение контакта?
Нет. Он сообщает об исходном операторе и географии выделения диапазона номеров, которые не являются фактами о текущей сети или местоположении человека.
Узнать больше
Выберите информацию о продукте, которая соответствует следующему шагу в вашем рабочем процессе.