Работа с диалогами и ботами
39 Задать вопрос человеку по телефону
Функция позволяет задать вопрос по телефону, используя интеграцию с voximplant и указанные параметры для настройки диалога с AI. Вы можете указать идентификатор сотрудника, API ключ, номер телефона и другие настройки.
Параметры, которые можно передать в функцию ask_question_by_phone:

employee_id - идентификатор сотрудника. Это целое число, которое указывает на конкретного сотрудника.
voxapikeys_url - URL файла с API ключом.
rule_id - идентификатор правила. Это целое число, которое указывает на правило, по которому будет происходить взаимодействие.
phone - номер телефона, начинающийся с кода страны без пробелов, только цифры.
role - AI подсказка для управления диалогом.
hello_text - приветствие на русском языке.
voice - имя голоса. Доступные варианты: "Rachel" женский голос или "Thomas" мужской голос .
report_chat_id - укажите '#' если не указано.
report_promt_id - укажите '#' если не указано.
Примеры использования:

"Пожалуйста, позвони на номер 79001234567 и задай вопрос, используя голос Thomas и приветствие 'Добрый день!'"
58 Диалог с одного бота с другим
Функция позволяет организовать диалог с ИИ-сотрудником, используя указанные параметры для настройки взаимодействия. Вы можете указать идентификатор бота-сотрудника, описание задачи и автоматические ответы.
Параметры, которые можно передать в функцию employee_dialog:

employee_id - идентификатор сотрудника. Это целое число, которое указывает на конкретного сотрудника.
task - описание задачи. Это строка, которая описывает задачу, которую должен выполнить сотрудник.
human_auto_answers - список автоматических ответов сотруднику. Каждый ответ должен быть с новой строки.
Примеры использования:

"Начни диалог с ИИ-сотрудником с ID 12345 по задаче 'Подготовить отчет по продажам' и автоматическими ответами:
Сформируй отчет
Сделай его еще детальнее
Оформи его лучше"
101 Запуск исходящего диалога (для автоматизации)
Функция запустит диалог нужного Вам нейро-сотрудника с клиентом в канале WhatsApp или Telegram по определённому триггеру или отложенному таймеру.
Параметры, которые можно передать в функцию run_external_dialog:

employee_id - ID нейро-сотрудника, который будет вести диалог.
token - токен нейро-сотрудника, необходимый для аутентификации.
client - номер телефона клиента или его никнейм в Telegram. Этот параметр может быть пустым.
hello - текст приветствия для клиента от нейро-сотрудника.
Примеры использования:

"Запусти диалог с клиентом @client_nickname, используя ID нейро-сотрудника 123 и токен abc123xyz. Приветствие: 'Здравствуйте! Как я могу помочь вам сегодня?'."
155 Активация бота для отдельного пользователя в отдельном канале
Функция позволяет активировать бота для отдельного пользователя в указанном канале. Это может быть полезно для отправки уведомлений или сообщений пользователю через выбранный мессенджер.
Параметры, которые можно передать в функцию activate_task:

job_id - номер бота, который будет активирован.
channel - канал, через который будет активирована задача. Доступные варианты:
"Telegram Bot"
"Telegram"
"WhatsApp"
user_chat_id - идентификатор пользователя, которому будет отправлено сообщение.
hello_text - текст приветствия, который будет отправлен пользователю. Может быть пустым.
Примеры использования:

"Активируй бота с номером 123 в канале Telegram для пользователя с идентификатором 123456789 и отправь текст приветствия: 'Добро пожаловать в наш бот!'."

"Активируй бота 456 в WhatsApp для пользователя с ID 987654321 без приветственного текста."
164 Подключение функции к диалогу

Функция позволяет добавлять новую функцию в диалог, основываясь на предоставленном запросе. Вы можете использовать эту функцию для расширения возможностей диалога с ботом.
Параметры, которые можно передать в функцию add_function_in_dialog:

query - запрос для поиска функции.
Примеры использования:

"Пожалуйста, добавь функцию 'Генерация изображений с использованием Midjourney'."
165 Отправить сообщение в диалог
Функция позволяет отправлять сообщения в диалог, определяя роль отправителя и другие параметры, такие как необходимость ответа от бота и добавление сообщения в контекст диалога.
Параметры, которые можно передать в функцию send_message_in_dialog:

role - с какой стороны будет сообщение. Возможные значения: "user", по умолчанию "assistant"
bot_reply - 1 - требуется ответ от бота, 0 - не требуется ответ. По умолчанию 0.
add_in_messages - 1 - добавить данное сообщение в контекст диалога, 0 - не добавлять в контекст диалога. По умолчанию 1.
message - текст сообщения.
temperature - креативность ответа бота. Целое число от 1 до 10. По умолчанию 0. from_chat_id - ID чата, куда отправить сообщение. Необязательный параметр.
limit - максимальная длина сообщения, по умолчанию 4000 символов.
Примеры использования:

"Отправь сообщение от пользователя: 'Привет, как ты?' с требованием ответа от бота и добавлением в контекст диалога."

