Действия рабочего процесса

​

О действиях

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

​

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

​

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

Добавляет новую запись в выбранный объект. Настройка:

• Выберите целевой объект
• Заполните обязательные и необязательные поля
• Используйте данные из предыдущих шагов или введите значения вручную, чтобы заполнить поля

Вывод: Данные вновь созданной записи доступны для использования на последующих шагах.

​

Обновление записи

Изменяет существующую запись в выбранном объекте. Настройка:

• Выберите целевой объект
• Выберите конкретную запись для обновления.
  • Вы можете либо выбрать конкретную запись, используя раскрывающееся меню, где показаны все доступные записи.
  • Либо можно выбрать запись динамически, указав запись, найденную на предыдущем шаге, с помощью (x+). На этом этапе вы не можете искать запись по различным критериям. Если вы ещё не определили запись, добавьте шаг Search Record перед шагом Update Record.
• Выберите поля для изменения и введите новые значения

Вывод: Данные обновленной записи доступны для использования в последующих шагах.

​

Удаление записи

Удаляет запись из выбранного объекта. Настройка:

• Выберите целевой объект
• Выберите конкретную запись для удаления

Вывод: Данные удаленной записи остаются доступными для использования в последующих шагах.

​

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

Находит записи в выбранном объекте, используя условия фильтрации. Настройка:

• Выберите объект для поиска
• Установите критерии фильтра для сужения результатов
• Настройте сортировку и ограничения

Вывод: Возвращает записи, которые могут быть использованы в последующих шагах. Рекомендация: Используйте ветвления после Search Records для обработки сценариев “найдено” и “не найдено”.

​

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

Создаёт новую запись или обновляет существующую на основе критериев сопоставления. Это полезно, если вы не уверены, существует ли уже запись. Настройка:

• Выберите целевой объект
• Обратите внимание, какие поля можно использовать для сопоставления: email — для People, домен — для Companies, ID — для любого объекта или любое поле, помеченное как Unique. Ниже нужно заполнить как минимум одно из них.
• Заполните значения полей. Не забудьте указать как минимум один уникальный идентификатор.

• Используйте данные из предыдущих шагов для заполнения полей

Как это работает:

1. Ищет запись, соответствующую вашим критериям
2. Если найдена → обновляет существующую запись
3. Если не найдена → создает новую запись

Вывод: Данные созданной или обновленной записи доступны для использования в последующих шагах.

​

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

​

Итератор

Перебирает массив записей, возвращенный на предыдущем этапе, позволяя выполнять действия для каждой записи по отдельности. Настройка:

• Выберите массив записей с предыдущего шага (например, результаты из Search Records, из Manual trigger with Bulk availability, из code node). Когда шаг Code или «Логическая функция» возвращает массив верхнего уровня, выберите параметр Whole list, чтобы выполнить цикл по всему результату.
• Определите действия, которые нужно выполнить для каждой записи в цикле.

• Доступ к полям Current Item: чтобы использовать поля записи, которая обрабатывается в данный момент, нажмите на шаг Iterator, затем выберите Current item. Будет отображен список доступных полей этой записи, и их можно выбрать для использования в последующих действиях. Вы также можете выбрать Use the whole item, чтобы передать весь текущий элемент на следующий шаг.

​

Фильтр

Фильтрует записи на основе указанных условий, пропуская только записи, соответствующие критериям. Настройка:

• Выберите запись для фильтрации
• Определите условия фильтрации и критерии
• Настройте, какие записи должны пройти через последующие шаги

​

Задержка

Приостанавливает выполнение рабочего процесса на указанное время или до определенной даты/времени. Типы задержек: Настройка длительности:

• Укажите дни, часы, минуты и/или секунды
• Объединяйте несколько единиц (например, 2 дня и 4 часа)

Настройка запланированной даты:

• Выберите дату и время
• Можно ссылаться на поле даты с предыдущего шага (например, связаться повторно через 3 дня после встречи)

Сценарии использования:

• Подождать 24 часа перед отправкой повторного письма
• Пауза до даты закрытия сделки
• Запланировать действия на рабочие часы

Ограничения и кредиты:

• Нет максимального ограничения по длительности — вы можете задавать задержки в минутах, днях, неделях или больше
• Списывается 1 кредит при выполнении узла Задержка, независимо от длительности
• Кредиты не списываются во время ожидания — задержка на 5 минут стоит столько же, сколько задержка на 5 дней

