Интеграции

Что такое блок «Интеграция»

Блок «Интеграция» позволяет вашему боту обращаться к сторонним сервисам — OpenAI, Google Sheets и другим — прямо в ходе сценария. Бот отправляет запрос, получает ответ и сохраняет результат в переменные.

Подключение сервиса

Перед использованием блока интеграции нужно создать подключение к сервису:

1. Нажмите кнопку «Интеграции» в шапке конструктора.
2. Выберите нужный сервис из списка.
3. Введите данные авторизации:
   • API-ключ — для OpenAI и других сервисов с ключом.
   • OAuth2 — для Google (авторизация через аккаунт Google).
   • Сервисный аккаунт — для Google (JSON-файл сервисного аккаунта).
4. Нажмите «Проверить» — система протестирует подключение.
5. Сохраните подключение.

Одно подключение можно использовать в нескольких блоках одного или разных ботов.

Настройка блока интеграции

1. Добавьте блок «Интеграция» в нужную ноду.
2. Выберите сервис (например, OpenAI).
3. Выберите подключение из списка созданных.
4. Выберите операцию (например, «Отправить сообщение»).
5. Заполните параметры операции.
6. Укажите префикс переменных результата (по умолчанию result).

После выполнения блока результат будет доступен как {{result.поле}}.

Переход при ошибке интеграции

В нижней части каждого блока интеграции находится секция «Переход при ошибке».

Если интеграция завершается ошибкой (сервис недоступен, исчерпана квота, неверный ответ и т.д.), бот:

1. Уведомляет владельца бота о проблеме (если уведомления включены).
2. Прерывает выполнение оставшихся блоков текущей ноды.
3. Переходит в ноду ошибки, указанную в поле «Ошибка интеграции».

Если поле «Ошибка интеграции» не заполнено — бот продолжает выполнение сценария как обычно (штатный путь после ноды), что может привести к некорректному поведению.

Рекомендации

• Всегда указывайте ноду ошибки для интеграций, которые критичны для сценария (AI-ответы, TTS, запросы к БД и т.д.).
• В ноде ошибки можно отправить пользователю понятное сообщение: «Сервис временно недоступен, попробуйте позже».
• Кнопка «+ создать» рядом с полем автоматически создаёт новую ноду и сразу связывает её с блоком интеграции.
• Связь с нодой ошибки отображается на схеме жёлтой стрелкой с подписью «Ошибка интеграции».

Важно: если в одной ноде несколько блоков интеграции, при ошибке первого из них остальные блоки не выполняются — бот сразу переходит к ноде ошибки.

Тестирование блока

Прямо в редакторе блока есть кнопка «Тест» — она выполняет операцию с текущими параметрами и показывает, какие переменные будут установлены. Это удобно для проверки запросов перед публикацией.

OpenAI

Отправить сообщение (Chat)

Отправляет запрос к ChatGPT и получает текстовый ответ.

Результирующие переменные (при префиксе result):

Запомнить диалог

Позволяет сохранять историю переписки и передавать её в каждый последующий запрос к модели, создавая эффект «памяти». История хранится в базе данных.

Когда «Выводить предварительное сообщение» включено, появляются два дополнительных поля:

Типичный сценарий с предварительным сообщением:

1. Блок «Интеграция» → включить «Выводить предварительное сообщение» → переменная "message_id".
2. Ответ ИИ сохраняется в "{{result.text}}".
3. Следующий блок «Текст» с "{{result.text}}" → в «Дополнительных» включить «Редактировать сообщение» → указать переменную "{{message_id}}".
4. Бот редактирует предварительное сообщение, заменяя заглушку на ответ ИИ.

Сгенерировать изображение

Создаёт изображение по текстовому описанию (DALL·E 3, GPT-image-1 и др.).

Результирующие переменные:

Анализировать изображение (Vision)

Задаёт вопрос по изображению — модель отвечает на основе содержимого картинки.