"Пожалуйста, отправь сообщение от ассистента: 'Как я могу помочь?' без необходимости ответа от бота и с максимальной длиной 3000 символов."
172 Создание напоминаний от бота
Функция позволяет отправить отложенное сообщение от бота в текущем диалоге. Это может быть полезно для автоматизации взаимодействия с пользователями, например, для напоминаний или уведомлений. В одном диалоге можно сделать неограниченное количество напоминаний.
Параметры, которые можно передать в функцию bot_scheduled_message:

activation_datetime - дата и время отправки сообщения в формате %Y-%m-%dT%H:%M:%S.%fZ.
message - текст сообщения от бота.
Примеры использования в тексте запроса:

"Напомни мне в пятницу 13 октября в 18:00 о том, что я должен быть дома."

При общении клиент может боту сказать:

"я занят, напиши мне завтра после обеда" и бот с ним свяжется в указанное время.
177 Задать вопрос боту
Функция позволяет отправить вопрос или сообщение конкретному сотруднику. Вы можете указать ID сотрудника, его токен и текст сообщения.
Параметры, которые можно передать в функцию ask_emploee:

emploee_id - ID сотрудника, которому вы хотите задать вопрос.
token - токен сотрудника, необходимый для аутентификации.
message - вопрос или сообщение, которое вы хотите отправить сотруднику.
Примеры использования:

"Пожалуйста, отправь вопрос сотруднику с ID 123 и токеном abc123xyz: 'Создай картинку с морем'"
185 Омниканальный запрос (текст+фото)
Функция позволяет задать вопрос к OpenAI API, передавая одновременно текстовую информацию и изображения. Вы можете указать модель AI, текст, URL изображений и сам вопрос.
Параметры, которые можно передать в функцию openai_question_omni:

ai_model - модель OpenAI для обработки запроса. Доступные варианты: "gpt-4o-mini", "gpt-4o-2024-08-06". По умолчанию используется "gpt-4o-mini".
text - текстовая информация, которую вы хотите передать.
images_urls - URLs изображений, разделенные точкой с запятой.
question - вопрос, который нужно задать на основе текста и изображений.
Примеры использования:

"Пожалуйста, задай вопрос к OpenAI API с моделью gpt-4o-mini, текстом 'Это пример текста для анализа.', изображениями 'https://example.com/image1.jpg;https://example.com/image2.jpg' и вопросом 'Какое изображение лучше всего соответствует этому тексту?'."

"Используй модель gpt-4o-2024-08-06, текст 'Анализируй эти изображения', с URL изображений 'https://example.com/image1.jpg;https://example.com/image2.jpg' и задай вопрос 'Что изображено на этих картинках?'."
186 Диалог с ботом v2
Функция позволяет задать одно или несколько сообщений конкретному сотруднику. Вы можете указать ID сотрудника, его токен и текст сообщений.
Параметры, которые можно передать в функцию dialog_with_emploee:

emploee_id - ID сотрудника, которому вы хотите задать вопросы.
token - токен сотрудника, необходимый для аутентификации.
messages - одно или несколько сообщений, разделенных символами ##.
Примеры использования:

"Отправь сообщения сотруднику с ID 123 и токеном abc123xyz: 'Как дела?##Когда будет готов отчет?'"
206 Добавить роль в диалог
Функция позволяет добавить новую роль в текущий диалог, задав имя роли и текст роли. Вы также можете указать ID функций, если это необходимо.
Параметры, которые можно передать в функцию add_role_in_dialog:

name - имя роли, которую вы хотите добавить.
role - текст роли, который будет описывать её функции.
functions_ids - ID функций, которые связаны с этой ролью, указанные через запятую. Этот параметр не является обязательным.
Примеры использования:

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

"Добавь роль 'Аналитик' с описанием 'Анализирует данные и предоставляет отчеты', а также ID функций '4,5'."
262 Запуск исходящего диалога
Функция позволяет активировать бота для конкретного пользователя в заданном канале, указав номер бота, имя пользователя, телефон, текст приветствия и задачу диалога. Например, запускает исходящий диалог бота с пользователем в каналах Телеграмм и WhatsApp.
Параметры, которые можно передать в функцию activate_dialog_with_chatid:

job_id - номер бота. Указывает уникальный идентификатор бота, который будет активирован.
name - имя или ник в Telegram. Указывает, как будет идентифицироваться пользователь.
phone - телефон пользователя. Указывает контактный номер телефона для связи.
hello_text - текст приветствия. Может быть пустым. Указывает сообщение, которое будет отправлено пользователю при активации.
task - задача диалога. Указывает, какая задача будет выполняться в рамках диалога.
Примеры использования:

Запусти бота 11620 на телефон 7912XXXXXXX с приветственным сообщением: "Привет! Как дела?" и задача диалога: "Выясни будет ли встреча вечером"

или по нику в Телеграмм:

Запусти бота 11620 на ник в Телеграм "NICXXX" с приветственным сообщением: "Привет! Как дела?" и задача диалога: "Выясни будет ли встреча вечером"
Задайте нам вопрос
Укажите ваше имя, тему вопроса
Отправить сообщение
Мы ответим на все ваши вопросы и поможем с настройкой бота