CRM интеграции
26 Отправка лида (все каналы)
Функция необходима для сбора лидов (заявок) ботом и отправки информации вам, настраивается на странице "Настройка сбора лидов".
Параметры, которые можно передать в функцию send_lead:

name - имя клиента. Указывает полное имя клиента.
phone - номер телефона клиента. Указывает контактный номер телефона.
email - E-mail клиента. Указывает адрес электронной почты клиента.
region - регион или город клиента. Указывает местоположение клиента.
url - адрес страницы на сайте. Указывает URL, с которого пришел клиент.
log - переписка с клиентом. Указывает всю переписку, связанную с клиентом.
subject - тема письма. Указывает название компании, в которую обращается клиент.
body - текст письма. Указывает все полученные контактные данные клиента и суть его запроса.
amo_pipeline_id - ID воронки в AmoCRM. Необязательный параметр.
amo_status_id - ID этапа воронки в AmoCRM. Необязательный параметр.
Примеры использования:

«Если клиент пришлёт тебе номер телефона, то сразу выполни функцию отправки лидов.»
(все остальные параметры заполняются в настройках бота во вкладке Лидогенерация)
55 Анализ аудиозаписей из Bitrix24 папки
Сначала функция обращается в папку на диске Bitrix24 и скачивает все новые .mp3 файлы за последние 10 минут. Далее она переводит все файлы в текст и проводит анализ диалогов. Результаты она записывает в таблицу Google.
Параметры, которые можно передать в функцию bitrix_mp3_to_sheet:

bitrix_webhook - URL вебхука Bitrix24, который используется для взаимодействия с API. Пример: bitrix_webhook: "https://example.com/webhook".
folder_id - идентификатор папки в Bitrix24, где хранятся аудиозаписи. Пример: folder_id: 123.
ID - идентификатор бота, который будет использоваться для анализа диалогов. Пример: ID: 456.
sheet_url - URL таблицы Google Sheets, куда будут загружены результаты анализа. Пример: sheet_url: "https://docs.google.com/spreadsheets/d/your_sheet_id".
api_token - токен API бота для анализа диалогов. Пример: api_token: "your_api_token".
time_interval - интервал для загрузки новых файлов в минутах. Пример: time_interval: 10.
Примеры использования:

"Запусти анализ аудио записей из папки с ID 123 в Bitrix24, используя вебхук https://example.com/webhook и загружай результаты в таблицу по ссылке https://docs.google.com/spreadsheets/d/your_sheet_id."

"Настрой бота с ID 456 для анализа новых файлов каждые 10 минут, используя токен API your_api_token."
100 Получение лида из Битрикс24
Функция запрашивает в Битрикс24 новый лид. Функция позволяет получить информацию о последнем лиде из системы Bitrix24, используя предоставленный вебхук.
Параметры, которые можно передать в функцию get_lead_from_bitrix24:

webhook - URL вебхука Bitrix24, который будет использоваться для получения информации о лидах.
Примеры использования:

"Получи информацию о последнем лиде из Bitrix24, используя вебхук https://example.bitrix24.ru/rest/1/your_webhook/."
132 Получение задачи из Bitrix24
Функция позволяет получить задачу из системы управления проектами Bitrix24, используя вебхук и ключевое слово для поиска задачи по названию.
Параметры, которые можно передать в функцию bitrix_get_task:

bitrix_webhook - URL вебхука Bitrix24, который используется для доступа к API.
keyword - ключевое слово в названии задачи, по которому будет производиться поиск.
Примеры использования:

"Получите задачу из Bitrix24 по вебхуку 'https://example.bitrix24.ru/rest/1/your_webhook_key/task.item.get.json' с ключевым словом 'Отчет'."

"Пожалуйста, найди задачу с ключевым словом 'Разработка' по вебхуку 'https://example.bitrix24.ru/rest/1/your_webhook_key/task.item.get.json'."
133 Завершение задачи в Bitrix24
Функция позволяет завершить задачу в системе управления проектами Bitrix24, используя вебхук, ID задачи и текст с результатом выполнения.
Параметры, которые можно передать в функцию bitrix_end_task:

bitrix_webhook - URL вебхука Bitrix24, который используется для доступа к API.
ID - ID задачи в Bitrix24, которую необходимо завершить.
task_result - текст с результатом выполнения задачи.
Примеры использования:
"Заверши задачу с ID 123 в Bitrix24 по вебхуку 'https://example.bitrix24.ru/rest/1/your_webhook_key/task.item.update.json' с результатом 'Задача выполнена успешно'."