Результат: {{result.text}} — текстовый ответ модели.

Расшифровать аудио (Whisper)

Переводит голосовое сообщение или аудиофайл в текст.

Результат: {{result.text}} — расшифрованный текст.

Типичный сценарий: пользователь отправляет голосовое → блок «Ввод данных» сохраняет file_id → блок интеграции Whisper расшифровывает → переменная {{result.text}} доступна в следующих блоках.

Получить список моделей (OpenAI)

Запрашивает OpenAI API и записывает массив моделей, доступных в вашем аккаунте, в указанную переменную.

Параметров нет — укажите только переменную, в которую будет записан результат.

Результат: {{result}} — массив объектов. Доступные свойства каждого элемента (N — порядковый номер с 0):

Нажмите Тест в редакторе, чтобы убедиться в работе и увидеть список моделей. Данные будут доступны через {{result.0.id}}, {{result.1.id}} и т.д.

Реакция на сообщение (OpenAI)

ИИ анализирует текст сообщения пользователя и выбирает одно эмодзи из разрешённого списка, после чего бот ставит эту реакцию на указанное сообщение через Telegram API.

Результирующие переменные (при префиксе result):

Поведение при отсутствии реакции: если ИИ вернул "null", пустую строку или эмодзи не из разрешённого списка — реакция не выставляется, переменная "selected_emoji" остаётся пустой строкой, выполнение сценария продолжается.

Anthropic Claude

Отправить сообщение

Отправляет запрос к Claude и получает текстовый ответ. Поддерживает те же возможности памяти диалога и предварительного сообщения, что и OpenAI Chat.

Результирующие переменные (при префиксе result):

Запомнить диалог

Аналогично разделу OpenAI → Запомнить диалог — все настройки (время памяти, максимум сообщений, название диалога, генерация названий, ID диалога, переменная с ID, предварительное сообщение) работают одинаково для Claude.

Получить список моделей (Anthropic)

Запрашивает Anthropic API и записывает массив доступных моделей Claude в указанную переменную.

Параметров нет — укажите только переменную, в которую будет записан результат.

Результат: {{result}} — массив объектов (sorted by created_at desc). Доступные свойства каждого элемента (N — порядковый номер с 0):

Нажмите Тест в редакторе, чтобы убедиться в работе. После теста автодополнение {{result.0.id}}, {{result.1.id}} и т.д. будет доступно в редакторе.

Реакция на сообщение (Claude)

Идентична операции OpenAI → Реакция на сообщение: ИИ Claude анализирует текст сообщения и выбирает одну реакцию из разрешённого списка, после чего бот ставит её через Telegram API.

Результирующая переменная: {{result.selected_emoji}} — выбранное эмодзи (пусто, если ИИ не смог подобрать).

Google Sheets

Подключение

Поддерживаются два способа авторизации:

• OAuth2 — авторизация через Google-аккаунт. Создайте OAuth2-клиент в Google Cloud Console (тип: Веб-приложение), включите Google Sheets API и Google Drive API и добавьте URI перенаправления.
• Сервисный аккаунт — JSON-ключ сервисного аккаунта. После создания аккаунта откройте нужные таблицы и выдайте email сервисного аккаунта доступ (редактор).

Тип подключения выбирается при создании и затем неизменен. Чтобы сменить метод авторизации, создайте новое подключение.

Получить строку

Ищет строку в таблице Google Sheets по значению в указанном столбце.

Имена переменных результата соответствуют заголовкам столбцов таблицы:

{{result.Email}} → значение столбца «Email» в найденной строке {{result.Имя}} → значение столбца «Имя» {{result.Телефон}} → значение столбца «Телефон»

Если строка не найдена — переменные будут пустыми.

Добавить строку

Добавляет новую строку в конец листа.

Переменных не возвращает. Используйте для сохранения заявок, ответов пользователей, логов.

Добавить или обновить запись

Ищет строку по значению в указанном столбце. Если строка найдена — обновляет её. Если нет — добавляет новую строку в конец листа.