​

Коммуникационные действия

​

Отправить письмо

Отправляет email из вашего рабочего процесса. Подходит для шаблонных групповых писем. Письма будут выглядеть так же, как те, что вы отправляете из своего почтового ящика. Не подходит для рассылок (им требуется более богатое форматирование) или автоматических цепочек писем. Предварительные условия: добавьте учетную запись электронной почты в Настройки → Учетные записи Настройка:

• Выберите учетную запись электронной почты отправителя

Для всех следующих шагов вы можете использовать переменные из предыдущих шагов для персонализации.

• Введите email-адрес получателя.

• Установите строку темы.
• Составьте текст сообщения. Можно форматировать ссылки, создавать нумерованные и маркированные списки, добавлять вложения.

​

Форма

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

• Настройте поля, которые пользователям предложат заполнить. Для каждого поля выберите
  • тип: текст, число, дата, заданная запись, поле выбора. Поля выбора доступны для всех объектов.
  • метку
  • значение по умолчанию в Placeholder (необязательно)
• Отредактируйте заголовок формы

Вывод: ответы формы доступны для использования в последующих шагах. Пример: Рабочий процесс “Quick Lead” доступен по умолчанию во всех рабочих пространствах, доступен в любом месте через Command Menu Cmd + K. Как заполнить форму:

• Запустите свой ручной рабочий процесс из командного меню Cmd K
• Заполните форму, отображаемую в боковой панели, и нажмите Submit.

​

Интеграционные действия

​

Код

Выполняет кастомный JavaScript в вашем рабочем процессе. Под капотом каждое действие Code поддерживается собственной логической функцией — серверной функцией на TypeScript, которая выполняется на платформе Twenty. Когда вы добавляете действие Code, Twenty создает для этого шага отдельную логическую функцию и открывает ее редактор прямо в интерфейсе, поэтому написанный вами код хранится вместе с рабочим процессом. Настройка:

• Получайте доступ к переменным из предыдущих шагов. Вы можете динамически изменять имена переменных.

• Напишите код JavaScript в редакторе
• Возвращайте переменные для использования в последующих шагах
• Проверяйте код непосредственно в шаге

​

Повторное использование логической функции в рабочих процессах

Встроенное действие Code отлично подходит для разовой логики, но код, который оно содержит, принадлежит только этому одному шагу. Когда вы хотите использовать одну и ту же логику в нескольких рабочих процессах — или вести ее как версионируемый исходный код в приложении — определите повторно используемую логическую функцию вместо копирования и вставки кода в каждое действие Code. Логическая функция определяется один раз в приложении (с помощью SDK-функции defineLogicFunction) и становится доступной в конструкторе рабочих процессов при добавлении workflowActionTriggerSettings. После установки вашего приложения эта функция появляется как отдельное действие в конструкторе рабочих процессов, наряду со встроенными действиями. При выборе этого действия отображаются объявленные вами поля ввода (с селекторами переменных, как и в других действиях) и выполняется ваш общий код — встроенный JavaScript не требуется. Оба варианта работают в одной и той же среде выполнения логических функций, поэтому действие Code, которое вы прототипировали во встроенном режиме, позже можно с минимальными изменениями превратить в повторно используемую логическую функцию.

​

HTTP-запрос

Отправляет запрос внешнему API в рамках вашего рабочего процесса. Настройка:

• Введите URL конечной точки API. Можно использовать параметры из предыдущих шагов.
• Выберите метод HTTP (GET, POST, PUT, PATCH, DELETE)
• Добавьте необходимые заголовки и значения
• Предоставьте пример ответа для предварительного просмотра структуры

​

Действия ИИ

​

ИИ-агент — скоро

Запускает ИИ-агента внутри вашего рабочего процесса для выполнения интеллектуальных задач. Настройка:

• Агент: Выберите существующего ИИ-агента или используйте агента по умолчанию
• Промпт: Напишите инструкцию для ИИ-агента
• Ссылайтесь на переменные из предыдущих шагов в промпте

Что могут делать ИИ-агенты:

• Анализировать и резюмировать данные
• Классифицировать или категоризировать записи
• Генерировать текстовый контент
• Принимать решения на основе данных
• Взаимодействовать с данными вашей CRM с помощью инструментов

Вывод: Ответ ИИ-агента доступен для использования в последующих шагах. Если у агента есть схема структурированного вывода, ответ будет соответствовать этому формату.