Интеграции с веб-сервисами
Функция ищет по запросу вакансии на сайте HH.ru.
Параметры, которые можно передать в функцию hh_vacancies:

search_filter - поисковый фильтр, который определяет ключевые слова для поиска вакансий. Пример: search_filter: "программист".
region_id - идентификатор города или региона, в котором будет производиться поиск вакансий. Пример: region_id: 1. ID Москвы = 1, Санкт-Петербург = 2, Новосибирск = 4, Иркутск = 35
period - период в днях, за который появились вакансии. Пример: period: 7 для поиска вакансий, опубликованных за последние 7 дней .
Примеры использования:

"Пожалуйста, найди вакансии по фильтру 'программист' в регионе с ID 2 за последние 7 дней."

"Ищи вакансии для 'маркетолога' в регионе с ID 1, опубликованные за последние 14 дней."
Данная функция может быть использована для вызова любого внешнего API. Бот помощник формирования примеров для API запросов: t.me/protalk_bot (в меню ищите “Разработчик интеграций через API”)
Параметры, которые можно передать в функцию call_api:

url - URL API, к которому будет выполнен запрос. Пример: url: "https://api.example.com/v1/resource".
method - HTTP метод, который будет использоваться для запроса. Доступные варианты: "GET", "POST", "PUT", "DELETE". Пример: method: "POST".
headers - заголовки запроса в формате JSON. Пример: headers: '{"Authorization": "Bearer token"}'.
params - параметры запроса в формате JSON. Пример: params: '{"search": "query"}'.
data - данные для отправки в запросе в формате JSON. Пример: data: '{"key": "value"}'.
json - данные для отправки в формате JSON. Пример: json: '{"name": "example"}'.
file_url - URL файла для загрузки. Пример: file_url: "https://example.com/file.txt".
timeout - таймаут запроса в секундах. Пример: timeout: 30.
Вот пример вызова функции для отправки сообщения через Telegram-бот:

Получи текст сообщения, токен бота у пользователя и ID пользователя в Telegram и вызови функцию `call_external_api` с параметрами:
{
"url": f'https://api.telegram.org/bot{bot_token}/sendMessage',
"method": "POST",
"data": {
"chat_id": user_id,
"text": "_ТЕКСТ_СООБЩЕНИЯ_"
}
}
Функция позволяет проверить компанию по ее ОГРН или ИНН, используя данные ФНС России. В зависимости от ответа функции, вы получите информацию о репутации компании.
Параметры, которые можно передать в функцию check_company_fns:

req - ОГРН или ИНН компании, которую нужно проверить.
key - ваш ключ доступа к API для выполнения запроса.

Функция возвращает:
- Если в ответе функции содержится слово "Позитив", то ответ будет: "Положительная репутация".
- В противном случае ответ будет: "Отрицательная репутация".
Примеры использования:

"Пожалуйста, проверь компанию с ИНН 1234567890 и дай знать о ее репутации."
Позволяет передать данные от ИИ ассистента в сервис Альбато.
Параметры, которые можно передать в функцию interact_with_albato:

data - данные для передачи в Albato. Это строка, содержащая информацию, которую необходимо отправить. Пример: '{"key": "value", "action": "update"}'.
webhook_url - URL веб-хука Albato. Это строка, указывающая на адрес веб-хука, на который будут отправлены данные.
Примеры использования:

"Отправь данные '{"key": "value", "action": "update"}' на веб-хук 'https://example.com/webhook'."
Функция получаем статистику по рекламной кампании. Для работы функции необходимо создать приложение по ссылке: https://direct.yandex.ru/registered/main.pl?cmd=apiCertificationRequestList и предоставить полный доступ к управлению вашими рекламными кампаниями. После регистрации приложения используйте эту ссылку для получения токена: https://oauth.yandex.ru/authorize?response_type=token&client_id=client_id_вашего_приложения.
Параметры, которые можно передать в функцию get_yandex_direct_stats:

