ClickUp Lead Sync
Превращает лиды и заказы из ваших диалогов в MonoChat в задачи ClickUp и возвращает в MonoChat то, что ваша команда меняет в ClickUp: сообщение клиенту, заметку, тег, событие для ваших сценариев, поля профиля и комментарии.
Обзор
ClickUp Lead Sync связывает ваши диалоги в MonoChat с вашим ClickUp. Лиды и заказы из чатов становятся задачами ClickUp, заполненными так, как привыкла работать ваша команда, а то, что команда меняет в ClickUp, возвращается в MonoChat: сообщение клиенту, заметка для команды, тег, событие для ваших собственных сценариев, поля профиля и комментарии.
Вы решаете, какие диалоги становятся лидами (Lead rules, правила лидов), куда попадают заказы и как приложение узнаёт об их оплате (Order flow, поток заказов), и что делает MonoChat, когда что-то меняется в ClickUp (Reactions, реакции). Экраны Today («Сегодня») и Activity (активность) показывают всё, что сделало приложение, а карточка ClickUp рядом с каждым диалогом показывает задачи клиента.
Основные возможности
- Чаты становятся лидами в ClickUp. Новый диалог, первое сообщение нового клиента, тег, поле профиля, форма Lead Ads или ваш ИИ-ассистент создают задачу в выбранном вами списке. Если у этого клиента уже есть открытая задача по этому правилу, приложение добавляет к ней комментарий вместо новой задачи.
- ClickUp меняется — MonoChat отвечает. Когда задача переходит в выбранный вами статус, выполняется условие по полю или заказ оплачен, MonoChat может написать клиенту, оставить заметку для команды, добавить или снять теги, назначить или закрыть диалог либо запустить ваши сценарии с помощью пользовательского события.
- Поля и комментарии в обе стороны. Для сопоставленного имени, телефона, e-mail или поля CRM-профиля можно выбрать Both ways (в обе стороны) — тогда изменение на одной стороне обновляет другую. Новый комментарий в ClickUp становится заметкой в диалоге, а заметка, которую команда добавляет к клиенту, — комментарием к открытой задаче.
- Безопасная проверка. В режиме Test mode (тестовый режим), а также с Whisper only (только внутренняя заметка) на отдельном правиле или реакции ничего не записывается в ClickUp и ничего не отправляется клиентам: каждый шаг записывается в диалог как внутренняя заметка.
Перед началом
Вам понадобятся:
- Персональный API-токен ClickUp. В ClickUp: ваш аватар › Settings › Apps › API Token › Generate (или Copy). Он начинается с
pk_. Приложение действует от имени этого человека: задачи и комментарии появляются под его именем. - Список ClickUp для лидов и, если нужен поток заказов, список для заказов.
- Подключённый канал в MonoChat (WhatsApp, Instagram, Messenger, веб-чат …). Чтобы писать клиентам после окончания 24-часового окна, нужен одобренный шаблон WhatsApp в этом канале.
ClickUp не может сам обращаться к MonoChat, поэтому приложение считывает изменения в используемых списках каждые 1, 5 или 15 минут (General › Read ClickUp every, «Общие › Читать ClickUp каждые»). Каждое считывание тратит один запрос к ClickUp на список. Когда ClickUp просит приложение снизить темп, работа ставится на паузу и продолжается сама.
На бесплатном плане ClickUp (Free) пользовательские поля можно использовать ограниченное число раз. Когда лимит исчерпан, приложение всё равно создаёт задачу, записывает значения полей в её описание и сообщает об этом на экране Today («Сегодня»).
Установка и настройка
- Установите ClickUp Lead Sync в разделе Настройки › MonoStore › Приложения или откройте ссылку для установки app.monochat.ai/apps/v3SaNfhuHhuXb4Hrx. Если у вас ещё нет аккаунта MonoChat, по ссылке можно сначала зарегистрироваться, и приложение установится автоматически.
- Откройте стол ClickUp (значок ClickUp в меню слева). В разделе Connection (подключение) вставьте ClickUp API token (API-токен ClickUp), нажмите Test (проверить) и выберите Workspace (рабочее пространство) со своими списками. Нажмите Save (сохранить).
- В разделе Lead rules (правила лидов) нажмите New lead rule (новое правило лида): выберите триггер, фильтры, список ClickUp и то, как заполняется задача. Нажмите Save.
- По желанию: в разделе Order flow (поток заказов) выберите список заказов и то, как приложение узнаёт, что заказ оплачен.
- По желанию: в разделе Reactions (реакции) нажмите New reaction (новая реакция), чтобы задать, что делает MonoChat, когда задача меняется в ClickUp.
- Включите Test mode (тестовый режим) в разделе General (общие), если хотите сначала всё проверить на реальных диалогах. Затем нажмите зелёную кнопку питания в заголовке стола и Turn on («Включить»). Значок рядом с названием сменится с Off (выкл.) на On (вкл.).
Загрузите Sample data (демо-данные), чтобы увидеть все экраны заполненными ещё до первого лида. Демо-данные никогда не записываются в ClickUp и ничего не отправляют; Remove sample data (удалить демо-данные) убирает все демонстрационные строки и оставляет ваши реальные правила, реакции и задачи.
Экран за экраном
Приложение находится в столе ClickUp в меню слева: Today («Сегодня»), Leads (лиды), Orders (заказы), Lead rules (правила лидов), Reactions (реакции) и Activity (активность), а затем настройки: Connection (подключение), Order flow (поток заказов), General (общие) и Sample data (демо-данные). На снимках ниже показаны демо-данные.
Начать работу
Вкладка Начать работу на вашей главной странице добавляет карточку Set up ClickUp Lead Sync (Настройте ClickUp Lead Sync) с пятью шагами: 1. Connect ClickUp (подключите ClickUp), 2. Your first lead rule (ваше первое правило лида), 3. Orders (optional) (заказы, по желанию), 4. A reaction (optional) (реакция, по желанию) и 5. Turn it on (включите). У каждого шага есть кнопка, открывающая нужный экран, а Next (далее) переходит к следующему шагу.
Заголовок стола
В заголовке рядом с названием показано On (вкл.) или Off (выкл.). Кнопка питания открывает панель Turn ClickUp Lead Sync on (Включить ClickUp Lead Sync): в ней перечислено, что готово и чего не хватает (A ClickUp token — токен ClickUp, A ClickUp workspace — рабочее пространство ClickUp, A lead rule — правило лида, The order flow (optional) — поток заказов, по желанию, A reaction (optional) — реакция, по желанию), и она включает приложение. После включения начинают работать правила лидов, поток заказов и реакции.
Today
ClickUp › Today («Сегодня») открывается сводкой: сколько лидов и заказов отправлено в ClickUp сегодня, сколько заказов оплачено, сколько реакций сработало и сколько сообщений ушло. Ниже — состояние приложения (включено или выключено), ещё не выполненные шаги настройки и последние события с меткой для каждого:
- Task created (задача создана), Task linked (задача связана), Comment added (комментарий добавлен): что приложение сделало в ClickUp.
- Order paid (заказ оплачен), Reaction (реакция), Message sent (сообщение отправлено): что произошло, когда изменился ClickUp или платёж.
- Note from ClickUp (заметка из ClickUp), Profile updated from ClickUp (профиль обновлён из ClickUp): вернувшиеся комментарии и поля.
- Skipped (пропущено) с причиной (например, No phone or e-mail — нет телефона или e-mail, или 24-hour window closed and no template — 24-часовое окно закрыто и нет шаблона) и Error (ошибка) с ответом ClickUp и пометкой, Will try again (повторит попытку) приложение или Gave up (прекратило попытки).
Leads
ClickUp › Leads (лиды) показывает задачи-лиды, известные приложению: созданные им и связанные по телефону или e-mail. Фильтруйте по Open (открытые), Closed (закрытые) или All (все), либо по правилу (Every rule — все правила). В каждой строке — название задачи, её статус в ClickUp, клиент, список, правило, что её запустило (например, New conversation — новый диалог, или AI assistant — ИИ-ассистент) и сколько комментариев добавило приложение.
Карандаш открывает лид: список, правило и клиент (телефон и e-mail), когда приложение создало его и когда последний раз считывало из ClickUp, а также его Activity (активность): созданная задача, добавленные комментарии, заметки из ClickUp и поля профиля, обновлённые из ClickUp.
Orders
ClickUp › Orders (заказы) показывает задачи-заказы: Not paid (не оплачены), Paid (оплачены) или All (все). В каждой строке — номер заказа, клиент, сумма, статус задачи в ClickUp и время оплаты.
Lead rules
ClickUp › Lead rules (правила лидов) определяет, какие диалоги становятся задачами ClickUp. Каждое активное правило, триггер и фильтры которого подходят диалогу, создаёт собственную задачу. В каждой строке — триггер, список, фильтры и сколько задач, комментариев и ошибок дало правило. Карандашом правило редактируется, значком питания включается или выключается, корзиной удаляется. New lead rule (новое правило лида) добавляет правило.
Форма правила лида
В верхней части формы задаются название правила, его Order (порядок; меньшее значение идёт первым), Active (активно) и Whisper only (только внутренняя заметка: в ClickUp ничего не записывается, а внутренняя заметка в диалоге показывает задачу, которая была бы создана).
When (когда) — это триггер:
| Триггер | Когда создаётся задача |
|---|---|
| New conversation (also returning customers) (новый диалог, в том числе с вернувшимися клиентами) | Открывается диалог. |
| New customer’s first message (первое сообщение нового клиента) | Кто-то пишет вам впервые. |
| Tag added (тег добавлен) | К клиенту добавляется выбранный вами тег. |
| Profile field filled or equal to a value (поле профиля заполнено или равно значению) | Поле профиля заполняется или получает выбранное вами значение. |
| The AI assistant calls “Send to ClickUp” (ИИ-ассистент вызывает «Send to ClickUp») | Ваш ИИ-ассистент передаёт лид с помощью инструмента Send the lead to the team (ClickUp) (передать лид команде) вместе с резюме, интересом клиента и собранными контактными данными. |
| Lead Ads form submitted (форма Lead Ads отправлена) | Кто-то заполняет форму Facebook или Instagram Lead Ads. |
| Only by hand (from the conversation) (только вручную, из диалога) | Ваша команда нажимает Send as lead (отправить как лид) в карточке ClickUp. |
Only when (только если) сужает условия:
- Channels (каналы): пустое значение означает все каналы.
- Source (источник): Any source (любой источник), Ad click (referral) (клик по рекламе), Organic (no ad) (органика, без рекламы) или Lead Ads form (форма Lead Ads).
- Keyword in the first message (ключевое слово в первом сообщении): несколько слов через запятую, подходит любое из них.
- Only within business hours (только в рабочие часы): часы задаются в разделе General (общие).
- Needs (требуется): Nothing (ничего), A phone number (номер телефона), An e-mail address (адрес e-mail) или A phone number or an e-mail (телефон или e-mail), с параметром Wait for it up to (minutes) (ждать до N минут). Тем временем приложение следит за сообщениями и профилем; при 0 шаг сразу пропускается.
- Comment instead of a new task within (days) (комментарий вместо новой задачи в течение N дней): если у клиента есть открытая задача по этому правилу, созданная за последние дни, к ней добавляется комментарий. При 0 всегда создаётся новая задача.
ClickUp list (список ClickUp) определяет, куда попадает задача и как она заполняется:
- Space, Folder и List (пространство, папка и список).
- Task name (название задачи) и Task description (описание задачи) с подстановками:
{name}{firstName}{phone}{email}{channel}{source}{date}{firstMessage}{conversationLink}{agent}{tags}{summary}{interest}{notes}{answers}. - Status (статус; если пусто — первый статус списка), Priority (приоритет), Assignee (исполнитель: Nobody — никто, A fixed ClickUp member — фиксированный участник ClickUp, или The conversation’s agent (same e-mail in ClickUp) — оператор диалога, с тем же e-mail в ClickUp) и Task tags (теги задачи).
Fields (поля) сопоставляет значения MonoChat с пользовательскими полями ClickUp. Для каждой строки выберите MonoChat value (значение MonoChat: имя, имя без фамилии, телефон, e-mail, канал, источник или объявление, первое сообщение, ссылка на диалог, назначенный оператор, теги, CRM profile field — поле CRM-профиля, Lead form answer — ответ формы лида, AI summary — резюме ИИ или AI: interest — интерес по оценке ИИ, дата или Fixed text — фиксированный текст), ClickUp field (поле ClickUp) и Direction (направление):
- MonoChat → ClickUp: значение записывается при создании задачи.
- Both ways (в обе стороны; для имени, телефона, e-mail и полей CRM-профиля): когда команда меняет поле в ClickUp, обновляется профиль клиента в MonoChat (вариант раскрывающегося списка становится соответствующим вариантом профиля, дата — днём, флажок — «да» или «нет»); когда поле меняется в MonoChat, обновляется открытая задача. Значение, которое приложение только что записало, обратно не отправляется.
Значение, которое не подходит полю (слово в числовом поле, вариант, которого нет в раскрывающемся списке), остаётся пустым и указывается в Activity (активность). Link tasks made in ClickUp by phone / e-mail (связывать задачи, созданные в ClickUp, по телефону / e-mail) связывает задачу, которую кто-то создал в этом списке, с клиентом MonoChat, чей телефон или e-mail указан в сопоставленном поле, — так для неё тоже работают реакции.
Reactions
ClickUp › Reactions (реакции) определяет, что делает MonoChat, когда что-то меняется в ClickUp. Реакции работают с задачами, известными приложению: созданными им и связанными по телефону или e-mail. В каждой строке — список, условие, действие, Once per task (один раз на задачу) или каждый раз, а также сколько раз реакция сработала, отправила сообщение или была пропущена.
В форме реакции:
- When (когда): List (список), затем Condition (условие): The status becomes (статус становится) выбранным вами статусом, A field condition (условие по полю: отмечен флажок, поле заполнено, раскрывающийся список содержит вариант, число больше 0) или The order is paid (заказ оплачен). How often (как часто): Once per task (один раз на задачу) или Every time it becomes true (каждый раз, когда условие выполняется).
- Message to the customer (сообщение клиенту): Send a message (отправить сообщение) с подстановками
{name}{firstName}{task}{status}{orderNo}{amount}{url}{field:Field name}. Оно отправляется как свободное сообщение, пока канал это позволяет (WhatsApp, Messenger, Instagram: 24 часа после последнего сообщения клиента); иначе — When the window is closed: WhatsApp template from (когда окно закрыто: шаблон WhatsApp из) выбранного вами шаблона, либо шаг пропускается. Клиенты с тегом отказа от рассылок никогда его не получают.
- Also do (также сделать): Whisper for the team (внутренняя заметка для команды), Add tags и Remove tags (добавить и снять теги), Assign the conversation to (назначить диалог) команде или сотруднику, Custom event for your flows (пользовательское событие для ваших сценариев: запускаются ваши сценарии с узлом события с этим ключом, а задача передаётся в данных события; при пустом ключе —
clickup.paid) и Close the conversation (закрыть диалог).
Activity
ClickUp › Activity (активность) хранит 90 дней действий приложения: All (все), Tasks (задачи), Reactions (реакции), Skipped (пропущено) или Errors (ошибки). Каждое событие показывает задачу и клиента, что произошло и почему, а для ошибок — сколько было попыток. Всё, что не удалось, можно повторить.
Connection
ClickUp › Connection (подключение) хранит ClickUp API token (API-токен ClickUp) и Workspace (рабочее пространство). Вставьте токен, нажмите Test (проверить), чтобы увидеть список рабочих пространств, выберите одно и нажмите Save (сохранить).
Order flow
ClickUp › Order flow (поток заказов) превращает заказы в задачи в одном списке ClickUp. Когда заказ оплачен, открытая задача-заказ клиента отмечается как оплаченная (или создаётся оплаченная), и запускаются реакции на оплату. Поток заказов выключен, пока у него нет списка и источника информации об оплате.
- ClickUp list (список ClickUp): пространство, папка и список, название и описание задачи, статус нового заказа, приоритет, исполнитель, теги и сопоставление полей (сумма, валюта, товары, номер заказа, способ оплаты и референс платежа, адрес и данные клиента).
- When is an order paid? (когда заказ оплачен?) Один или несколько вариантов:
- MonoChat payments (платежи MonoChat): платёж по вашим платёжным ссылкам MonoChat отмечает открытый заказ клиента как оплаченный или создаёт оплаченный заказ.
- A condition in ClickUp (условие в ClickUp): ваша команда отмечает оплату в ClickUp (статусом или полем); приложение увидит это при следующем считывании.
- Your system (API) (ваша система, API): ваш магазин или платёжная система сообщает приложению. На экране показаны адрес, App key (ключ приложения) и готовая команда
curl. Для вызова нужны пользовательский API-токен MonoChat и ключ приложения, а также телефон, e-mail или id клиента и сумма; номер заказа, валюта, товары, способ оплаты, адрес и референс необязательны. Один и тот же референс учитывается один раз.
- When MonoChat or your system says paid, the app marks the task (когда MonoChat или ваша система сообщает об оплате, приложение отмечает задачу): задаёт статус и, по желанию, отмечает флажок.
Ваша команда также может нажать Create order (создать заказ) в карточке ClickUp рядом с диалогом: создаётся неоплаченная задача-заказ для этого клиента, которая отмечается как оплаченная, когда приходит платёж.
General
ClickUp › General (общие):
| Настройка | Что она делает |
|---|---|
| Test mode (тестовый режим) | В ClickUp ничего не записывается и клиентам ничего не уходит: каждая задача, комментарий, сообщение и изменение записываются в диалог как внутренняя заметка. Выключите его, чтобы начать работу по-настоящему. |
| Read ClickUp every (читать ClickUp каждые) | 1, 5 или 15 минут. Каждое считывание тратит один запрос к ClickUp на список (больше, если изменилось много задач). |
| Time zone (часовой пояс), Business hours: days (рабочие часы: дни), From (с), To (до) | Для правил лидов с Only within business hours (только в рабочие часы). |
| Language of the team notes (язык заметок для команды) | Язык внутренних заметок, которые пишет приложение. |
| Opt-out tags (теги отказа от рассылок) | Клиенты с любым из этих тегов никогда не получают сообщений от приложения. |
| Note in the conversation (заметка в диалоге) | Внутренняя заметка для команды со ссылкой на задачу, когда задача создана или к ней добавлен комментарий. |
| ClickUp comments → conversation note (комментарии ClickUp → заметка в диалоге) | Новый комментарий к связанной задаче (не написанный приложением) становится заметкой в последнем диалоге клиента. |
| Customer notes → ClickUp comment (заметки о клиенте → комментарий в ClickUp) | Заметка, которую команда добавляет к клиенту (карточка Заметки рядом с диалогом), публикуется как комментарий к открытой задаче клиента с именем автора. |
Карточка ClickUp рядом с диалогом
В разделе Входящие карточка ClickUp рядом с диалогом показывает задачи клиента, их статус и последний комментарий в ClickUp, с кнопкой Open in ClickUp (открыть в ClickUp). Команда может одним кликом выполнить Send as lead (отправить как лид; с выбором правила) или Create order (создать заказ). Пока приложение выключено или у клиента ещё нет задачи, карточка сообщает об этом.
Часто задаваемые вопросы
ClickUp обновляет MonoChat мгновенно? Нет. ClickUp не может сам обращаться к MonoChat, поэтому приложение считывает используемые списки каждые 1, 5 или 15 минут. Подключение через вход в ClickUp (OAuth) и мгновенные обновления запланированы.
Не получит ли один клиент много задач? Не по одному и тому же правилу: в течение дней, заданных в Comment instead of a new task within (days) (комментарий вместо новой задачи в течение N дней), приложение вместо этого добавляет комментарий к открытой задаче клиента.
Что происходит, если сообщение нельзя отправить? Вне 24-часового окна приложение использует выбранный вами шаблон WhatsApp. Если невозможно ни свободное сообщение, ни шаблон или у клиента есть тег отказа от рассылок, шаг пропускается и отображается в Activity (активность).
Можно ли попробовать, не затрагивая ClickUp и клиентов? Да. Включите Test mode (тестовый режим) в разделе General (общие) или Whisper only (только внутренняя заметка) на отдельном правиле или реакции: всё записывается в диалог как внутренняя заметка.