ClickUp Lead Sync
MonoChat 대화에서 나온 리드와 주문을 ClickUp 작업으로 만들고, 팀이 ClickUp에서 변경한 내용을 MonoChat으로 다시 가져옵니다. 고객에게 보내는 메시지, 메모, 태그, 플로우용 이벤트, 프로필 필드, 댓글까지 반영됩니다.
개요
ClickUp Lead Sync는 MonoChat 대화를 사용 중인 ClickUp과 연결합니다. 채팅에서 나온 리드와 주문이 팀의 업무 방식대로 채워진 ClickUp 작업이 되고, 팀이 ClickUp에서 변경한 내용은 MonoChat으로 돌아옵니다. 고객에게 보내는 메시지, 팀을 위한 메모, 태그, 자체 플로우용 이벤트, 프로필 필드, 댓글로 반영됩니다.
어떤 대화를 리드로 만들지(Lead rules, 리드 규칙), 주문을 어디로 보내고 결제 여부를 어떻게 확인할지(Order flow, 주문 흐름), ClickUp에서 변경이 생기면 MonoChat이 무엇을 할지(Reactions, 반응)를 직접 정합니다. Today(오늘)와 Activity(활동) 화면에서 앱이 수행한 모든 작업을 확인할 수 있으며, 모든 대화 옆의 ClickUp 카드에서 고객의 작업을 볼 수 있습니다.
주요 특징
- 채팅이 ClickUp 리드로. 새 대화, 신규 고객의 첫 메시지, 태그, 프로필 필드, Lead Ads 양식 또는 AI 어시스턴트가 선택한 리스트에 작업을 만듭니다. 같은 고객에게 해당 규칙으로 만들어진 열린 작업이 이미 있으면, 새 작업 대신 기존 작업에 댓글을 추가합니다.
- ClickUp이 움직이면 MonoChat이 응답합니다. 작업 상태가 지정한 상태로 바뀌거나, 필드 조건이 충족되거나, 주문이 결제되면 MonoChat이 고객에게 메시지를 보내고, 팀을 위한 메모를 남기고, 태그를 추가하거나 제거하고, 대화를 배정하거나 종료하고, 커스텀 이벤트로 플로우를 시작할 수 있습니다.
- 필드와 댓글을 양방향으로. 매핑한 이름, 전화번호, 이메일, CRM 프로필 필드는 Both ways(양방향)로 설정할 수 있어, 한쪽에서 변경하면 다른 쪽도 업데이트됩니다. 새 ClickUp 댓글은 대화 속 메모가 되고, 팀이 고객에게 추가한 메모는 열린 작업의 댓글이 됩니다.
- 안전하게 체험하기. Test mode(테스트 모드)와 개별 규칙 또는 반응의 Whisper only(내부 메모 전용)에서는 ClickUp에 아무것도 기록되지 않고 고객에게도 아무것도 발송되지 않습니다. 모든 단계가 대화에 whisper(내부 메모)로 기록됩니다.
시작하기 전에
다음이 필요합니다.
- ClickUp 개인 API 토큰. 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 요청 1건을 사용합니다. ClickUp이 속도를 늦춰 달라고 요청하면 작업이 대기했다가 자동으로 이어집니다.
ClickUp Free 요금제에서는 커스텀 필드를 제한된 횟수만 사용할 수 있습니다. 한도에 도달해도 앱은 작업을 만들고, 필드 값을 작업 설명에 적은 뒤 Today(오늘) 화면에서 알려 드립니다.
설치 및 설정
- 설정 › MonoStore › 앱에서 ClickUp Lead Sync를 설치하거나 설치 링크 app.monochat.ai/apps/v3SaNfhuHhuXb4Hrx를 여세요. MonoChat 계정이 없다면 링크에서 먼저 가입할 수 있으며, 앱은 자동으로 설치됩니다.
- ClickUp 데스크(왼쪽 메뉴의 ClickUp 아이콘)를 여세요. Connection(연결)에서 ClickUp API token(ClickUp API 토큰)을 붙여 넣고 Test(테스트)를 클릭한 뒤, 리스트가 있는 Workspace(워크스페이스)를 선택하고 Save(저장)를 클릭합니다.
- Lead rules(리드 규칙)에서 New lead rule(새 리드 규칙)을 클릭하세요. 트리거, 필터, ClickUp 리스트와 작업을 채우는 방식을 선택하고 Save를 클릭합니다.
- 선택 사항: Order flow(주문 흐름)에서 주문 리스트와 주문 결제를 앱이 확인하는 방식을 선택합니다.
- 선택 사항: Reactions(반응)에서 New reaction(새 반응)을 클릭해 ClickUp에서 작업이 변경될 때 MonoChat이 할 일을 정합니다.
- 먼저 실제 대화에서 모든 기능을 시험해 보려면 General(일반)에서 Test mode(테스트 모드)를 켜세요. 그런 다음 데스크 헤더의 초록색 전원 버튼을 클릭하고 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(전화번호나 이메일 없음), 24-hour window closed and no template(24시간 창이 닫혔고 템플릿 없음)), 그리고 Error(오류)와 ClickUp이 보낸 내용, 앱이 Will try again(다시 시도 예정)인지 Gave up(중단)인지.

