Перейти к основному контенту

bot.findLeads()

Получить лиды по атрибутам

bot.findLeads($columns = [], $where = [], $orderBy = [], ?int $limit = null, ?int $offset = null)
Описание:

Находит лида по указанным атрибутам и другим данным.

Атрибуты:
Имя Тип Описание
columns array Возвращаемые поля лидов, по умолчанию все поля. Вы можете вывести дополнительные поля: status_name, channel_name, channel_code
where array

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

orderBy array Массив сортировки возвращаемых значений. Подробнее читайте здесь.
limit int Максимальное число возвращаемых лидов. Можно вернуть диапазон от 1 до 100
offset int Числовое значение, указывающее количество записей, которые необходимо пропустить от начала результата выборки перед возвратом данных. Этот параметр используется для пагинации. Например, если limit установлен на 100, а offset равен 100, то будут возвращены записи, начиная со 101-го лида.
Возвращает:

array - массив полей лидов.

В массиве следующие поля:

 
  • id - id лида
  • identification - внешний id лида
  • manager_id - id менеджера привязанного к лиду
  • bot_id - id бота лида
  • channel_id - id канала лида
  • status_id - id статуса лида
  • is_mute - включен ли бот для лида
Пример:
let leads = bot.findLeads(
    [],
    [
     ['lead_attributes.attribute_type', 'variable'],
     ['lead_attributes.attribute_key', 'nlpLastIntentName'],
     ['lead_attributes.attribute_value', 'позвать_человека'],
    ],
    [['updated_at']]
);

if (leads.length) {
    let statusName = leads[0].getData('id');
}

или получаем поля для первого найденного лида (без условий):

let leads = bot.findLeads(['status_name', 'channel_name', 'channel_code']);
if (leads.length) {
    let statusName = leads[0].getData('status_name');
    let channelName = leads[0].getData('channel_name');
    let channelCode = leads[0].getData('channel_code');
}