구글 스프레드시트

1. [채널 설정] - [앱스토어]에서 Google Spreadsheet 앱을 설치해 주세요.

2. 채널톡과 연동할 구글 계정을 선택합니다.

3. 내용을 확인 후 [액세스 허용]을 눌러주세요.

4. 접근 권한을 부여할 스프레드 시트를 선택해 주세요.

   • 한 번 접근 권한을 부여한 스프레드 시트는 해제가 불가합니다.

5. 다음과 같이 연동 상태를 확인할 수 있어요.

   • [스프레드시트 연동] 탭: 접근 권한이 부여된 스프레드 시트를 확인합니다.

   • [설정] 탭: '연동 완료' 여부를 확인합니다.

1. [채널 설정] - [앱스토어] - [Google Spreadsheet] - [설정]에서 - 더보기(⋮)를 클릭합니다.

2. '연동 해제' 후 다시 연동 과정을 진행해 주세요.

3. 접근 권한을 부여할 스프레드 시트를 추가로 선택해 주시면 됩니다.

1. [AI → 설정 → 태스크] 단계에서 '함수'를 클릭해주세요.

2. 함수 단계에서 보여지는 목록 중 원하는 함수를 선택해주세요.

[함수 목록]

• append_row

  • 시트 마지막에 새 행 추가

  • 추가된 행의 위치 반환

  • append_row를 활용하여 여러 정보를 한 행에 기록하려면 함수 단계 앞에 데이터를 배열 형태의 문자열(JSON string)로 가공하는 과정이 필요합니다.

    1) 함수 단계 앞에 에이전트 노드 또는 코드 노드 추가를 권장 드리며,

    ["값1", "값2", "값3"]형태의 JSON string을 생성해주세요.

    2) 결과값을 append_row 의 values 필드에 매핑합니다.

• get_rows_by_index

  • 지정된 행 범위의 데이터를 2차원 배열로 반환

• get_row_by_key

  • 지정된 컬럼에서 키 값과 일치하는 첫 번째 행 반환 (중복 시 warning 포함)

• get_row_count

  • 시트의 데이터가 있는 총 행 수 반환 (A:ZZ 범위 기준)

• update_row_by_index

  • 지정된 행을 새 값으로 덮어쓰기

• update_row_by_key

  • 키 값으로 행을 검색하여 첫 번째 매칭된 행을 업데이트 (중복 시 warning 포함)

• delete_rows_by_index

  • 지정된 행 범위를 삭제. 삭제된 행 수 반환

• delete_row_by_key

  • 키 값으로 행을 검색하여 첫 번째 매칭된 행을 삭제 (중복 시 warning 포함)

• list_sheets

  • 스프레드시트 내 모든 시트 정보 조회

• list_spreadsheets

  • Google Drive에서 접근 가능한 스프레드시트 목록 조회

  • folderId가 있으면 해당 폴더 내로 필터링

[AI CoS] 탭 클릭 후 CoS에게 구글 스프레드시트 함수 실행을 요청할 수 있어요.

• 예시) "상담 내용을 요약해서 {시트 링크 or 시트명}에 등록해 줘"

• 예시) "{시트 링크 or 시트명}에서 주문번호 20260831014 행 찾아서 배송 상태 알려줘"

• 예시) "{시트 링크 or 시트명}에서 이 고객 행의 처리 상태를 '완료'로 바꿔줘"

더 상세한 내용이 소개된 CoS 상황별 가이드도 참고해 보세요.