"Пожалуйста, отметь задачу с ID 456 как завершенную, используя вебхук 'https://example.bitrix24.ru/rest/1/your_webhook_key/task.item.update.json' и добавь результат 'Все требования выполнены'."
135 Отправить лид в Битрикс24
Функция позволяет отправить лид потенциального клиента в Bitrix24, используя вебхук и информацию о клиенте, такую как имя, номер телефона и адрес электронной почты.
Параметры, которые можно передать в функцию send_lead_bitrix24:

bitrix_webhook - вебхук Bitrix24, который используется для доступа к API.
name - имя клиента.
phone - номер телефона клиента.
email - E-mail клиента.
Примеры использования:

"Отправь лида в Bitrix24 по вебхуку 'https://example.bitrix24.ru/rest/1/your_webhook_key/crm.lead.add.json' с именем 'Иван Иванов', телефоном '+79991234567' и email 'ivan@example.com'."

"Добавь нового клиента в Bitrix24 с вебхуком 'https://example.bitrix24.ru/rest/1/your_webhook_key/crm.lead.add.json', именем 'Анна Петрова', телефоном '+79999876543' и email 'anna@example.com'."
211 Создать запись в сервисе YClients
Функция позволяет записать клиента на прием в компанию, использующую систему YClients. Это может быть полезно для автоматизации процесса записи клиентов на услуги.
Параметры, которые можно передать в функцию yclients_book_appointment:

company_id - ID компании в YClients. Указывает уникальный идентификатор компании, к которой осуществляется запись.
api_token - API токен для доступа к YClients. Указывает ключ, необходимый для аутентификации при запросе.
user_token - токен пользователя для доступа к YClients. Указывает токен, связанный с конкретным пользователем.
client_info - информация о клиенте в формате 'телефон;имя;email'.
staff_id - ID сотрудника, к которому записывается клиент. Указывает уникальный идентификатор сотрудника.
service_ids - ID услуг, разделенные точкой с запятой. Указывает, какие услуги выбирает клиент.
datetime - дата и время записи в формате ISO 8601. Пример: "2024-12-14T10:00:00+03:00".
seance_length - длительность сеанса в минутах. Указывает, сколько времени займет запись.
Примеры использования:

Вы - Диана, опытный администратор центра Подологии, специализирующийся на уходе за стопами и ногтями. Наш центр оказывает высококвалифицированные услуги по медицинскому педикюру и лечению различных заболеваний ногтей. У вас дружелюбный, заботливый, доброжелательный и позитивный характер.

Используй в общении смайлы: 🏙️,✍,😇,🙏🏻,🌿 .
Если клиент прислал тебе голосовое сообщение, запрещено в ответ присылать ему голосовое сообщение. Не присылай в ответ голосовые сообщения и любые аудио файлы!
Выделение важной информации:
- Включай жирный шрифт для важных деталей, таких как стоимость и бонусы.
Запрещено писать чтобы клиент подождал.

Твоя задача создавать записи клиентов на сеансы в наш салон красоты.

Номера услуг:
1340XXX - ПараМедицинский МАНИКЮР (seance_length - 2часа)
...

Номера специалистов:
3276XXXX - Милана (подолог)
...

Используй эти данные для записи клиентов:
АПИ токен: "XXXXXXXXXXXXX"
Токен пользователя: "XXXXXXXXXXXXXXXXXXXXXX"
Номер компании: 309XXX

Емайл у всех клиентов передавай такой: api@email.com
215 Получение текущих записей по номеру телефона клиента в сервисе YClients
Функция позволяет получить записи клиента в системе YClients по указанному номеру телефона. Это может быть полезно для просмотра истории записей клиента и управления ими.
Параметры, которые можно передать в функцию yclients_client_appointments:

company_id - ID компании в YClients. Указывает уникальный идентификатор компании, для которой нужно получить записи клиента.
api_token - API токен для доступа к YClients. Указывает ключ, необходимый для аутентификации при запросе.
user_token - токен пользователя для доступа к YClients. Указывает токен, связанный с конкретным пользователем.
client_phone - номер телефона клиента. Указывает номер телефона, по которому нужно найти записи.
Примеры использования:

Используй эти данные для записи клиентов:
АПИ токен: "XXXXXXXXXXXXX"
Токен пользователя: "XXXXXXXXXXXXXXXXXXXXXX"
Номер компании: 309XXX