Leads
ClickUp › Leads(리드)에는 앱이 알고 있는 리드 작업이 표시됩니다. 앱이 만든 작업과 전화번호나 이메일로 연결한 작업입니다. Open(열림), Closed(닫힘), All(전체) 또는 규칙별(Every rule, 모든 규칙)로 필터링할 수 있습니다. 각 행에는 작업 이름, ClickUp 상태, 고객, 리스트, 규칙, 시작 계기(예: New conversation(새 대화) 또는 AI assistant(AI 어시스턴트)), 앱이 추가한 댓글 수가 표시됩니다.

연필 아이콘을 누르면 리드가 열립니다. 리스트, 규칙, 고객(전화번호와 이메일), 앱이 작업을 만든 시점과 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(내부 메모 전용)를 설정합니다. Whisper only에서는 ClickUp에 아무것도 기록되지 않고, 만들어질 작업이 대화에 whisper(내부 메모)로 표시됩니다.

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”(AI 어시스턴트가 “Send to ClickUp” 호출) | AI 어시스턴트가 Send the lead to the team (ClickUp) 도구로 수집한 요약, 관심 사항, 연락처와 함께 리드를 넘길 때. |
| Lead Ads form submitted(Lead Ads 양식 제출) | 누군가 Facebook 또는 Instagram Lead Ads 양식을 작성할 때. |
| Only by hand (from the conversation)(수동으로만, 대화에서) | 팀이 ClickUp 카드에서 Send as lead(리드로 보내기)를 클릭할 때. |
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(이메일 주소) 또는 A phone number or an e-mail(전화번호 또는 이메일)과 Wait for it up to (minutes)(최대 대기 시간, 분). 앱은 그동안 메시지와 프로필을 지켜봅니다. 0이면 바로 건너뜁니다.
- Comment instead of a new task within (days)(다음 기간 내에는 새 작업 대신 댓글, 일): 이 고객에게 최근 해당 일수 안에 이 규칙으로 만들어진 열린 작업이 있으면 그 작업에 댓글을 추가합니다. 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)(대화 담당 상담원, ClickUp에서 같은 이메일)), Task tags(작업 태그).

