enПодготовка XLSX/CSV файла к импорту в Leeloo.ai

Owned by Customer Service
May 01, 2024
3 min read

Данная инструкция предоставляет пошаговое руководство по импорту данных в платформу Leeloo.ai , с использованием таблиц Excel (XLSX) или файлов CSV. Эта инструкция поможет вам понять, как правильно подготовить файлы для импорта и какие требования следует соблюдать.

 

Инструкция предоставляет рекомендации, о порядке столбцов в таблице, максимальном количестве встроенных и пользовательских полей, а также о том, как правильно обновлять данные при повторном импорте.

Будьте внимательны к требованиям к названиям полей, так как они важны для правильного сопоставления данных в платформе Leeloo.ai . Также обратите внимание на типы данных, чтобы убедиться, что ваши данные соответствуют этим требованиям.

 

Пример документа для импорта Вы можете найти по ссылке: exported 03.12 13.28.27.xlsx

 

 

Пошаговая инструкция:

 

  1. Убедитесь, что файл имеет одно из следующих расширений: XLSX или CSV.

 

 

  1. Называйте поля (столбцы) в таблице импорта на латинице. Поле может содержать любую комбинацию следующих символов:

  • Заглавные латинские буквы A-Z.

  • Строчные латинские буквы a-z.

  • Нижнее подчеркивание "_".

 

 

 

 

   Примеры допустимых названий полей:

  • custom_field

  • CUSTOMfield

  • customField

  • CustomField

  • custom_Field

  • c_Us__tom_F___

 

 

   Важно: Зарезервированные встроенные поля должны иметь следующие названия и не могут быть изменены: social_id, name, email, phone.

 

   Например, "Social ID", "socialID", "соціальний айді" и "сошиал ID" не являются допустимыми названиями для поля social_id и будут проигнорированы.

 

  1. Порядок столбцов в таблице не имеет значения, но рекомендуется размещать обязательные поля в начале таблицы (слева).

  1. В таблице должно быть не более 4 встроенных полей (social_id, name, email, phone) и не более 20 пользовательских полей.

 

  1. Если обязательные поля (social_id и name) находятся за пределами первых 20 полей в файле, импорт не будет выполнен. Если обязательные поля находятся в пределах первых 20 полей, то порядок не имеет значения.

 

  1. При загрузке файла привязка к туннелю необязательна, но привязка к каналу связи (боту) обязательна.

 

  1. При импорте файла, ранее экспортированного из Leeloo, произойдет обновление данных в измененных полях, если такие изменения были.

 

   Важно: При экспорте записей из Leeloo, поле social_id отсутствует в результирующем файле. Если вы используете такой файл для импорта записей, в котором внесены изменения или добавлены данные, файл не будет действительным, так как отсутствует поле social_id.

 

   Решение: Добавьте поле social_id к каждой записи. Значение поля social_id должно быть уникальным.

 

  1. Импорт будет выполняться, даже если в таблице импорта отсутствуют данные для полей e-mail и телефон.

 

  1. Встроенные поля:

  • social_id: число/строка, должно быть уникальным. Число должно находиться в диапазоне от -9007199254740991 до 9007199254740991. Строка должна содержать от 1 до 255 символов.

  • name: строка, должна содержать от 1 до 255 символов.

  • email: строка, должна быть действительным адресом электронной почты.

  • phone: число/строка, должно быть действительным номером телефона.

 

10. Пользовательские поля:

  • Количество пользовательских полей не должно превышать 20.

  • Кастомные (пользовательские) поля могут иметь следующие типы:

  • phrase/выражение: строка, должна содержать от 1 до 255 символов.

  • number: число/строка, число должно находиться в диапазоне от -9007199254740991 до 9007199254740991.

  • phone: число/строка, должно быть действительным номером телефона.

  • email: строка, должна быть действительным адресом электронной почты.

  • date: строка, должна быть действительной датой в формате YYYY-MM-DD или YYYY/MM/DD.

 

11. Название пользовательского поля в файле должно быть таким же, как "Variable name" (имя переменной) указанное при создании этого поля.