Переменных не возвращает.

Обновить запись

Находит строку по значению в указанном столбце и обновляет её данные.

Если строка не найдена — обновление не производится. Переменных не возвращает.

Получить записи

Возвращает все строки листа, соответствующие заданным фильтрам.

Результат при «Вернуть первую строку» = включён (как «Получить строку»):

""" {{result.НазваниеКолонки}} → значение колонки в найденной строке """

Результат при «Вернуть первую строку» = выключен:

Очистить лист

Удаляет содержимое ячеек, не удаляя сам лист.

Переменных не возвращает.

Удалить строки или столбцы

Удаляет указанные строки или столбцы со сдвигом оставшихся.

Переменных не возвращает.

Создать лист

Добавляет новую вкладку в существующую таблицу.

Переменных не возвращает.

Удалить лист

Удаляет вкладку из таблицы вместе со всеми данными.

Переменных не возвращает.

Google Drive

Управление файлами, папками и общими дисками Google Drive прямо из бота.

Подключение

Поддерживаются два способа авторизации:

• OAuth2 — авторизация через Google-аккаунт. Создайте OAuth2-клиент в Google Cloud Console (тип: Веб-приложение), включите Google Drive API и добавьте URI перенаправления, показанный при создании подключения.
• Сервисный аккаунт — JSON-ключ сервисного аккаунта. После создания аккаунта выдайте его email доступ к нужным папкам или файлам Google Drive.

Тип подключения выбирается при создании и затем неизменен. Чтобы сменить метод авторизации, создайте новое подключение.

Действия с файлами

Копировать файл

Результирующие переменные (при префиксе result):

Создать файл из текста

Создаёт текстовый файл из содержимого переменной.

Результирующие переменные — те же, что у «Копировать файл» (file_id, name, webViewLink).

Удалить файл

Переменных не возвращает.

Скачать файл

Скачивает файл с Google Drive и сохраняет его для дальнейшего использования.

Результирующие переменные:

Переместить файл

Результирующие переменные: {{result.file_id}}, {{result.name}}.

Поделиться файлом

Предоставляет доступ к файлу пользователю, группе, домену или всем.

Результирующие переменные: {{result.permission_id}}, {{result.role}}, {{result.type}}.

Обновить файл

Результирующие переменные: {{result.file_id}}, {{result.name}}, {{result.mimeType}}.

Загрузить файл

Загружает файл из указанного URL в Google Drive.

Если URL начинается с адреса локального Telegram Bot API — файл читается с сервера напрямую, без HTTP-загрузки.

Результирующие переменные: {{result.file_id}}, {{result.name}}, {{result.webViewLink}}, {{result.mimeType}}.

Поиск файлов и папок

Найти файлы и папки

Выполняет поиск по Google Drive с использованием синтаксиса Drive Query Language.

Результирующие переменные:

Действия с папками

Создать папку

Результирующие переменные: {{result.folder_id}}, {{result.name}}, {{result.webViewLink}}.

Cloudflare R2

Cloudflare R2 — S3-совместимое объектное хранилище. Подходит для хранения файлов с прямым доступом по URL.

Подключение

1. Откройте Cloudflare Dashboard → R2 Object Storage → ваш бакет → вкладка Settings.
2. Найдите поле S3 API — оно выглядит как "https://<account_id>.r2.cloudflarestorage.com/". Часть "<account_id>" — это ваш Account ID.
3. Перейдите в R2 → Manage R2 API Tokens → Create API Token.
4. Выберите права Object Read & Write (или ограничьте конкретным бакетом), сохраните.
5. Скопируйте Access Key ID и Secret Access Key.

Вставьте JSON в поле подключения:

"""json { "account_id": "abc123...", "access_key_id": "...", "secret_access_key": "...", "bucket_name": "my-bucket", "public_url": "https://pub-xxx.r2.dev" } """

