[태그:] ChatAPI

Google Chat 업무 연동을 운영한다면 카드 생성에 쓰는 사용자 인증과 카드 갱신에 쓰는 앱 인증을 구분해 확인하세요. Google은 2026년 10월 23일 Chat 앱이 사용자 명의로 카드 메시지를 만들고, 사용자 클릭 없이 해당 카드를 비동기로 갱신하는 지원을 일반 제공으로 발표했습니다. 이 글의 확인일은 10월 25일입니다.

일반 채팅창에 모든 사용자를 위한 새 카드 편집 버튼이 생겼다는 공지가 아닙니다. Chat API로 업무 연동을 만드는 담당자가 살필 변경입니다.

1. 이번 발표가 바꾸는 업무 흐름

공식 개발자 릴리스 노트의 대상은 Chat API v1입니다. 같은 날 발표된 앱 구성 관리의 Developer Preview와 구분해야 합니다. 카드 생성·갱신은 이번 글에서 다루는 일반 제공 항목이고, 별도의 미리보기 기능 가입이 필요하다고 혼동하지 않습니다.

예를 들어 업무 요청이 ‘접수 → 검토 → 완료’로 바뀌는 카드를 가정해 볼 수 있습니다. 이 예시는 기능을 어디에 쓸지 생각하는 가상 흐름이며, 우리 계정에 구현되었거나 자동화가 정상 작동했다는 사용 후기가 아닙니다.

2. 생성과 갱신에서 다른 조건

공식 카드 가이드는 생성 요청의 사용자 인증에 chat.messages.create 또는 chat.messages 범위를 안내하며, cardsV2 카드 데이터와 비동기 갱신에 필요한 cardId를 설명합니다. 갱신 메서드인 spaces.messages.replaceCards는 앱 인증과 chat.bot 범위를 요구합니다. 같은 인증 수단으로 모두 처리된다고 가정하지 마세요.

OAuth 사용자 인증은 동의 화면에서 요청 범위를 검토하는 과정과 연결됩니다. 이번 발표만으로 기존 앱의 권한이 자동 확장되었다고 판단할 수 없습니다. 운영 담당자는 필요한 작업과 현재 허용 범위를 대조하고 변경 절차를 정하세요. 이 글을 따라 토큰을 복사해 다른 사이트에 붙여 넣을 필요는 없습니다.

3. 기존 메시지라면 무엇이 제한될까

공식 가이드에 따르면 생성·갱신 때 앱이 해당 공간의 구성원이어야 합니다. 앱은 자신이 붙인 카드만 교체할 수 있고, 원래 카드가 없던 메시지에 이 메서드로 처음 카드를 붙일 수는 없습니다. 따라서 모든 과거 메시지가 새 상태판으로 바뀐다고 기대하지 마세요.

빈 카드 목록으로 교체하면 카드는 제거되며 이후 그 메시지에 다시 추가할 수 없다는 제한이 있습니다. 사용자가 메시지 본문을 수정할 때 앱 소유 카드가 제거되어 더 이상 갱신할 수 없다는 안내도 확인했습니다. 실제 운영 전에 삭제·본문 편집 상황을 검수 항목에 넣을 이유입니다.

4. 다음 업무를 위한 담당자 메모

가상의 점검 메모에 ‘앱 이름 / 적용할 공간 / 사용자 명의 생성 필요 여부 / 갱신 담당 / 기존 카드 포함 여부 / 본문 편집 때 처리 / 실패 시 연락처’를 적어 보세요. 실제 고객 요청이나 비밀값 대신 민감하지 않은 예시로 검수 범위를 합의합니다.

성공 응답만으로 사용자가 보는 카드 내용까지 확인되었다고 여기지 마세요. 대상 공간의 최종 표시와 예외 상황을 별도로 확인할 계획을 세웁니다.

5. 지금 필요한 조치와 불필요한 구매

일반 이용자는 이 공지만 보고 유료 도구를 구독하거나 낯선 앱에 채팅 권한을 줄 필요가 없습니다. 연동 운영자는 공식 제한과 현재 구조를 비교해 적용 여부를 결정하세요. 조직별 사용 가능 상태·관리 정책·실제 갱신 결과는 이 조사에서 확인하지 않았으며, 발표 자체가 기존 자동화의 정상 동작을 보장하지 않습니다.

Google: 10월 23일 Chat API 일반 제공 발표
Google: 대화형 카드 생성·갱신 조건과 제한
Google: replaceCards 인증·교체·제거 규칙
Google: 사용자 인증과 OAuth 동의 범위

발표일: 2026-10-23 · 확인일: 2026-10-25. 공식 자료 기반 변경 안내입니다. 제휴 링크·실제 계정 연동 시험은 없으며 사례와 그림은 가상 구성입니다.