Fields(필드)는 MonoChat 값을 ClickUp 커스텀 필드에 매핑합니다. 각 행에서 MonoChat value(MonoChat 값: 이름, 이름(First name), 전화번호, 이메일, 채널, 유입 경로 또는 광고, 첫 메시지, 대화 링크, 배정된 상담원, 태그, CRM profile field(CRM 프로필 필드), Lead form answer(리드 양식 답변), AI summary(AI 요약) 또는 AI: interest(AI: 관심 사항), 날짜 또는 Fixed text(고정 텍스트)), ClickUp field(ClickUp 필드), Direction(방향)을 선택합니다.
- MonoChat → ClickUp: 작업이 만들어질 때 값이 기록됩니다.
- Both ways(양방향, 이름, 전화번호, 이메일, CRM 프로필 필드): 팀이 ClickUp에서 필드를 변경하면 MonoChat의 고객 프로필이 업데이트됩니다(드롭다운 옵션은 일치하는 프로필 옵션으로, 날짜는 해당 날짜로, 체크박스는 예 또는 아니요로). MonoChat에서 변경하면 열린 작업이 업데이트됩니다. 앱이 방금 기록한 값은 다시 되돌려 보내지 않습니다.
필드에 맞지 않는 값(숫자 필드의 단어, 드롭다운에 없는 옵션)은 비워 두고 Activity(활동)에 표시합니다. Link tasks made in ClickUp by phone / e-mail(ClickUp에서 만든 작업을 전화번호/이메일로 연결)은 누군가 이 리스트에 만든 작업을, 매핑된 필드의 전화번호나 이메일을 가진 MonoChat 고객과 연결하여 그 작업에도 반응이 작동하게 합니다.

Reactions
ClickUp › Reactions(반응)는 ClickUp에서 무언가 변경될 때 MonoChat이 할 일을 정합니다. 반응은 앱이 알고 있는 작업, 즉 앱이 만든 작업과 전화번호나 이메일로 연결한 작업에서 작동합니다. 각 행에는 리스트, 조건, 수행 내용, 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(고객에게 보내는 메시지): 플레이스홀더
{name}{firstName}{task}{status}{orderNo}{amount}{url}{field:Field name}를 사용하는 Send a message(메시지 보내기). 채널이 허용하는 동안에는 자유 메시지로 보냅니다(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(ClickUp API 토큰)과 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명령이 표시됩니다. 호출에는 MonoChat 사용자 API 토큰과 앱 키, 고객의 전화번호·이메일 또는 ID, 금액이 필요하며, 주문 번호, 통화, 품목, 결제 수단, 주소, 참조 번호는 선택 사항입니다. 같은 참조 번호는 한 번만 기록됩니다.
- When MonoChat or your system says paid, the app marks the task(MonoChat 또는 자체 시스템이 결제를 알리면 앱이 작업에 표시): 상태를 설정하고, 원하면 체크박스도 선택합니다.
팀은 대화 옆 ClickUp 카드에서 Create order(주문 만들기)를 클릭할 수도 있습니다. 해당 고객의 미결제 주문 작업이 만들어지고, 결제가 들어오면 결제 완료로 표시됩니다.

General
ClickUp › General(일반):
| 설정 | 기능 |
|---|---|
| Test mode(테스트 모드) | ClickUp에 아무것도 기록되지 않고 고객에게도 아무것도 발송되지 않습니다. 모든 작업, 댓글, 메시지, 변경 사항이 대화에 whisper(내부 메모)로 기록됩니다. 실제 운영하려면 끄세요. |
| Read ClickUp every(ClickUp 읽기 간격) | 1분, 5분 또는 15분. 한 번 읽을 때마다 리스트당 ClickUp 요청 1건을 사용합니다(변경된 작업이 많으면 더 많이 사용). |
| 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)(다음 기간 내에는 새 작업 대신 댓글, 일)에서 설정한 기간 안에는 앱이 고객의 열린 작업에 댓글을 추가합니다.
메시지를 보낼 수 없으면 어떻게 되나요? 24시간 창이 지나면 앱은 선택한 WhatsApp 템플릿을 사용합니다. 자유 메시지도 템플릿도 보낼 수 없거나 고객에게 수신 거부 태그가 있으면, 해당 단계는 건너뛰고 Activity(활동)에 표시됩니다.
ClickUp이나 고객에게 영향을 주지 않고 체험할 수 있나요? 네. General(일반)에서 Test mode(테스트 모드)를 켜거나, 개별 규칙 또는 반응에서 Whisper only(내부 메모 전용)를 켜세요. 모든 내용이 대화에 whisper(내부 메모)로 기록됩니다.