"public_url" — необязательное поле. Нужно для получения прямых ссылок на файлы после загрузки. Где взять:

• Public Development URL (для тестов): Settings бакета → раздел Public Development URL → нажмите Enable. После включения скопируйте появившийся URL вида "https://pub-xxx.r2.dev".
• Кастомный домен (для продакшна): Settings → Custom Domains → Add.

Если ни то ни другое не настроено — оставьте поле пустым; "{{result.public_url}}" будет пустой строкой.

Загрузить файл

Загружает файл в R2 по URL или из внутреннего хранилища бота.

Результирующие переменные:

Удалить файл

Операция не возвращает результат.

Список файлов

Возвращает список объектов в бакете.

Результирующие переменные:

Скопировать файл

Копирует объект внутри бакета без повторной загрузки.

Результирующие переменные: {{result.key}}, {{result.public_url}}.

Информация о файле

Возвращает метаданные объекта (без скачивания содержимого).

Результирующие переменные:

Удалить папку

Переменных не возвращает.

Поделиться папкой

Аналогично «Поделиться файлом» — те же параметры и результат, только для папки.

Действия с общими дисками

Создать общий диск

Результирующие переменные: {{result.drive_id}}, {{result.name}}.

Удалить общий диск

Переменных не возвращает.

Получить общий диск

Результирующие переменные: {{result.drive_id}}, {{result.name}}, {{result.created_time}}.

Список общих дисков

Результирующие переменные: {{result.drives}} — массив дисков · {{result.count}} — количество.

Обновить общий диск

Результирующие переменные: {{result.drive_id}}, {{result.name}}.

Google Calendar

Управление событиями в Google Calendar: создание, получение, обновление, удаление и проверка доступности.

Подключение

Поддерживаются два способа авторизации:

• OAuth2 — авторизация через Google-аккаунт. Необходимо создать OAuth2-клиент в Google Cloud Console (тип: Веб-приложение), включить Google Calendar API и добавить URI перенаправления.
• Сервисный аккаунт — JSON-ключ сервисного аккаунта. После создания аккаунта поделитесь нужными календарями с email сервисного аккаунта в настройках самого Calendar.

Создать событие

Дополнительные параметры (раздел «Дополнительные»):

Результирующие переменные (при префиксе result):

Удалить событие

Переменных не возвращает.

Получить событие

Результирующие переменные (при префиксе result):

Получить события

Результирующие переменные:

Используйте {{result.count}} в блоке «Условие» для проверки наличия событий.

Обновить событие

Обязательные параметры: Календарь и ID события. Все остальные поля (название, время, описание и т.д.) опциональны — обновляются только те, что указаны.

Используйте «Дополнительные» (advanced) параметры — там доступны все те же поля, что и при создании события.

Результирующие переменные — те же, что у «Создать событие» (id, summary, status, htmlLink, start, end).

Доступность в календаре

Проверяет, свободен ли указанный временной диапазон в календаре (использует Google Calendar FreeBusy API).

Результирующие переменные:

Редактирование сообщения в блоке «Текст»

В блоке «Текст» в разделе «Дополнительные» доступна опция «Редактировать сообщение».

При её включении вместо отправки нового сообщения бот редактирует существующее — заменяет его текст на содержимое блока.

Типичное применение — связка с предварительным сообщением ИИ:

1. Блок «Интеграция» (OpenAI / Claude) → включить «Выводить предварительное сообщение» → переменная для ID, например "message_id".
2. Пока ИИ генерирует ответ, пользователь видит заглушку.
3. Следующий блок «Текст» с текстом ответа "{{result.text}}" → «Дополнительные» → «Редактировать сообщение» → "{{message_id}}".
4. Бот редактирует предварительное сообщение: заглушка заменяется готовым ответом.

Если переменная пуста или указан несуществующий ID — блок отправит сообщение как обычный текст.

ElevenLabs

ElevenLabs — платформа для работы с голосом на основе ИИ: высококачественная озвучка текста, распознавание речи, изменение голоса, клонирование голоса и генерация звуковых эффектов.

