github-actions[bot]
9bc5486d0d
Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
221 lines
15 KiB
Plaintext
221 lines
15 KiB
Plaintext
---
|
|
title: Интеграция внешнего инструмента
|
|
info: Эти рабочие процессы сосредоточены на передаче данных в Twenty и из него с помощью API вызовов и вебхуков.
|
|
image: /images/user-guide/integrations/plug.png
|
|
sectionInfo: Автоматизируйте процессы и интегрируйте с внешними инструментами
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/integrations/plug.png" alt="Header" />
|
|
</Frame>
|
|
|
|
Ниже приведены примеры рабочих процессов, которые вы можете внедрить для подключения Twenty к остальной части вашей системы.
|
|
|
|
## Data Ingestion Use Cases
|
|
|
|
### Отправки веб-форм
|
|
|
|
**Проблема**: Вам необходимо захватывать лиды с веб-форм, целевых страниц или контактных форм непосредственно в Twenty.
|
|
|
|
**Решение**: Используйте триггеры вебхуков для автоматического создания записей из отправленных форм.
|
|
|
|
**Настройка**:
|
|
|
|
- Create a workflow with a Webhook trigger
|
|
- Configure the webhook to expect form data (name, email, company, etc.)
|
|
- Set the webhook method to POST
|
|
- Определите ожидаемую структуру тела в триггере
|
|
|
|
**Trigger**: Webhook (POST request from your form)
|
|
|
|
**Действия**:
|
|
|
|
- Поиск записей для проверки существования человека/компании
|
|
- Ветка: Если существует → Обновите запись, если нет → Создайте запись
|
|
- Create Record for follow-up task assigned to sales rep
|
|
- Отправить email уведомление команде продаж
|
|
|
|
### Синхронизация данных продукта
|
|
|
|
**Проблема**: Вашей команде продаж необходима видимость использования продукта, данных о счетах или усвоении функций, хранящихся в вашем хранилище данных.
|
|
|
|
**Решение**: Регулярно синхронизируйте данные о продукте в Twenty, чтобы предоставить продавцам контекст по их учетным записям.
|
|
|
|
**Триггер**: По расписанию (ежедневно или еженедельно)
|
|
|
|
**Действия**:
|
|
|
|
- HTTP запрос к вашему API хранилища данных
|
|
- Действие кода для обработки и форматирования данных
|
|
- Используйте функцию Итератора для следующих шагов
|
|
- Поиск записей для нахождения соответствующих записей компаний
|
|
- Обновление записи для добавления метрик использования продукта
|
|
- Создать запись для задач, когда использование падает ниже порога
|
|
|
|
### Meeting Notes from Call Recorders
|
|
|
|
**Проблема**: Важные инсайты из звонков продаж теряются или не документируются надлежащим образом в CRM.
|
|
|
|
**Решение**: Автоматически создавайте заметки и действия из систем записи звонков.
|
|
|
|
**Триггер**: Вебхук (с платформы записи звонков)
|
|
|
|
**Действия**:
|
|
|
|
- Действие кода для извлечения резюме встречи и действий
|
|
- Поиск записей для нахождения связанной возможности или контакта
|
|
- Создать запись для заметки с резюме встречи
|
|
- Создать запись для действия по завершению задач на основании пунктов действий
|
|
- Отправить email участникам с резюме и следующими шагами
|
|
|
|
### Обогащение данных
|
|
|
|
**Проблема**: Ваши контактные и корпоративные записи не содержат важной демографической и фирмографической информации.
|
|
|
|
**Решение**: Автоматически обогащайте записи с использованием внешних поставщиков данных.
|
|
|
|
**Триггер**: Создана запись (объект Люди или Компании)
|
|
|
|
**Действия**:
|
|
|
|
- HTTP запрос к API обогащения
|
|
- Действие кода для обработки ответа обогащения
|
|
- Используйте функцию Итератора для следующих шагов
|
|
- Обновление записи с дополнительной информацией о компании/контакте
|
|
- Создать запись для задачи по продаже, если определен перспективный клиент высокой ценности
|
|
- Отправить email предупреждение, если обогащение выявляет ключевые сигналы покупателя
|
|
|
|
## Сценарии использования распределения данных
|
|
|
|
### Управление подписчиками рассылки
|
|
|
|
**Проблема**: Вы хотите отправлять маркетинговые email конкретным сегментам данных в вашем CRM с использованием специальных инструментов для email.
|
|
|
|
**Решение**: Экспортируйте списки подписчиков в вашу платформу для email-маркетинга по мере необходимости.
|
|
|
|
**Настройка**: Создайте в Twenty представление для всех получателей рассылки.
|
|
|
|
**Trigger**: Launch Manually (when no record is selected)
|
|
|
|
**Действия**:
|
|
|
|
- Поиск записей по критериям представления рассылки.
|
|
- Код действия для форматирования email-адресов для вашей email-платформы.
|
|
- HTTP-запрос для добавления подписчиков в ваш инструмент email-маркетинга.
|
|
- Создание записи для отслеживания кампании.
|
|
- Отправка email-подтверждения маркетинговой команде.
|
|
|
|
### Триггеры почтовых последовательностей.
|
|
|
|
**Проблема**: Вы хотите запускать сложные почтовые последовательности на основе событий CRM, используя специализированные инструменты автоматизации.
|
|
|
|
**Решение**: Отправляйте новых потенциальных клиентов или клиентов на вашу платформу автоматизации email при возникновении определенных событий.
|
|
|
|
**Триггер**: Создана запись (объект 'Люди' с определенными критериями)
|
|
|
|
**Действия**:
|
|
|
|
- Код действия для определения подходящей почтовой последовательности.
|
|
- HTTP-запрос для добавления контакта на платформу автоматизации email.
|
|
- Обновление записи для отслеживания зачисления в последовательность.
|
|
- Создание записи для последующего задания по мониторингу вовлеченности.
|
|
|
|
### Интеграция с оценкой лидов.
|
|
|
|
**Проблема**: Вам нужна сложная оценка лидов, которая объединяет данные CRM с внешними сигналами.
|
|
|
|
**Решение**: Отправляйте данные о лидах во внешние инструменты оценки или внедряйте логику оценки внутри рабочих процессов.
|
|
|
|
**Вариант 1 — Внешний инструмент**:
|
|
|
|
**Триггер**: Запись обновлена (объект 'Люди')
|
|
|
|
**Действия**:
|
|
|
|
- HTTP-запрос для отправки данных о лидах на платформу оценки.
|
|
- Код действия для обработки ответа с оценкой.
|
|
- Обновление записи с оценкой лида.
|
|
- Создание записи для задачи продаж, если оценка превышает порог.
|
|
|
|
**Вариант 2 — Внутренняя логика**:
|
|
|
|
**Триггер**: Запись обновлена (объект 'Люди')
|
|
|
|
**Действия**:
|
|
|
|
- Код действия с алгоритмом оценки (размер компании, отрасль, поведение).
|
|
- Обновление записи с рассчитанной оценкой.
|
|
- Отправка email-уведомления представителю продаж для лидов с высокой оценкой.
|
|
|
|
### Генерация счетов.
|
|
|
|
**Проблема**: Когда сделки закрываются, ваша система выставления счетов должна быть обновлена информацией о клиенте и сделке.
|
|
|
|
**Решение**: Автоматически отправляйте данные о сделках в вашу систему выставления счетов, когда возможности выиграны.
|
|
|
|
**Триггер**: Запись обновлена (объект 'Возможности', стадия = "Закрыта выиграна")
|
|
|
|
**Действия**:
|
|
|
|
- Поиск записей для получения полной информации о клиенте.
|
|
- Код действия для форматирования данных для системы выставления счетов.
|
|
- HTTP-запрос для создания клиента в биллинговой платформе.
|
|
- HTTP-запрос для генерации счета.
|
|
- Обновление записи для хранения ссылки на счет.
|
|
- Отправка email финансовой команде с деталями счета.
|
|
|
|
## Продвинутые интеграционные шаблоны.
|
|
|
|
### Двунаправленная синхронизация.
|
|
|
|
**Проблема**: Вам нужно обеспечить синхронизацию данных между Twenty и другой системой в обоих направлениях.
|
|
|
|
**Решение**: Сочетайте запланированные рабочие процессы с вебхуками для синхронизации в реальном времени.
|
|
|
|
**От Twenty к внешней системе**:
|
|
|
|
**Триггер**: Запись обновлена (любой релевантный объект)
|
|
|
|
**Действия**:
|
|
|
|
- HTTP-запрос для обновления внешней системы.
|
|
- Обновление записи для отслеживания состояния синхронизации и временной метки.
|
|
|
|
**От внешней системы к Twenty**:
|
|
|
|
**Триггер**: Вебхук (из внешней системы)
|
|
|
|
**Действия**:
|
|
|
|
- Поиск записей для нахождения соответствующей записи.
|
|
- Обновление записи с новыми данными из внешней системы.
|
|
- Создание записи для задачи разрешения конфликтов, если это необходимо.
|
|
|
|
### Многошаговая обработка данных.
|
|
|
|
**Проблема**: Данные из внешних источников требуют сложной обработки перед их использованием в Twenty.
|
|
|
|
**Решение**: Используйте кодовые действия для трансформации и проверки данных.
|
|
|
|
**Триггер**: Вебхук или по расписанию.
|
|
|
|
**Действия**:
|
|
|
|
- Код действия для проверки формата входящих данных.
|
|
- Код действия для трансформации структуры данных.
|
|
- Код действия для применения бизнес-правил и вычислений.
|
|
- Поиск записей для проверки на дубликаты.
|
|
- Создание или обновление записи с обработанными данными.
|
|
- Отправка email-уведомления при обнаружении проблем качества данных.
|
|
|
|
## Советы по внедрению.
|
|
|
|
- Храните ключи API безопасно в Настройки → API и Вебхуки.
|
|
- Используйте HTTPS для всех внешних API вызовов.
|
|
- Соблюдайте ограничения скорости API — используйте запланированные рабочие процессы, когда это возможно.
|
|
- Рассмотрите возможность выполнения пакетных обновлений "по расписанию", когда реальная обработка не требуется.
|
|
- Помните о лимите 100 параллельных рабочих процессов для одного рабочего пространства — используйте "групповую" доступность для ручных триггеров при обработке нескольких записей (см. [Характеристики рабочих процессов](/l/ru/user-guide/workflows/workflow-features) для подробностей).
|
|
- Тестируйте с образцами данных до активации рабочих процессов.
|
|
|
|
Для устранения проблем интеграции, смотрите наш [Руководство по устранению ошибок в рабочих процессах](/l/ru/user-guide/workflows/workflow-troubleshooting). Для помощи в реализации сложных интеграций, рассмотрите наши [Профессиональные услуги](/l/ru/user-guide/workflows/professional-services).
|