Обзор
В этом рабочем процессе используется Ручной триггер, чтобы пользователи могли по запросу создавать PDF для любой выбранной записи. За обработку отвечает Логическая функция:- Загрузка PDF по URL (из сервиса генерации PDF)
- Загрузка файла в Twenty
- Создание вложения, связанного с записью
Требования
Прежде чем настраивать рабочий процесс:- Создайте ключ API: перейдите в Настройки → APIs и создайте новый ключ API. Этот токен понадобится для логической функции.
- Настройте сервис генерации PDF (необязательно): если вы хотите динамически генерировать PDF (например, коммерческие предложения), используйте такие сервисы, как Carbone, PDFMonkey или DocuSeal, чтобы создать PDF и получить URL для скачивания.
Пошаговая настройка
Шаг 1: Настройте триггер
- Перейдите в Рабочие процессы и создайте новый рабочий процесс
- Выберите Ручной триггер
- Выберите объект, к которому нужно прикреплять PDF (например, Company или Opportunity)
Шаг 2: Добавьте логическую функцию
- Добавьте действие Code (логическая функция)
- Создайте новую функцию с кодом ниже
- Настройте входные параметры
Входные параметры
| Параметр | Значение |
|---|---|
companyId | {{trigger.object.id}} |
Если прикрепляете к другому объекту (Person, Opportunity и т. д.), переименуйте параметр соответствующим образом (например,
personId, opportunityId) и обновите логическую функцию.Код логической функции
Шаг 3: Настройте под ваш сценарий
Чтобы прикреплять к другому объекту
ЗаменитеtargetCompanyId на соответствующее поле:
| Объект | Имя поля |
|---|---|
| Компания | targetCompanyId |
| Контакт | targetPersonId |
| Сделка | targetOpportunityId |
| Пользовательский объект | targetYourCustomObjectId |
variables.data в мутации вложения.
Чтобы использовать динамический URL PDF
Если используете сервис генерации PDF, вы можете:- Сначала выполните действие HTTP Request, чтобы сгенерировать PDF
- Передайте возвращенный URL PDF в логическую функцию как параметр
Шаг 4: Протестируйте и активируйте
- Сохраните рабочий процесс
- Перейдите к записи Company
- Нажмите меню ⋮ и выберите ваш рабочий процесс
- Проверьте раздел Attachments в записи, чтобы убедиться, что PDF прикреплен
- Активируйте рабочий процесс
Совмещение с сервисами генерации PDF
Для создания динамических коммерческих предложений или счетов:Пример: Сгенерировать коммерческое предложение → Прикрепить PDF
| Шаг | Действие | Назначение |
|---|---|---|
| 1 | Ручной триггер (Company) | Пользователь запускает на записи |
| 2 | Поиск записи | Получить сведения о сделке или позициях |
| 3 | HTTP-запрос | Вызвать API генерации PDF с данными записи |
| 4 | Бессерверная функция | Скачать и прикрепить сгенерированный PDF |
Популярные сервисы генерации PDF
- Carbone — генерация документов на основе шаблонов
- PDFMonkey — динамическое создание PDF из шаблонов
- DocuSeal — платформа автоматизации документооборота
- Documint — генерация документов, ориентированная на API
Устранение неполадок
| Проблема | Решение |
|---|---|
| ”Не удалось скачать PDF” | Проверьте, что URL PDF доступен и возвращает корректный PDF |
| ”Не удалось загрузить” | Убедитесь, что ваш ключ API действителен и имеет права на запись |
| ”Не удалось создать вложение” | Убедитесь, что имя поля идентификатора объекта соответствует целевому объекту |