Подключение

1. Зарегистрируйтесь на elevenlabs.io.
2. Перейдите в Settings → API Keys → нажмите Create API Key.
3. Скопируйте созданный ключ и вставьте в поле подключения.
4. Нажмите «Проверить» — система проверит доступ к API.

Бесплатный план ElevenLabs имеет лимит символов в месяц. Клонирование голоса требует платного плана Creator или выше.

Озвучить текст (Text-to-Speech)

Преобразует текст в аудиофайл с использованием выбранного голоса.

Дополнительные параметры:

Результирующие переменные (при префиксе result):

Важно: Ссылка на аудиофайл доступна в течение 24 часов, после чего удаляется автоматически.

Типичный сценарий — бот-диктор:

1. Блок «Интеграция» → ElevenLabs → Озвучить текст → выбрать голос → текст "{{news_text}}".
2. Следующий блок «Аудио» → в поле «file_id или URL» указать "{{result.url}}".
3. Бот отправляет озвученную новость как аудиосообщение.

Распознать речь (Speech-to-Text)

Преобразует голосовое сообщение или аудиофайл в текст (модели серии Scribe).

Дополнительные параметры:

Результирующие переменные:

Типичный сценарий — голосовой ассистент:

1. Блок «Ввод данных» → сохраняет голосовое в переменную "voice_input".
2. Блок «Интеграция» → Распознать речь → "file_id: {{voice_input}}" → "{{result.text}}".
3. Блок «Интеграция» → OpenAI / ChatGPT → "{{result.text}}" → ответ "{{ai.text}}".
4. Блок «Текст» → "{{ai.text}}".

Изменить голос (Speech-to-Speech)

Заменяет голос в аудиозаписи, сохраняя все интонации и эмоции оригинала.

Дополнительные параметры: Модель, Формат аудио, Стабильность, Усиление сходства.

Результирующие переменные: {{result.url}} — URL аудиофайла · {{result.request_id}}.

Важно: Ссылка на аудиофайл доступна в течение 24 часов, после чего удаляется автоматически.

Сгенерировать звуковой эффект

Генерирует аудио по текстовому описанию: природные звуки, шумы, технические звуки.

Дополнительные параметры: Влияние промпта (0–1), Формат аудио.

Результирующие переменные: {{result.url}} — URL аудиофайла.

Важно: Ссылка на аудиофайл доступна в течение 24 часов, после чего удаляется автоматически.

Музыка к видео (Video-to-Music)

Генерирует музыкальный саундтрек под видеофайл — автоматически подбирает темп, настроение и инструментовку.

Дополнительные параметры: Формат аудио.

Результирующие переменные: {{result.url}} — URL аудиофайла с музыкой.

Важно: Ссылка на аудиофайл доступна в течение 24 часов, после чего удаляется автоматически.

Клонировать голос (Instant Voice Cloning)

Создаёт цифровую копию голоса по короткой аудиозаписи (от нескольких секунд до минуты). Клонированный голос сохраняется в аккаунте ElevenLabs и его можно использовать в операции «Озвучить текст».

Дополнительные параметры: Описание голоса, Убрать фоновый шум.

Результирующие переменные:

Типичный сценарий — персональный голос бота:

1. Блок «Ввод данных» → пользователь отправляет голосовое → "voice_sample".
2. Блок «Интеграция» → Клонировать голос → "name: Мой голос", "file_id: {{voice_sample}}" → "{{result.voice_id}}".
3. Сохранить "{{result.voice_id}}" в базу данных.
4. В следующих сценариях: блок «Интеграция» → Озвучить текст → "voice_id: {{saved_voice_id}}".

Клонирование голоса требует платного плана ElevenLabs Creator или выше.

Советы по работе с интеграциями