token - токен API Yandex.Direct, необходимый для аутентификации.
login - логин аккаунта Yandex.Direct. Этот параметр не является обязательным.
days - количество дней, на которое нужно вернуться в истории.
Примеры использования:

"Получи статистику Yandex.Direct за последние 14 дней. Логин: your_login, токен: your_yandex_direct_token."
Функция позволяет публиковать пост в Instagram, используя изображение и текст подписи. Вы можете указать URL изображения, текст подписи, токен доступа и ID бизнес-аккаунта.

Для функции требуется:

1. Бизнес-аккаунт Instagram
2. Связанная страница Facebook
3. Приложение Facebook с необходимыми разрешениями
4. Токен доступа с нужными правами
5. ID вашего Instagram бизнес-аккаунта

Видео как получить ID: https://www.youtube.com/watch?app=desktop&v=6lHVkszs2M0.
Параметры, которые можно передать в функцию send_post_to_instagram:

image_url - URL изображения, которое вы хотите опубликовать.
caption - текст подписи к посту.
access_token - токен доступа Facebook, необходимый для аутентификации.
instagram_account_id - ID вашего бизнес-аккаунта Instagram.
Примеры использования:

"Создай пост в Instagram с картинкой по URL https://example.com/image.jpg, добавив текст 'Смотрите, что я нашел!'. Токен доступа: 'your_access_token_here', ID аккаунта: '123456789'."
Функция позволяет отправить данные на указанный вебхук Zapier. Это может быть полезно для интеграции различных приложений и автоматизации рабочих процессов.
Параметры, которые можно передать в функцию send_webhook_to_zapier:


webhook_id - ID вебхука Zapier. Это строка, представляющая уникальный идентификатор вебхука, на который вы хотите отправить данные.
data - данные для отправки в формате JSON. Это строка, содержащая данные, которые вы хотите передать на вебхук. Пример: '{"name": "John", "age": 30}'.
Примеры использования:

"Отправь данные '{"message": "Hello, Zapier!"}' на вебхук с ID 'webhook_123456'."
Функция send_webhook_to_make предназначена для отправки данных на вебхук платформы Make. Она принимает два обязательных параметра: webhook_url, который представляет собой URL вебхука, и data, содержащие данные в формате JSON, которые необходимо отправить. Функция использует библиотеку requests для выполнения POST-запроса к указанному вебхуку. Если запрос успешен, функция возвращает ответ в формате JSON. В случае ошибки при отправке данных, функция возвращает сообщение об ошибке.
Параметры, которые можно передать в функцию send_webhook_to_make:

webhook_url - URL вебхука Make, на который вы хотите отправить данные.
data - данные для отправки в формате JSON.
Примеры использования:

"Отправь данные на вебхук Make по URL https://hook.make.com/your_webhook_url с содержимым '{"key1": "value1", "key2": "value2"}'."

"Отправь JSON-данные '{"event": "new_user", "user_id": 123}' на вебхук по адресу https://hook.make.com/your_webhook_url."

Функция позволяет редактировать текст в указанной презентации Google Slides. Это может быть полезно для автоматизации обновления содержимого слайдов.
Параметры, которые можно передать в функцию ai_edit_google_slides:


url - URL презентации Google Slides. Это адрес презентации, в которой вы хотите редактировать текст. Не забудьте предоставить доступ на редактирование этой презентации всем пользователям по ссылке.
task - задача, содержащая слоган и слово для замены. Это строка, описывающая, что именно нужно изменить в тексте.
Примеры использования:

В этой презентации: https://docs.google.com/presentation/d/1RSl-KiaTh7xB-R3tOywleXyO6LvPd4dv5wyjbOjkfUY/edit?usp=sharing Напиши слоган и замени лучшая на эффективная

Функция post_to_vk предназначена для публикации постов в сообществе ВКонтакте.
Она принимает один аргумент - словарь arguments, который должен содержать следующие ключи:

1. access_token: строка, представляющая токен доступа к API ВКонтакте. Этот токен необходим для аутентификации и авторизации запросов к API.
2. group_id: строка, представляющая ID сообщества, в которое будет опубликован пост. Важно помнить, что ID сообщества должен быть отрицательным (например, -123456).
3. message: строка, содержащая текст поста, который вы хотите опубликовать.

Внутри функции происходит следующее:
- Импортируется библиотека requests, необходимая для выполнения HTTP-запросов.
- Формируется URL для метода wall.post API ВКонтакте.
- Создается словарь payload, который содержит параметры запроса, включая токен доступа, ID сообщества и текст поста.
- Выполняется POST-запрос к API ВКонтакте с использованием метода requests.post.
- Функция возвращает текст ответа от API, который может содержать информацию о результате публикации.
Код на Python

```
def post_to_vk(arguments):
import requests

url = "https://api.vk.com/method/wall.post"
payload = {
'access_token': arguments['access_token'],
'owner_id': f"-{arguments['group_id']}",
'message': arguments['message'],
'v': '5.131'
}
```
response = requests.post(url, params=payload)
return response.text
Функция позволяет загружать файлы в облачное хранилище Backblaze B2. Это может быть полезно для резервного копирования данных или хранения файлов в облаке.
Параметры, которые можно передать в функцию upload_file_to_backblaze:

file_urls - URL файлов для загрузки. Это строка, содержащая адреса файлов, которые вы хотите загрузить, разделенные символом ";".
bucket_name - имя ведра Backblaze B2. Это строка, указывающая название ведра, в которое вы хотите загрузить файлы.
application_key_id - идентификатор ключа приложения Backblaze B2. Это строка, необходимая для аутентификации при работе с API Backblaze.
application_key - ключ приложения Backblaze B2. Это строка, необходимая для доступа к API Backblaze.
Примеры использования:

arguments = {
"file_url" : "https://c.files.bbci.co.uk/110CD/production/_126273896_wed5.jpg",
"bucket_name" : "XXXXX",
"application_key_id" : "XXXXXXXXXX",
"application_key" : "XXXXXXXXXXXXXXXXX",
}
Функция предназначена для загрузки одного файла из публичного или приватного репозитория GitHub.
Параметры, которые можно передать в функцию github_load_file:

repo_name - имя репозитория на GitHub. Это строка, представляющая название репозитория, из которого вы хотите загрузить файл.
username - имя пользователя GitHub. Это строка, представляющая имя пользователя, которому принадлежит репозиторий.
file_path - путь к файлу в репозитории. Это строка, указывающая местоположение файла, который вы хотите загрузить.
branch - имя ветки для загрузки. Это строка, указывающая, из какой ветки загружать файл. По умолчанию используется ветка "main".
token - персональный токен доступа для аутентификации. Это строка, необходимая для доступа к приватным репозиториям или для выполнения операций, требующих аутентификации.
Примеры использования:

"Пожалуйста, загрузите файл 'src/main.py' из репозитория 'my-repo' пользователя 'myusername' на ветке 'main'."
"Мне нужно получить файл 'docs/readme.md' из репозитория 'example-repo' пользователя 'exampleuser' на ветке 'develop'."
"Загрузите файл 'config/settings.json' из репозитория 'config-repo' пользователя 'configuser' с использованием токена для доступа."
Функция предназначена для сохранения одного файла в репозиторий GitHub. Это может быть полезно для обновления содержимого файлов в проектах, размещенных на GitHub.
Параметры, которые можно передать в функцию github_save_file:

repo_name - имя репозитория GitHub. Указывает название репозитория, в который нужно загрузить изменения.
user_name - имя пользователя GitHub. Указывает имя пользователя, которому принадлежит репозиторий.
file_path - путь к файлу в репозитории. Указывает, какой файл нужно обновить.
branch - имя ветки, в которую нужно загрузить изменения. По умолчанию: "main".
token - персональный токен доступа для аутентификации. Указывает токен, необходимый для доступа к репозиторию.
content - новое содержимое для записи в файл. Указывает, что именно нужно записать в файл.
Примеры использования:

"Загрузи изменения в файл 'src/main.py' в репозитории 'my-repo' пользователя 'john_doe' с новым содержимым 'print'Hello, World!' ' и используйте ветку 'main'."

"Обнови файл 'README.md' в репозитории 'project-docs' с новым текстом и загрузите изменения в ветку 'develop' с токеном 'ghp_1234567890abcdef'."
Функция нужна, чтобы отправить верификационное СМС сообщение на платформе Premium Bonus. Это может быть полезно для подтверждения регистрации или аутентификации пользователей.
Параметры, которые можно передать в функцию premium_bonus_send_register_code:

phone - номер телефона пользователя. Указывает номер телефона, на который будет отправлен код подтверждения. Пример: "+79161234567".
authorization - ключ авторизации. Указывает ключ, необходимый для доступа к системе.
Примеры использования:

"Отправь код подтверждения на номер телефона +79161234567 с ключом авторизации abcdef123456."
Функция позволяет добавлять новых пользователей в сервис premium bonus. Это может быть полезно для управления клиентами и их данными в системе.
Параметры, которые можно передать в функцию add_new_user:

name - имя пользователя. Указывает имя нового пользователя.
surname - фамилия пользователя. Указывает фамилию нового пользователя.
phone - номер телефона пользователя. Указывает номер телефона для связи с пользователем.
email - Email пользователя. Указывает адрес электронной почты нового пользователя.
birth_date - дата рождения пользователя. Указывает дату рождения в формате YYYY.MM.DD. Пример: "1990.05.20".
gender - пол клиента. Указывает пол нового пользователя. Доступные варианты: "male" мужской или "female" женский .
authorization - ключ авторизации. Указывает ключ, необходимый для доступа к системе.
Примеры использования:

"Добавь нового пользователя с именем Иван, фамилией Иванов, номером телефона +79161234567, email ivan.ivanov@example.com, датой рождения 1990.05.20, полом male."

"Пожалуйста, зарегистрируй пользователя с именем Анна, фамилией Петрова, номером +79001234567, email anna.petrovna@example.com, датой рождения 1985.10.15 и полом female."

Функция позволяет активировать триггер для сценариев PremiumBonus, что может быть полезно для запуска определенных действий или процессов в системе на основе заданного события. Запуск действия настроенного в сценариях PremiumBonus для покупателя (когда требуется срабатывание по событию не предусмотренного шаблонами PremiumBonus, примеры действий - начисление бонусов/установка метки покупателя/отправка маркетингового сообщения.
Параметры, которые можно передать в функцию premium_bonus_run_trigger:

phone - телефонный номер. Это строка, представляющая номер телефона, который должен соответствовать формату: 7XXXXXXXXXX. Используется регулярное выражение для проверки формата: ^7\d{10}$.
event_name - название события. Это строка, представляющая название события, которое должно активировать триггер.
authorization - авторизационный заголовок. Это строка, необходимая для аутентификации запроса и подтверждения прав доступа к системе.
Примеры использования:

"Активируй триггер для события 'Регистрация' для номера телефона '71234567890'."

"Запусти триггер для события 'Подписка' с номером телефона '71123456789' и авторизационным заголовком 'auth_key_123'."
Функция позволяет проверить баланс премиум бонуса пользователя, используя его номер телефона. Это может быть полезно для пользователей, чтобы узнать, сколько бонусов у них осталось.
Параметры, которые можно передать в функцию check_premium_bonus_balance:

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

"Запроси баланс бонуса для пользователя с номером '79876543210' и авторизационным ключом 'auth_key_123'."

"Проверь, сколько премиум бонусов осталось у пользователя с телефоном '71123456789' с использованием ключа авторизации 'my_auth_key'."
Задайте нам вопрос
Укажите ваше имя, тему вопроса
Отправить сообщение
Мы ответим на все ваши вопросы и поможем с настройкой бота