216 Удаление записей клиента в сервисе YClients
Функция позволяет удалить записи клиента в системе YClients по указанному списку ID записей. Это может быть полезно для управления записями клиентов и удаления ненужных или ошибочных записей.
Параметры, которые можно передать в функцию yclients_delete_client_appointments:

company_id - ID компании в YClients. Указывает уникальный идентификатор компании, для которой нужно удалить записи.
api_token - API токен для доступа к YClients. Указывает ключ, необходимый для аутентификации при запросе.
user_token - токен пользователя для доступа к YClients. Указывает токен, связанный с конкретным пользователем.
record_ids - ID записей, которые нужно удалить, разделенные точкой с запятой.
Примеры использования:

Используй эти данные для записи клиентов:
АПИ токен: "XXXXXXXXXXXXX"
Токен пользователя: "XXXXXXXXXXXXXXXXXXXXXX"
Номер компании: 309XXX
Номера записей: 914XXXXX; 9144XXXX
228 Yclients: Получить полный список данных о клиенте по номеру телефона
Функция позволяет получить полный список данных о клиенте в системе YClients по указанному номеру телефона. Это может быть полезно для получения информации о клиенте, его записях и истории взаимодействия.
Параметры, которые можно передать в функцию yclients_get_client_data_by_phone:

company_id - ID компании. Указывает уникальный идентификатор компании, для которой нужно получить данные о клиенте.
phone - номер телефона клиента. Указывает номер телефона, по которому нужно найти данные о клиенте.
api_key - bearer api_key. Указывает ключ, необходимый для аутентификации при запросе. Пример: "Bearer abcdef1234567890".
Примеры использования:

"Покажи данные клиента с номером телефона 89001234567 в компании с ID 12345."
229 Yclients: Получить график сотрудника на указанные даты
Функция позволяет получить график работы сотрудника в системе YClients на указанные даты. Это может быть полезно для планирования встреч и управления расписанием сотрудников.
Параметры, которые можно передать в функцию yclients_get_employee_schedule:

start_date - дата начала в формате YYYY-MM-DD. Указывает дату, с которой начинается запрашиваемый график.
end_date - дата окончания в формате YYYY-MM-DD. Указывает дату, до которой продолжается запрашиваемый график.
api_key - bearer api_key. Указывает ключ, необходимый для аутентификации при запросе. Пример: "Bearer abcdef1234567890".
company_id - ID компании. Указывает уникальный идентификатор компании, для которой нужно получить график сотрудника.
api_key_user - токен пользователя для доступа к YClients. Указывает токен, связанный с конкретным пользователем.
Примеры использования:

"Покажи график сотрудника с 2023-10-01 по 2023-10-31 в компании с ID 12345."

"Получи расписание сотрудника на даты с 2023-10-01 по 2023-10-15, используя API ключ Bearer abcdef1234567890."
230 Yclients: Получить список сотрудников и их услуг по ID компании
Функция позволяет получить список сотрудников компании в системе YClients вместе с услугами, которые они предоставляют. Это может быть полезно для управления ресурсами и планирования работы.
Параметры, которые можно передать в функцию yclients_get_staff_list_with_services:

api_key - API ключ для доступа к Yclients. Указывает ключ, необходимый для аутентификации при запросе.
company_id - ID компании в Yclients. Указывает уникальный идентификатор компании, для которой нужно получить список сотрудников.
api_key_user - API ключ пользователя для доступа к Yclients. Указывает токен, связанный с конкретным пользователем.
Примеры использования:

"Покажи список сотрудников и их услуг для компании с ID 12345."

"Получи информацию о сотрудниках и предоставляемых ими услугах, используя API ключ abcdef1234567890."

231 Yclients: Запись на услугу с указанием даты и времени
Функция позволяет записать клиента на услугу в системе YClients, указав номер телефона, код для аутентификации, а также дату и время записи. Это может быть полезно для управления записями клиентов и планирования услуг.
Параметры, которые можно передать в функцию yclients_book_record:

phone - номер телефона для записи. Указывает номер телефона клиента, который будет записан на услугу.
code - код для аутентификации. Указывает код, необходимый для подтверждения записи.
datetime - дата и время записи в формате ISO 8601. Указывает, когда должна состояться запись. Пример: "2023-10-01T10:00:00Z".
api_key - API ключ для авторизации. Указывает ключ, необходимый для аутентификации при запросе.
api_key_user - пользовательский API ключ для авторизации. Указывает токен, связанный с конкретным пользователем.
Примеры использования:

"Запиши клиента с номером телефона 89001234567 на услугу 1 октября 2023 года в 10:00, используя код 123456."

"Выполни запись на услугу для клиента с телефоном 89001234567 на 2023-10-01T10:00:00Z, используя API ключ abcdef1234567890."
237 Получить данные из определенной сделки из Битрикс
Функция позволяет получать данные из указанной сделки в системе Битрикс. Функция работает при заполненном вебхуке Битрикс24 в разделе "Лидогенерация". Для получения данных о сделке в функцию нужно передать ID сделки, который можно найти на странице Интеграции личного кабинета ProTalk в под полем, куда вы сохраните вебхук из Битрикса.
Параметры, которые можно передать в функцию bitrix_get_dial_fields:

deal_id - ID сделки. Это строка, представляющая уникальный идентификатор сделки, данные которой вы хотите получить.
Примеры использования:

"Пожалуйста, получи данные из сделки с ID '12345'."
238 Получить данные из определенной сделки из AmoCRM
Функция работает при заполненном вебхуке AmoCRM в разделе "Лидогенерация". Функция позволяет получить информацию о конкретной сделке в системе AmoCRM, указав уникальный идентификатор сделки. Это может быть полезно для анализа и управления сделками.
Параметры, которые можно передать в функцию amocrm_get_lead:

lead_id - ID сделки, данные которой нужно получить. Указывает уникальный идентификатор сделки в AmoCRM.
Примеры использования:

"Покажи данные о сделке с ID 12345."
"Получи информацию о сделке с идентификатором 67890."
252 Прикрепить файл к задаче в Bitrix24
Функция позволяет прикрепить файл к задаче в Bitrix24, указав вебхук для доступа к API, ID задачи, ID папки и URL файла. Это может быть полезно для управления задачами и документами в системе Bitrix24.
Параметры, которые можно передать в функцию bitrix24_attach_file_to_task:

bitrix24_webhook - вебхук для доступа к API Bitrix24. Указывает URL, необходимый для аутентификации при запросе.
task_id - ID задачи, к которой нужно прикрепить файл. Указывает уникальный идентификатор задачи.
folder_id - ID папки, в которой находится задача. Указывает уникальный идентификатор папки.
file_url - URL файла, который нужно прикрепить. Указывает ссылку на файл, который будет добавлен к задаче.
Примеры использования:

Прикрепи файл к задаче в Битрикс24: https://minio.nplus1.ru/app-images/152754/30c1c568a1e8e538911c6f8d02ca69f2.jpg
Номер задачи: 122
ID папки: 1
Webhook Битрикс24: "https://COMPANY.bitrix24.ru/rest/1/b7zwgdXXXXXXXX"
258 Изменить стадию сделки в Битрикс24
Функция предназначена для обновления стадии сделки в системе Битрикс24. Она принимает три параметра: deal_id (идентификатор сделки), stage_id (идентификатор новой стадии) и webhook_url (URL вебхука для отправки запроса). Это может быть полезно для управления процессом продаж и отслеживания статуса сделок.
Параметры, которые можно передать в функцию bitrix_update_deal_stage:

deal_id - ID сделки. Указывает уникальный идентификатор сделки, стадию которой нужно обновить.
stage_id - ID новой стадии. Указывает уникальный идентификатор стадии, на которую нужно перевести сделку. Пример: "WON" или "CANCELED". Информацию ищите в разделе “Интеграции” там, где вы сохранили вебхук от Битрикс24.
webhook_url - URL вебхука Битрикс24. Указывает адрес, необходимый для аутентификации при запросе.
Примеры использования:

"Обнови стадию сделки с ID '12345' на 'WON' с использованием вебхука 'https://yourdomain.bitrix24.ru/rest/1/abcdef12345678/'."
264 Создание записи в системе yclients
Функция позволяет записывать клиентов на прием в систему YClients через API. Это может быть полезно для автоматизации процесса записи клиентов на услуги.
Параметры, которые можно передать в функцию yclients_create_record:

company_id - ID компании в YClients. Это целое число, представляющее уникальный идентификатор компании.
api_token - API токен для доступа к YClients. Это строка, необходимая для аутентификации при работе с API.
api_key_user - API ключ пользователя для доступа к YClients. Это строка, необходимая для аутентификации пользователя.
client - информация о клиенте в формате 'телефон;имя;email'. Это строка, содержащая контактные данные клиента.
staff_id - ID сотрудника, к которому записывается клиент. Это целое число, представляющее уникальный идентификатор сотрудника.
services - ID услуг, разделенные точкой с запятой. Это строка, содержащая идентификаторы услуг, которые клиент хочет получить.
datetime - дата и время записи в формате ISO 8601: 2024-11-26T09:00:00+10:00. Это строка, представляющая дату и время записи.
seance_length - длительность сеанса в секундах. Это целое число, указывающее, сколько времени займет сеанс.
comment - комментарий к записи. По умолчанию равен "-". Это строка, содержащая дополнительные заметки о записи.
attendance - статус посещения, по умолчанию = 0. Это целое число, указывающее, был ли клиент на приеме.
send_sms - отправить SMS уведомление, по умолчанию = true. Это булевый параметр, указывающий, нужно ли отправлять SMS уведомление клиенту.
save_if_busy - сохранять запись, если время занято, по умолчанию = false. Это булевый параметр, указывающий, нужно ли сохранять запись, если выбранное время уже занято.
Примеры использования:

"Запиши клиента с номером телефона '1234567890', именем 'Иван Иванов' и email 'ivan@example.com' на прием к сотруднику с ID 1 на 2024-11-26T09:00:00+10:00."

"Запиши клиента на прием к сотруднику 3 с услугами 1;2 и отправь SMS уведомление."
271 Получить расписание сотрудников и свободные интервалы в системе yclients
Функция позволяет получать расписание сотрудников и свободные интервалы для записи клиентов в компании через API YClients. Это может быть полезно для планирования встреч и управления временем сотрудников.
Параметры, которые можно передать в функцию yclients_get_employee_schedule:

start_date - дата начала периода. Это строка в формате даты например, "2024-11-01" , указывающая, с какого дня начинается запрос расписания.
end_date - дата окончания периода. Это строка в формате даты например, "2024-11-30" , указывающая, до какого дня нужно получить расписание.
company_id - ID компании. Это целое число, представляющее уникальный идентификатор компании в системе YClients.
api_key - API ключ для доступа. Это строка, необходимая для аутентификации при работе с API.
api_key_user - API ключ пользователя. Это строка, необходимая для аутентификации пользователя, который запрашивает расписание.
Примеры использования:

"Получи расписание сотрудников с 2024-11-01 по 2024-11-30 для компании с ID 123."
"Мне нужно узнать свободные интервалы для записи клиентов в компании с ID 456 на период с 2024-11-10 по 2024-11-20."
274 Передача данных в комментарий к сделке Битрикс24
Функция добавляет комментарий в таймлайн к конкретной сделке в Bitrix24. Бот должен знать номер сделки, чтобы эта функция сработала. Это может быть полезно для ведения истории взаимодействия с клиентами и отслеживания изменений в сделках.
Параметры, которые можно передать в функцию bitrix_add_comment_to_deal:

deal_id - ID сделки. Указывает уникальный идентификатор сделки, к которой будет добавлен комментарий.
comment_text - текст комментария. Указывает содержание комментария, который вы хотите добавить.
webhook_url - URL вебхука Битрикс24. Указывает адрес, на который будет отправлен запрос для добавления комментария.
Примеры использования:

"Как только ты получишь информацию об оплате, то сразу выполни функцию передачи данных в комментарий к сделке Битрикс24, передав в качестве параметра comment саммари всего диалога с клиентом".
278 Add client to Salebot CRM
Функция позволяет добавлять клиентов в систему управления взаимоотношениями с клиентами CRM salebot. Это полезно для автоматизации работы с клиентами и улучшения взаимодействия с ними.
Параметры, которые можно передать в функцию salebot_add_client_to_crm:

platform_id - ID клиента в мессенджере. Указывает уникальный идентификатор клиента в мессенджере, например, Telegram.
group_id - ID мессенджера клиента. Указывает идентификатор мессенджера, в котором находится клиент.
client_type - тип клиента. Указывает тип клиента, который нужно добавить. Это целое число, подробнее можно узнать в документации salebot.
token - токен доступа к salebot. Указывает токен, необходимый для авторизации в системе.
Примеры использования:

"Добавь клиента с ID 123456789 в мессенджере Telegram с типом клиента 1 и токеном доступа 987654321."
Задайте нам вопрос
Укажите ваше имя, тему вопроса
Отправить сообщение
Мы ответим на все ваши вопросы и поможем с настройкой бота