노션 앱을 설치하고 연동하면, 채널톡의 AI인 ALF 및 CoS가 노션 문서를 찾아 읽고, 새 페이지를 만들거나 기존 페이지를 수정할 수 있어요. 문서를 찾으러 노션을 오가지 않아도 채널톡 안에서 바로 확인하고 기록할 수 있게 됩니다.
노션 앱은 문서를 찾고, 읽고, 만들고, 고치는 함수 5개를 제공해요. 요청 내용에 맞는 함수가 실행되고, 읽어온 내용을 정리하거나 요약하는 일은 AI가 이어서 할 수 있어요.
1. 검색
제목과 본문에서 키워드로 문서를 찾아요. 연결한 계정이 접근할 수 있는 문서만 검색돼요. 의미를 추론하는 검색이 아니라서 긴 질문보다 '환불', 'ALF 도입'처럼 짧은 단어 검색이 적합해요.
2. 조회
노션 링크나 ID로 페이지, DB, 데이터 소스를 읽어요. DB는 어떤 속성이 있고 어떤 값을 넣을 수 있는지까지 확인할 수 있어요.
3. 페이지 생성
새 페이지나 DB 항목을 만들어요. 어디에 만들지 부모 페이지나 DB를 알려주면 되고, 알려주지 않으면 연동한 계정의 비공개 페이지로 만들어져요. 연동한 계정에 편집 권한이 있는 곳에만 만들 수 있어요.
4. 페이지 수정
제목, 본문, DB 항목 속성을 고쳐요. 문단 일부만 바꾸기, 맨 앞이나 맨 뒤에 추가하기, 전체 바꾸기 중 하나로 실행되니 어떻게 고칠지 함께 알려주면 정확해요. 연동한 계정에 편집 권한이 있는 문서만 고칠 수 있어요.
5. 작업 상태 조회
페이지를 만들거나 고치는 작업이 백그라운드로 진행될 때, 끝났는지 확인해요.
페이지 이동·복제·삭제·복원
DB 만들기와 속성 구조 바꾸기
DB 전체 행을 조건으로 조회하거나 집계하기
문서 공유 권한 변경과 웹 공개 설정
댓글 작성, 파일 업로드, 사용자 검색
페이지 템플릿 적용, 아이콘·커버 설정
노션 문서를 채널톡에 자동으로 동기화하거나 색인하기
채널톡 관리자 화면에서 좌측 하단 톱니바퀴 모양 [채널 설정] - [앱스토어]로 이동해 [Notion] 앱을 선택한 뒤, [설치]를 눌러주세요. 앱을 설치하기 위해서는 [일반 설정] 권한이 필요합니다.
설치가 끝나면 [설정] 탭으로 이동해주세요. 'Notion 연동'에 [채널 OAuth]와 [내 OAuth] 두 가지가 있어요. 아래를 보고 해당 항목의 [연동하기]를 진행해 주세요.
채널 OAuth: ALF 태스크에 노션을 활용하고 싶을 때 연동합니다. ALF가 상담에서 노션 문서를 읽거나 남길 때 이 계정으로 실행돼요. 채널 담당자가 한 번 연동하면 채널 전체에 적용돼요.
내 OAuth: 팀 멤버가 CoS에 노션 관련 작업을 요청할 때 연동합니다. CoS에 노션 작업을 요청할 때 이 계정으로 실행돼요. CoS에서 노션을 사용할 팀 멤버는 각자 연동해야 해요.
예를 들어, '채널 OAuth'만 연동해두면 ALF는 쓸 수 있어도 '내 OAuth' 연동이 없는 팀 멤버의 CoS 요청은 실행되지 않아요.
[연동하기] 버튼을 누르면 브라우저에서 노션 로그인 화면이 열려요. 사용할 워크스페이스와 허용할 내용을 확인한 뒤 연결을 마치면 됩니다.
채널톡으로 돌아와 앱 설정에서 연동 상태가 '연동 완료'인지 확인해 주시면 됩니다. 만약 계속 로딩 중인 화면이 보인다면 화면을 한 번 새로고침 한 후 확인해 주세요.
노션 앱은 쓰는 곳에 따라 방식이 달라요. 내가 직접 작업할 때는 CoS에 말로 요청하고, 고객 응대에 쓸 때는 ALF 태스크에 미리 설정해 주셔야 합니다.
채널웍스 상단이나 유저챗 우측 패널에서 [AI CoS]를 열고, 하고 싶은 일을 문장으로 말하면 돼요. 함수 이름은 몰라도 되고 대상 문서, 원하는 작업, 저장할 위치만 알려주면 돼요. 문서 링크를 알고 있다면 같이 넣어 요청해주는 것이 정확해요.
예시 1. 상담에서 확인한 피드백을 노션에 등록하기
방금 상담에서 받은 피드백을 '고객 피드백' DB에 새 항목으로 등록해줘. 요청 내용이랑 채널명 넣어줘.
어떤 속성에 무엇을 넣을지는 CoS가 DB를 먼저 읽어서 맞춰요.
예시 2. 흩어진 문서 찾아 정리하기
노션에서 'ALF 도입'을 검색해줘. 관련 문서를 읽고 준비 사항과 진행 순서를 정리해줘. 참고한 문서 링크도 알려줘.
검색은 짧은 핵심어일수록 잘 맞아요. 비슷한 제목의 문서가 여러 개라면 어떤 문서인지 짚어주세요.
예시 3. 정리한 내용을 새 페이지로 남기기
{노션 링크} 이 노션 페이지 아래에 'ALF 도입 체크리스트' 하위 페이지를 만들어줘. 목적, 준비 사항, 점검 항목으로 나눠 작성해줘.
부모 페이지 링크를 같이 넣어주세요. 저장 위치를 지정하지 않으면 내 노션 계정의 비공개 페이지로 만들어져요.
예시 4. 기존 문서 일부만 고치기
{노션 링크} 이 페이지의 '준비 사항'에 '상담 시나리오 점검'을 추가해줘. 다른 문단은 그대로 둬.
바꿀 부분을 콕 집어 말해주세요. 문서를 전부 다시 써달라고 하면 기존 본문이 새 내용으로 덮여요.
작업이 끝났는지는 꼭 확인해주세요. "처리 중"이라는 답변은 저장이 끝났다는 뜻이 아니에요. 완료 안내와 페이지 링크까지 받은 뒤, 실제 노션 페이지에서 내용이 반영됐는지 한 번 더 봐주세요.
ALF가 고객 응대 중 노션 문서를 찾아 읽고, 상담에서 확인한 내용을 노션에 남길 수 있어요. 단, 노션 앱 연동 후 ALF 태스크 내 함수 단계 세팅을 완료해야 동작합니다. (→ 태스크 가이드 확인하기)
설정 방법
채널톡 [고객] - [서포트] - [설정] - [태스크]에서 태스크 생성 또는 기존 태스크 수정
함수 단계 추가 후 아래 중 필요한 항목을 선택해 주세요.
문서 조회
검색 (search): 키워드로 노션 문서를 찾습니다. 특정 페이지나 DB 안으로 검색 범위를 좁힐 수 있어요.
[채널 OAuth]로 연동한 계정이 접근할 수 있는 문서만 검색됩니다.
의미를 추론하는 검색이 아니라, '환불'처럼 짧은 핵심어일수록 잘 맞아요.
노션 계정 설정에 따라 키워드 검색을 쓸 수 없는 경우가 있어요. 이때는 조회(fetch)에 문서 URL을 직접 지정해 주세요.
조회 (fetch): 노션 URL이나 ID로 페이지, DB, 데이터 소스를 읽습니다.
DB를 조회하면 항목을 만들 때 쓸 속성 이름과 입력할 수 있는 값을 확인할 수 있어요.
문서 생성·수정
페이지 생성 (createPages): 새 페이지나 DB 항목을 만듭니다. 저장할 부모 페이지나 DB를 태스크에 지정해 주세요.
저장 위치를 지정하지 않으면 연동한 채널 계정의 비공개 페이지로 만들어져요.
페이지 수정 (updatePage): 페이지 제목, 본문, DB 항목 속성을 수정합니다. 문단 일부만 바꾸기, 맨 앞이나 맨 뒤에 추가하기, 전체 바꾸기 중 하나로 동작해요.
전체 바꾸기는 기존 본문을 덮어씁니다.
작업 상태 조회 (getTask): 생성·수정이 백그라운드로 진행될 때 완료 여부를 확인합니다. 생성·수정 함수를 쓴다면 함께 선택해 주세요.
'처리 중(pending)'이면 잠시 뒤 다시 확인하고, '일부 처리(partial)'나 '확인 불가(unknown)'로 나오면 전체를 다시 실행하지 말고 노션 페이지부터 확인해 주세요.
완료를 확인하기 전에 같은 요청을 다시 보내면 페이지가 중복으로 만들어질 수 있어요.