Перейти к основному содержанию
Автоматически создавайте или получайте PDF и прикрепляйте его к записи в Twenty. Это часто используют для создания коммерческих предложений, счетов или отчетов, связанных с компаниями, сделками или другими объектами.

Обзор

В этом рабочем процессе используется Ручной триггер, чтобы пользователи могли по запросу создавать PDF для любой выбранной записи. За обработку отвечает Логическая функция:
  1. Загрузка PDF по URL (из сервиса генерации PDF)
  2. Загрузка файла в Twenty
  3. Создание вложения, связанного с записью

Требования

Прежде чем настраивать рабочий процесс:
  1. Создайте ключ API: перейдите в Настройки → APIs и создайте новый ключ API. Этот токен понадобится для логической функции.
  2. Настройте сервис генерации PDF (необязательно): если вы хотите динамически генерировать PDF (например, коммерческие предложения), используйте такие сервисы, как Carbone, PDFMonkey или DocuSeal, чтобы создать PDF и получить URL для скачивания.

Пошаговая настройка

Шаг 1: Настройте триггер

  1. Перейдите в Рабочие процессы и создайте новый рабочий процесс
  2. Выберите Ручной триггер
  3. Выберите объект, к которому нужно прикреплять PDF (например, Company или Opportunity)
С помощью ручного триггера пользователи могут запускать этот рабочий процесс с кнопки, которая появляется в правом верхнем углу после выбора записи, чтобы сгенерировать и прикрепить PDF.

Шаг 2: Добавьте логическую функцию

  1. Добавьте действие Code (логическая функция)
  2. Создайте новую функцию с кодом ниже
  3. Настройте входные параметры

Входные параметры

ПараметрЗначение
companyId{{trigger.object.id}}
Если прикрепляете к другому объекту (Person, Opportunity и т. д.), переименуйте параметр соответствующим образом (например, personId, opportunityId) и обновите логическую функцию.

Код логической функции

Шаг 3: Настройте под ваш сценарий

Чтобы прикреплять к другому объекту

Замените targetCompanyId на соответствующее поле:
ОбъектИмя поля
КомпанияtargetCompanyId
КонтактtargetPersonId
СделкаtargetOpportunityId
Пользовательский объектtargetYourCustomObjectId
Обновите и параметр функции, и объект variables.data в мутации вложения.

Чтобы использовать динамический URL PDF

Если используете сервис генерации PDF, вы можете:
  1. Сначала выполните действие HTTP Request, чтобы сгенерировать PDF
  2. Передайте возвращенный URL PDF в логическую функцию как параметр

Шаг 4: Протестируйте и активируйте

  1. Сохраните рабочий процесс
  2. Перейдите к записи Company
  3. Нажмите меню и выберите ваш рабочий процесс
  4. Проверьте раздел Attachments в записи, чтобы убедиться, что PDF прикреплен
  5. Активируйте рабочий процесс

Совмещение с сервисами генерации PDF

Для создания динамических коммерческих предложений или счетов:

Пример: Сгенерировать коммерческое предложение → Прикрепить PDF

ШагДействиеНазначение
1Ручной триггер (Company)Пользователь запускает на записи
2Поиск записиПолучить сведения о сделке или позициях
3HTTP-запросВызвать API генерации PDF с данными записи
4Бессерверная функцияСкачать и прикрепить сгенерированный PDF

Популярные сервисы генерации PDF

  • Carbone — генерация документов на основе шаблонов
  • PDFMonkey — динамическое создание PDF из шаблонов
  • DocuSeal — платформа автоматизации документооборота
  • Documint — генерация документов, ориентированная на API
Каждый сервис предоставляет API, который возвращает URL PDF; затем его можно передать в логическую функцию.

Устранение неполадок

ПроблемаРешение
”Не удалось скачать PDF”Проверьте, что URL PDF доступен и возвращает корректный PDF
”Не удалось загрузить”Убедитесь, что ваш ключ API действителен и имеет права на запись
”Не удалось создать вложение”Убедитесь, что имя поля идентификатора объекта соответствует целевому объекту

Связанные материалы