• Сохраняйте результаты интеграций в переменные с понятными именами: ai_answer, sheet_row.
• Используйте блок «Условие» после интеграции, чтобы проверить, нашла ли операция нужные данные.
• Тестируйте блок прямо в редакторе кнопкой «Тест» — это экономит время при разработке.
• При использовании памяти диалога с ИИ включайте «Генерировать названия диалога» — это помогает ориентироваться в истории переписки в будущих версиях панели.
• Для сложных сценариев с несколькими AI-блоками используйте «Переменная с ID диалога», чтобы каждый блок работал с нужным диалогом явно, а не по принципу «последний».
• Если бот обрабатывает конфиденциальные данные пользователей, включите «Шифровать данные» в настройках памяти диалога — сообщения будут сохранены в БД в зашифрованном виде.

Supabase

Supabase — open-source-альтернатива Firebase на базе PostgreSQL. Интеграция позволяет выполнять CRUD-операции с таблицами через Supabase REST API (PostgREST) прямо из сценария бота.

Подключение

1. Откройте настройки вашего проекта: supabase.com/dashboard → ваш проект → Settings → API.
2. Скопируйте Project URL из раздела Project URL.
3. Скопируйте ключ service_role (secret) из раздела Project API keys.
4. В диалоге подключения заполните два поля:

5. Нажмите «Проверить подключение» — система выполнит запрос к API и подтвердит корректность данных.
6. Сохраните подключение.

Важно: Используйте ключ "service_role" (secret), а не "anon". Это позволяет обходить Row Level Security и работать с данными в обход политик доступа. Храните ключ в безопасности.

Создать запись

Вставляет новую строку в таблицу.

Результирующие переменные (при префиксе result):

Удалить запись

Удаляет строки, соответствующие условиям.

Результирующие переменные:

Получить запись

Получает первую строку, удовлетворяющую условиям.

Результирующие переменные:

Если запись не найдена — переменные не устанавливаются.

Получить список записей

Возвращает массив строк, соответствующих фильтрам.

Результирующие переменные:

Используйте {{result}} с динамическими кнопками (тип «Динамические кнопки») или блоком «Условие» для проверки "{{result.count}}".

Обновить запись

Обновляет строки, соответствующие условиям.

Результирующие переменные:

Операторы условий

В блоках с условиями (Select Conditions / Filters) поддерживаются следующие операторы:

Пример: сохранение заявки пользователя

1. Блок «Ввод данных» — имя → "user_name", телефон → "user_phone".
2. Блок «Интеграция» → Supabase → Создать запись:
   • Таблица: "leads"
   • Данные: "name" → "{{user_name}}", "phone" → "{{user_phone}}", "chat_id" → "{{USER_ID}}"
3. Переменная "{{result.id}}" — ID созданной заявки в Supabase.

Grok (xAI)

Grok — мощная языковая модель от компании xAI, предоставляющая возможности чат-ИИ, анализа изображений, генерации медиа и работы с аудио.

API Base URL: "https://api.x.ai/v1"
API ключ: Начинается с "xai-". Получить можно на console.x.ai.

Настройка подключения

В настройках интеграции введите API ключ в формате "xai-...".
Кнопка «Проверить соединение» отправит запрос к "/models" для проверки валидности ключа.

Операции

Отправить сообщение ("send_message")

Отправляет текстовый запрос языковой модели Grok и возвращает ответ.

Параметры:

Результирующие переменные:

• "{prefix}.text" — текст ответа модели
• "{prefix}.model" — использованная модель
• "{prefix}.tokens_used" — количество потреблённых токенов
• "{prefix}." — поля JSON (если включён JSON-режим со схемой)

Анализировать изображение ("analyze_image")

Отправляет изображение модели для визуального анализа (Vision API).

Параметры:

Результирующие переменные:

• "{prefix}.text" — ответ модели
• "{prefix}.model" — использованная модель
• "{prefix}.tokens_used" — количество потреблённых токенов

Создать изображение ("generate_image")

Генерирует изображение по текстовому описанию с помощью модели "grok-imagine-image".

Параметры:

Результирующие переменные:

• "{prefix}.url" — URL сгенерированного изображения (временный)
• "{prefix}.file_id" — Telegram "file_id" первого изображения (стабильный)
• "{prefix}.file_ids" — массив Telegram "file_id" всех изображений
• "{prefix}.count" — количество сгенерированных изображений
• "{prefix}.{i}.file_id" — "file_id" каждого изображения по индексу

Примечание: URL изображений, возвращаемые xAI, являются временными. Блок автоматически загружает изображения в Telegram и сохраняет стабильный "file_id".

Реакция на сообщение ("react_to_message")

Анализирует сообщение пользователя с помощью ИИ и ставит подходящую эмодзи-реакцию в Telegram.

Параметры:

Результирующие переменные:

• "{prefix}.selected_emoji" — выбранный эмодзи (или пустая строка, если ИИ решил не реагировать)

Создать видео ("generate_video")

Генерирует видеоролик по текстовому описанию с помощью модели "grok-imagine-video".

⚠️ Важно: Генерация видео занимает 1–5 минут (иногда до 10 минут). Блок выполняет асинхронный опрос API каждые 5 секунд. Убедитесь, что ваша очередь задач поддерживает длительное выполнение.

Параметры:

Результирующие переменные:

• "{prefix}.url" — URL готового видео (временный)
• "{prefix}.file_id" — Telegram "file_id" видео (стабильный)
• "{prefix}.duration" — продолжительность видео в секундах
• "{prefix}.model" — использованная модель

Расшифровать аудио ("transcribe_audio")

Конвертирует голосовое сообщение или аудиофайл из Telegram в текст (Speech-to-Text).

Параметры:

Результирующие переменные:

• "{prefix}.text" — расшифрованный текст
• "{prefix}.language" — определённый язык
• "{prefix}.duration" — продолжительность аудио в секундах

Озвучить текст ("text_to_speech")

Синтезирует речь из текста и возвращает временный URL аудиофайла.

Параметры:

Результирующие переменные:

• "{prefix}.url" — временный URL аудиофайла (действителен 24 часа)

Файл автоматически удаляется через 24 часа после генерации.

Получить список моделей ("list_models")

Получает актуальный список доступных моделей Grok.

Результирующие переменные:

• "{prefix}" — массив объектов с полями "id" и "created"

Примеры моделей

Актуальный список доступен через операцию «Получить список моделей».

Twilio

Отправка SMS-сообщений и проверка статуса доставки через Twilio.

Подключение

Вставьте учётные данные Twilio в формате JSON:

{
  "account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "auth_token": "ваш_auth_token"
}

Найдите Account SID и Auth Token в Twilio Console.

Отправить SMS

Результирующие переменные (при префиксе result):

Получить статус сообщения

Результирующие переменные — те же, что у «Отправить SMS», с актуальным статусом доставки ({{result.status}}, {{result.error_code}} и т.д.).

SMS доставляется не мгновенно: сразу после отправки статус обычно queued. Запросите статус позже, чтобы увидеть delivered или ошибку.

Airtable

Чтение и управление записями, таблицами и базами в Airtable.

Подключение

Создайте Personal Access Token на airtable.com/create/tokens и вставьте его в поле подключения. Необходимые разрешения (scopes): schema.bases:read, data.records:read, data.records:write.

Общие параметры операций:

Получить список баз

Параметров нет — возвращает базы, доступные токену.

Получить схему базы

Результат: {{result}} — массив таблиц базы; {{result.count}}, {{result.N.id}}, {{result.N.name}}, {{result.N.fields}} (JSON-описание полей N-й таблицы).

Создать запись

Результирующие переменные:

Создать или обновить запись

Ищет запись по совпадению значений в указанных полях. Если найдена — обновляет, иначе создаёт новую.

Результирующие переменные: те же, что у «Создать запись», плюс:

Удалить запись

Результирующие переменные: {{result.deleted}} — true/false · {{result.id}} — ID удалённой записи.

Получить запись

Результирующие переменные: {{result.id}}, {{result.createdTime}}, {{result.fields.НазваниеПоля}}.

Поиск записей

Результирующие переменные:

Обновить запись

Результирующие переменные: {{result.id}}, {{result.createdTime}}, {{result.fields.НазваниеПоля}}.

HubSpot

Управление контактами, сделками и компаниями в HubSpot CRM.

Подключение

Получите Access Token вашего Private App в HubSpot: Настройки → Интеграции → Private Apps → Создать приложение. Токен начинается с pat- — вставьте его в поле подключения.

Создать или обновить контакт

Ищет контакт по email или телефону. Если найден — обновляет, иначе создаёт новый.

Результирующие переменные:

Получить контакт

Результирующие переменные: те же, что у «Создать или обновить контакт» (без action). Если контакт не найден — переменные пустые.

Создать сделку

Результирующие переменные: {{result.id}}, {{result.dealname}}, {{result.pipeline}}, {{result.dealstage}}, {{result.amount}}.

Обновить стадию сделки

Результирующие переменные: {{result.id}}, {{result.dealstage}}.

Найти или создать компанию

Результирующие переменные:

Связать контакт с компанией

Результирующая переменная: {{result.success}} = true.

Создать заметку

Результирующая переменная: {{result.id}} — ID созданной заметки.

Создать звонок

Результирующая переменная: {{result.id}} — ID записи о звонке.

Создать встречу

Результирующая переменная: {{result.id}} — ID встречи.

Поиск объектов CRM

Результирующие переменные:

Salesforce

Управление лидами, контактами, аккаунтами, сделками и задачами в Salesforce CRM.

Подключение

Вставьте учётные данные Salesforce Connected App в формате JSON:

{
  "login_url": "https://login.salesforce.com",
  "client_id": "ваш_consumer_key",
  "client_secret": "ваш_consumer_secret",
  "username": "api@yourcompany.com",
  "password": "ПарольТокенБезопасности"
}

Создайте Connected App в Setup → App Manager (включите OAuth и Username-Password flow).

Примечание: «password» = ваш пароль + токен безопасности (без разделителя). Для sandbox используйте https://test.salesforce.com в качестве login_url.

Создать или обновить лид

Ищет лид по email, телефону или ID. Если найден — обновляет, иначе создаёт новый.

Результирующие переменные:

Конвертировать лид

Конвертирует лид в контакт + аккаунт (и опционально сделку).

Результирующие переменные:

Создать или обновить контакт

Результирующие переменные: {{result.id}}, {{result.action}} (created/updated), {{result.email}}, {{result.firstname}}, {{result.lastname}}.

Создать сделку

Результирующие переменные: {{result.id}}, {{result.name}}, {{result.stagename}}, {{result.closedate}}, {{result.amount}}.

Обновить стадию сделки

Результирующие переменные: {{result.id}}, {{result.stagename}}.

Создать или обновить аккаунт

Результирующие переменные: {{result.id}}, {{result.action}} (created/updated), {{result.name}}.

Создать задачу / Записать активность

Результирующая переменная: {{result.id}} — ID созданной задачи.

Поиск записей (SOQL)

Результирующие переменные:

Mailchimp

Управление подписчиками, тегами и событиями автоматизации в Mailchimp.

Подключение

Вставьте ваш API-ключ Mailchimp. Найдите его в Account → Extras → API keys. Ключ заканчивается кодом дата-центра, например -us21.

Добавить или обновить подписчика

Добавляет email в аудиторию или обновляет существующего подписчика (поиск по email).

Результирующие переменные:

Добавить или удалить теги

Результирующая переменная: {{result.email_address}}.

Создать событие подписчика

Отправляет пользовательское событие — им можно запускать автоматизации Customer Journey.

Результирующие переменные: {{result.email_address}} · {{result.event_name}} — нормализованное название события.