

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 통합
<a name="actions-integrations"></a>

## AWS 서비스
<a name="aws-services"></a>

### Amazon S3
<a name="amazon-s3"></a>

Amazon S3 작업을 사용하면 파일과 데이터를 저장하고 검색할 수 있습니다.

**사용 가능한 작업**
+ **파일 다운로드** - Amazon S3에서 파일을 다운로드하고 파일 객체 핸들을 반환합니다.
+ **파일 업로드** - Amazon S3에 파일 객체 핸들을 업로드합니다.
+ **객체 복사** - 소스 파일 하나에서 대상 위치로 Amazon S3에 이미 저장된 객체의 복사본을 생성합니다.
+ **객체 삭제** - S3 버킷에서 지정된 객체를 삭제합니다.
+ **객체 나열** - 지정된 버킷의 모든 객체를 나열합니다. 접두사를 사용하여 필터링할 수 있습니다.

### Amazon Bedrock
<a name="amazon-bedrock"></a>

Amazon Bedrock 작업을 사용하면 단일 API를 통해 주요 AI 회사의 파운데이션 모델(FMs)에 연결할 수 있습니다.
+ **기본 모델 대화** - AI 모델에 프롬프트를 보냅니다. 자연어를 사용하여 텍스트를 생성하고, 콘텐츠를 분석하고, AI 기반 응답을 받을 수 있습니다.
+ **고급 모델 대화** - 더 많은 옵션이 있는 모델을 프롬프트합니다. 고급 옵션에는 사용자 지정 메시지 형식, 도구 통합, 모델 동작에 대한 세분화된 제어가 포함됩니다.

### Amazon Bedrock 에이전트
<a name="amazon-bedrock-agents"></a>

Amazon Bedrock Agent 작업을 사용하면 데이터 소스, APIs 및 백엔드 시스템에 연결할 수 있는 AI 어시스턴트를 호출할 수 있습니다.
+ **기본 에이전트 호출** - AI 에이전트에 요청을 보냅니다. 파일 첨부 파일, 사용자 입력 또는 사용자 지정 구성이 필요하지 않은 간단한 상호 작용에 사용합니다.
+ **고급 에이전트 호출** - 더 많은 옵션을 사용하여 에이전트를 호출합니다. 파일 첨부 파일, 사용자 입력 또는 사용자 지정 구성이 필요한 고급 상호 작용에 사용됩니다.

### Amazon Bedrock 데이터 자동화
<a name="amazon-bedrock-data-automation"></a>

Bedrock Data Automation(BDA)은 생성형 AI를 사용하여 비정형 콘텐츠에서 중요한 인사이트를 추출하는 프로세스를 간소화합니다.

**사용 가능한 작업**
+ **데이터 자동화 비동기 호출** - 데이터 자동화 프로젝트 또는 블루프린트로 데이터를 처리합니다. 비동기 데이터 처리를 시작하고 호출 ID를 반환합니다.
+ **데이터 자동화 상태 가져오기** - 데이터 자동화 호출 상태 및 출력 위치에 대한 세부 정보를 가져옵니다.

### Amazon Textract
<a name="amazon-textract"></a>

Amazon Textract를 사용하면 자동화에 문서 텍스트 감지 및 분석을 추가할 수 있습니다.
+ **기본 문서 쿼리** - 질문을 기반으로 데이터를 추출합니다. 각 쿼리에는 요청하려는 질문과 연결하려는 별칭이 포함됩니다. Textract는 각 질문에 대한 텍스트 답변과 신뢰도 점수를 제공합니다.
+ **기본 문서 분석** - 문서에서 데이터를 추출합니다. 문서 레이아웃 및 데이터 관계를 유지하면서 양식(키-값 페어), 테이블(정형 데이터) 및 텍스트를 자동으로 감지하고 추출합니다.

### Amazon Comprehend
<a name="amazon-comprehend"></a>

Amazon Comprehend는 문서 콘텐츠에 대한 인사이트를 얻기 위한 자연어 처리(NLP) 서비스입니다. 텍스트를 분석하여 주요 구문을 추출하고, 감정을 식별하고, 문서를 분류하는 데 도움이 됩니다.

**사용 가능한 작업**
+ **문서 분류** - 사용자 지정 모델 엔드포인트를 사용하여 단일 문서를 실시간으로 분석하는 분류 요청을 생성합니다. 텍스트 입력 또는 문서 파일(PDF, Word 또는 이미지)을 지원합니다.
+ **키 문구 감지** - 텍스트에 있는 주요 명사 문구를 감지하여 콘텐츠 내의 중요한 개념과 주제를 식별합니다.

## 외부 애플리케이션
<a name="external-applications"></a>

### Microsoft Outlook
<a name="microsoft-outlook"></a>

Microsoft Outlook 작업을 통해 자동화를 통해 이메일과 일정을 관리할 수 있습니다.
+ **이메일**
  + **사용자 이메일 전송** - 특정 사용자를 대신하여 이메일 메시지를 전송합니다.
  + **이메일 회신** - 메시지 발신자에게 회신합니다.
  + **폴더 메시지 나열** - 로그인한 사용자 사서함의 특정 폴더에 있는 메시지를 가져옵니다.
  + **사용자 메일 나열** - 로그인한 사용자의 사서함(삭제된 항목 및 Clutter 폴더 포함)에서 메시지를 가져옵니다.
  + **이메일 보기** - 특정 메시지 객체의 속성 및 관계를 검색합니다.
  + **이메일 업데이트** - 메시지 객체의 속성을 업데이트합니다.
  + **이메일 삭제** - 지정된 사용자의 사서함에서 메시지를 삭제합니다.
  + **이메일 첨부 파일 나열 **- 메시지에 연결된 첨부 파일 객체 목록을 검색합니다.
  + 첨부 **파일 가져오기 **- 첨부 파일의 속성, 관계 또는 원시 콘텐츠를 읽습니다.
+ **폴더**
  + **메일 폴더 나열** - 로그인한 사용자의 루트 폴더 바로 아래에 있는 메일 폴더 컬렉션을 가져옵니다.
  + **이메일을 폴더로 이동** - 메시지를 지정된 사용자의 사서함 내의 다른 폴더로 이동합니다.
  + **사서함 설정 가져오기** - 자동 회신, 날짜 형식 및 시간대와 같은 사용자의 사서함 설정을 가져옵니다.
+ **일정**
  + **일정 이벤트 나열** - Microsoft Outlook에서 지정된 사용자 또는 리소스에 대한 일정 이벤트 목록을 가져옵니다.
  + **일정 이벤트 생성** - 사용자의 기본 일정 또는 지정된 일정에 이벤트를 생성합니다.
  + **일정 이벤트 업데이트** - 기존 이벤트 객체의 속성을 업데이트합니다.
+ **기타**
  + **장소 목록** - 테넌트에 정의된 장소 객체(방 또는 방 목록) 모음을 가져옵니다.
  + **사용자 나열** - Microsoft Outlook에서 기본 정보를 사용하여 조직의 사용자 목록을 검색합니다.
  + **연락처 나열** - 로그인한 사용자의 기본 연락처 폴더에서 연락처 컬렉션을 가져옵니다.

### Microsoft Teams
<a name="microsoft-teams"></a>

Microsoft Teams 작업을 통해 자동화는 채널 및 채팅 메시지를 통해 팀원과 통신하고 회의를 관리할 수 있습니다.
+ **메시지**
  + **채팅 나열** - 모든 채팅 대화 보기
  + **채팅 생성** - 새 채팅 대화 시작
  + **개별 채팅 가져오기** - 특정 채팅의 세부 정보 보기
  + **모든 채팅 메시지 나열** - 채팅 대화에서 메시지 보기
  + **채팅 메시지 전송** - 채팅에서 새 메시지 전송
+ **팀**
  + **팀 나열** - 인증된 사용자가 액세스할 수 있는 모든 팀 보기
  + **팀 가져오기** - 특정 팀에 대한 세부 정보 보기
  + **모든 팀원 나열** - 팀원 보기
  + **팀에 사용자 초대** - 팀에 새 멤버 추가
+ **채널**
  + **모든 채널 나열** - 특정 팀 내의 모든 채널 보기
  + **채널 생성** - 팀 내에 새 채널 생성
  + **채널 가져오기** - 특정 채널에 대한 세부 정보 보기
  + **모든 채널 메시지 나열** - 채널에 게시된 메시지 보기
  + **채널 메시지 전송** - 채널에 새 메시지 게시
  + **채널 메시지에 회신** - 기존 채널 메시지에 회신 추가
  + **채널 멤버 초대** - 특정 채널에 멤버 추가
+ **회의**
  + **온라인 팀 회의 생성** - 새 온라인 회의 예약
  + **온라인 팀 회의 받기** - 특정 회의의 세부 정보 보기
  + **모든 레코딩 나열** - 회의의 레코딩 보기
  + **모든 트랜스크립트 나열** - 회의의 트랜스크립트 보기
+ **Users**
  + **사용자 목록** - 조직 내 사용자 목록 보기

### Microsoft SharePoint
<a name="microsoft-sharepoint"></a>

Microsoft SharePoint를 사용하면 자동화를 통해 문서와 정보를 중앙에서 저장, 관리 및 공유할 수 있습니다.
+ **목록 및 항목**
  + **목록 가져오기** - 목록과 연결된 작업 목록 가져오기
  + **항목 생성** - 목록에서 새 목록 항목 생성
  + **항목 업데이트** - listItem의 속성 업데이트
  + **항목 삭제** - 목록에서 항목을 제거합니다.
  + **항목 가져오기** - 목록의 항목에 대한 메타데이터를 반환합니다.
  + **항목 나열** - 목록의 항목 모음 가져오기
+ **시트 및 파일**
  + **시트 추가** - 통합 문서에 새 워크시트 추가
  + **시트 삭제** - 통합 문서에서 워크시트 제거
  + **시트 업데이트** - 워크시트 속성 편집(이름 변경, 가시성)
  + **목록 시트** - 워크시트 객체 목록 검색
  + **읽기 시트** - 워크시트의 속성 검색
  + **파일 업로드** - 통합 파일 생성 또는 업데이트
+ **범위 및 셀**
  + **읽기 범위** - 지정된 범위에서 값을 검색합니다.
  + **범위 삭제** - 지정된 범위의 셀을 삭제합니다.
  + **쓰기 범위** - 지정된 범위의 값을 업데이트합니다.
  + **사용된 범위 가져오기** - 지정된 워크시트의 사용된 범위를 반환합니다.
  + **범위 지우기** - 형식, 채우기 및 테두리를 포함한 범위 값 지우기
  + **셀 읽기** - 특정 셀에서 값을 가져옵니다.
  + **셀 쓰기** - 특정 셀의 값을 설정합니다.

### Microsoft OneDrive
<a name="microsoft-onedrive"></a>

Microsoft OneDrive 작업을 사용하면 파일을 저장, 동기화 및 공유할 수 있습니다. 스프레드시트 작업을 위해 OneDrive에 저장된 Microsoft Excel 파일과 직접 상호 작용할 수 있습니다.
+ **파일 관리**
  + **항목 가져오기** - 특정 파일 또는 폴더의 세부 정보 보기
  + **드라이브 가져오기** - OneDrive 계정 세부 정보 및 스토리지 정보 보기
  + **항목 나열** - 드라이브의 모든 파일 및 폴더 보기
  + **항목 생성/폴더 생성** - OneDrive에서 새 폴더 또는 항목 생성
  + **하위 항목 나열** - 특정 폴더에 포함된 항목 보기
  + **항목 삭제** - 파일 또는 폴더 제거
  + **항목 업데이트/항목 이동** - 메타데이터 업데이트 또는 폴더 간 파일 이동
  + **항목 복사** - 다른 위치에 파일 또는 폴더의 복사본 생성
  + **권한 추가** - 파일에 대한 공유 및 액세스 권한 구성
  + **파일 업로드** - OneDrive에 새 파일 추가
+ **Excel**
  + **시트 추가** - Excel 통합 문서에서 새 워크시트 생성
  + **범위 지우기** - 셀 범위에서 콘텐츠 및 형식 제거
  + **범위 삭제** - 워크시트에서 셀, 행 또는 열 제거
  + **시트 삭제** - 통합 문서에서 워크시트 제거
  + **목록 시트** - 통합 문서의 모든 워크시트 보기
  + **셀 읽기** - 특정 셀의 값 가져오기
  + **읽기 범위** - 셀 범위에서 값 가져오기
  + **시트 읽기** - 전체 워크시트의 내용 보기
  + **사용된 범위 읽기** - 데이터가 포함된 셀의 범위 가져오기
  + **시트 업데이트** - 워크시트 속성 수정
  + **셀 쓰기** - 특정 셀의 값 설정
  + **쓰기 범위** - 셀 범위의 값 설정

### Salesforce
<a name="salesforce"></a>

Salesforce 작업을 사용하면 사례, 기회, 리드, 캠페인, 고객 응대 등에서 고객 관계를 관리하는 프로세스를 자동화할 수 있습니다.
+ **사례**
  + **사례 목록 가져오기** - 메타데이터 및 최근 항목을 포함하여 Salesforce에서 고객 지원 사례 목록을 가져옵니다.
  + **사례 가져오기** - 특정 사례의 세부 정보 보기
  + **사례 생성** - 새 지원 사례 생성
  + **사례 삭제** - 기존 사례 제거
  + **사례 업데이트** - 사례 세부 정보 및 정보 편집
+ **기회**
  + **기회 얻**기 - 판매 기회 목록 보기
  + **특정 기회 얻**기 - 특정 기회의 세부 정보 보기
  + **기회 생성** - 새 영업 기회 생성
  + **기회 업데이트** - 기회 세부 정보 편집
  + **기회 삭제** - 기존 기회 제거
+ **리드**
  + **리드 업데이트** - 리드 세부 정보 및 정보 편집
+ **캠페인**
  + **캠페인 업데이트** - 캠페인 세부 정보 및 정보 편집
+ **피드 항목**
  + **피드 항목 업데이트** - 피드 항목 콘텐츠 및 속성 편집
+ **연락처**
  + **연락처 목록 가져오기** - 시스템의 모든 연락처 보기
  + **연락처 가져오기** - 특정 연락처의 세부 정보 가져오기
  + **연락처 업데이트** - 연락처 정보 편집
+ **Users**
  + **사용자 목록 가져오기** - Salesforce 사용자 목록 검색
+ **시스템**
  + **SObject 설명** - 모든 Salesforce 객체 유형에 대한 객체 메타데이터 및 필드 세부 정보 가져오기

### Jira
<a name="jira"></a>

Jira 작업을 사용하면 문제, 프로젝트, 스프린트 등의 관리를 자동화할 수 있습니다.
+ **문제**
  + **문제 생성** - 프로젝트에서 문제를 생성합니다.
  + **문제 편집** - 프로젝트의 기존 문제를 수정합니다.
  + **문제 상태 업데이트(전환 수행)** - 문제의 작업 상태를 변경합니다.
  + **문제 삭제** - 프로젝트의 문제를 삭제합니다.
  + **문제 가져오기** - 프로젝트의 문제에 대한 세부 정보를 봅니다.
  + **문제 검색** - JQL을 사용하여 문제를 검색합니다.
  + **검색 상태** - 문제 상태를 검색합니다.
  + **문제 첨부 파일 다운로드 **- 첨부 파일의 내용을 봅니다.
  + 첨부 **파일 추가 **- 문제에 첨부 파일을 추가합니다.
  + **모든 레이블 가져오기** - 모든 레이블을 봅니다.
+ **설명**
  + **설명 추가** - 문제에 새 설명을 추가합니다.
  + **설명 삭제** - 문제에서 설명을 제거합니다.
  + **설명 업데이트** - 문제에 대한 기존 설명을 편집합니다.
  + **설명 가져오기** - 문제 설명을 봅니다.
+ **Projects**
  + **프로젝트 생성** - Jira에서 새 프로젝트를 생성합니다.
  + **프로젝트 업데이트** - 프로젝트 세부 정보를 수정합니다.
  + **프로젝트 삭제** - Jira에서 프로젝트를 제거합니다.
  + **프로젝트 가져오기** - 프로젝트 세부 정보를 봅니다.
  + **프로젝트의 문제 유형 가져오기** - 프로젝트 문제 유형을 봅니다.
  + **프로젝트 검색** - 표시되는 프로젝트를 찾습니다.
+ **스프린트**
  + **스프린트 생성** - 프로젝트에 스프린트를 생성합니다.
  + **스프린트 업데이트** - 스프린트 세부 정보를 업데이트합니다.
  + **스프린트 삭제** - 프로젝트에서 스프린트를 삭제합니다.
  + **스프린트 가져오기** - 프로젝트에서 스프린트의 세부 정보를 봅니다.
  + **문제를 스프린트로 이동 및 순위** 지정 - 스프린트에 문제를 할당합니다.
  + **문제를 백로그로 이동** - 문제를 백로그로 이동합니다.
+ **Users**
  + **사용자 찾기** - Jira 사용자를 검색합니다.
  + **할당 가능한 사용자 찾기** - 문제에 할당할 수 있는 사용자 목록을 반환합니다.
  + **모든 사용자 가져오기** - 모든 Jira 사용자를 나열합니다.

### ServiceNow
<a name="servicenow"></a>

ServiceNow 작업을 사용하면 인시던트, 변경 요청 등의 IT 서비스 관리를 자동화할 수 있습니다.
+ **인시던트**
  + **인시던트 생성** - 새 인시던트 레코드를 생성합니다.
  + **인시던트 읽기** - 특정 인시던트의 세부 정보를 검색합니다.
  + **인시던트 업데이트** - 기존 인시던트 레코드를 수정합니다.
  + **인시던트 삭제** - 특정 인시던트 레코드를 제거합니다.
+ **변경 요청**
  + **변경 요청 생성** - 새 변경 요청 레코드를 생성합니다.
  + **변경 요청 읽기** - 특정 변경 요청의 세부 정보를 검색합니다.
  + **변경 요청 업데이트** - 기존 변경 요청 레코드를 수정합니다.
  + **변경 요청 삭제** - 특정 변경 요청 레코드를 제거합니다.
+ **지식 기반 문서**
  + **지식 기반 문서 업데이트** - 기존 지식 기반 문서를 수정합니다.
+ **문제 레코드**
  + **문제 레코드 업데이트** - 기존 문제 레코드를 수정합니다.
+ **첨부 파일**
  + **이진 첨부 파일 업로드 **- 파일을 지정된 레코드에 첨부 파일로 업로드합니다.
  + **멀티파트 양식 첨부 파일 업로드 **- 레코드에 양식 첨부 파일을 업로드합니다.
  + **첨부 파일 콘텐츠 검색 **- 특정 첨부 파일의 이진 콘텐츠를 가져옵니다.
  + **첨부 파일 메타데이터 검색 **- 특정 첨부 파일에 대한 메타데이터를 가져옵니다.
  + **첨부 파일 삭제** - 시스템에서 첨부 파일을 제거합니다.
  + **첨부 파일에 대한 메타데이터 검색 **- 여러 첨부 파일에 대한 메타데이터를 가져옵니다.
+ **시스템**
  + **사용자 나열** - 시스템 사용자 테이블에서 모든 기존 레코드를 검색합니다.
  + **목록 선택** - 시스템에서 선택 목록 값을 검색합니다.

### SAP
<a name="sap"></a>

SAP 작업을 통해 비즈니스 파트너 데이터, 재료 재고, 재료표, 제품 마스터 및 물리적 인벤토리와 관련된 프로세스를 자동화할 수 있습니다.
+ **SAP 비즈니스 파트너**
  + **비즈니스 파트너 가져오기** - 비즈니스 파트너의 일반 데이터를 검색하여 파트너 정보에 대한 포괄적인 보기를 제공합니다.
  + **ID로 비즈니스 파트너 가져오기** - 특정 비즈니스 파트너 번호를 식별자로 사용하여 자세한 비즈니스 파트너 데이터를 검색합니다.
  + **비즈니스 파트너 주소 가져오기** - 우편 주소 및 연락처 정보를 포함하여 비즈니스 파트너와 관련된 주소 세부 정보를 검색합니다.
  + **비즈니스 파트너 역할 가져오기** - 비즈니스 파트너의 역할 정보를 검색하여 시스템 내 관계와 기능을 보여줍니다.
  + **ID로 비즈니스 파트너 역할 가져오기** - 키 식별자 필드를 사용하여 비즈니스 파트너의 특정 역할 데이터를 검색합니다.
+ **SAP 재료 재고**
  + **계정 모델 컬렉션에서 재료 재고 가져오기** - 배치, 스토리지 위치 및 특수 재고 지표와 같은 세부 정보가 포함된 재료 재고 수준을 가져옵니다.
+ **SAP 자재 명세서**
  + **자재 BOM 항목 가져오기** - 수량, 범주 및 관계를 포함하여 자재 청구서에 사용되는 자재의 세부 정보를 검색합니다.
+ **SAP 제품 마스터**
  + **제품 마스터 레코드 가져오기** - 제품 마스터 일반 세부 정보를 봅니다. 특정 데이터를 필터링, 정렬 및 선택하는 옵션이 포함된 전체 제품 마스터 레코드를 반환합니다.
  + **제품 마스터 레코드의 공장 데이터 가져오기** - 제품의 공장 세부 정보를 봅니다. 제조, 스토리지 및 물류 데이터를 포함하여 특정 제품에 대한 자세한 공장별 정보에 액세스합니다.
  + **제품 번호 및 공장별로 공급 계획 데이터 가져오기** - 제품 번호 및 공장별로 공급 계획 세부 정보를 봅니다. 로트 크기, 안전 재고 수준 및 조달 데이터를 포함한 세부 계획 파라미터를 검색합니다.
+ **SAP 물리적 인벤토리**
  + **Phys 인벤토리 문서 항목 가져오기** - 결과 및 인벤토리 차이 계산을 포함한 물리적 인벤토리 문서 항목을 검색합니다.

## REST API 통합
<a name="custom-rest-apis"></a>

REST API 연결 통합을 통해 Quick Automate는 사용자 지정 REST APIs 및 웹 서비스와 상호 작용하여 외부 시스템으로 자동화 기능을 확장할 수 있습니다. 이 통합은 GET, POST, DELETE, PATCH 및 PUT HTTP 메서드에 대한 작업 실행을 지원합니다.

**일반적인 사용 사례:**
+ 외부 시스템에 알림 전송
+ 타사 서비스에서 데이터 검색
+ 외부 데이터베이스의 레코드 업데이트
+ 연결된 애플리케이션에서 워크플로 트리거

**사전 조건**

REST API 통합으로 자동화를 생성하기 전에 다음을 갖추어야 합니다.
+ **구성된 REST API 통합**
  + Quick Suite 콘솔 액세스
  + 통합 > REST API 연결로 이동합니다.
  + 기본 URL을 사용하여 REST API 엔드포인트 구성
  + 인증 설정 완료(아래 인증 섹션 참조)
  + 전체 세부 정보: [REST API 연결 통합](rest-api-integration.md)
+ **자동화 그룹에 연결된 통합**
  + 구성된 REST API 통합을 자동화 그룹에 연결
  + 사용 가능한 작업에 통합이 나타나는지 확인
  + Step-by-step 가이드: [AWS 서비스 작업 커넥터](builtin-services-integration.md)
+ **인증 구성됨**
  + API 공급자로부터 얻은 OAuth 2.0 자격 증명

### Authentication
<a name="rest-api-authentication"></a>

Quick Automate의 경우이 통합은 **OAuth 2.0** 인증을 지원합니다. 자동화를 생성하기 전에 OAuth 자격 증명을 구성해야 합니다.

**OAuth 2.0 설정 단계:**
+ 자격 증명 공급자로부터 OAuth 자격 증명(클라이언트 ID 및 클라이언트 보안 암호) 획득
+ Quick Suite 콘솔에서 REST API 통합 설정으로 이동합니다.
+ 인증 방법으로 OAuth 2.0 선택
+ 클라이언트 ID와 클라이언트 보안 암호를 입력합니다.
+ API 공급자가 제공하는 권한 부여 URL 및 토큰 URL 구성
+ OAuth 흐름을 완료하여 Quick Suite에 권한 부여
+ 연결을 테스트하여 인증 확인

**중요 참고 사항:**
+ Quick Automate는 요청 헤더에서 보유자 토큰 인증을 지원하지 않습니다. 대신 OAuth 구성을 사용합니다.
+ 자동화 작업이 아닌 통합 수준에서 인증 구성

### 구성
<a name="rest-api-configuration"></a>

**REST API 통합 설정**

1단계: 기본 URL 구성 생성

2단계: 자동화 그룹에 연결

3단계: REST API 작업 액세스
+ 자동화에서 작업 패널 열기
+ REST API 작업 찾기
+ 작업을 자동화 워크플로로 끌어서 놓기
+ 
**참고**  
REST API 작업은 작업 패널을 통해 추가해야 하며, Build with Assistant 인터페이스에서는 사용할 수 없습니다.

### 속성 참조
<a name="rest-api-properties"></a>
+ **Q 작업 커넥터 ID(필수)**
  + **설명:** 기본 URL 및 인증 설정을 포함하여 REST API 작업을 구성된 통합에 연결하는 고유 식별자입니다.
  + **형식:** 연결된 통합에서 자동으로 채워짐
  + **예**: `rest-api-connector-abc123`
+ **URI(선택 사항)**
  + **설명:** 정확한 API 엔드포인트를 지정하기 위해 기본 URL에 추가 경로가 추가되었습니다.
  + **형식:** 선행 슬래시가 있거나 없는 경로 문자열(기본 URL 형식에 따라 다름)
  + **작동 방식:**
    + 기본 URL: `https://api.example.com`
    + URI: `/users/123`
    + 최종 URL: `https://api.example.com/users/123`
  + **예**:

    ```
    /users/123
    prod/send-email
    /v2/orders
    customers/search
    ```
+ **추가 헤더(선택 사항)**
  + **설명:** API 요청에 키-값 페어로 포함할 사용자 지정 HTTP 헤더입니다.
  + **형식:**

    ```
    Key: Value
    ```
  + **일반적인 예:**

    ```
    Content-Type: application/json
    Accept: application/json
    X-Custom-Header: custom-value
    X-API-Version: 2.0
    ```
  + **중요 제한 사항:**
    + 권한 부여 헤더를 포함하지 마십시오. 인증은 OAuth 구성을 통해 처리됩니다.
    + 각 헤더는 별도의 줄에 있어야 합니다.
    + 헤더는 대/소문자를 구분합니다.
+ **요청(필수)**
  + **설명:** POST 또는 PUT 요청과 함께 전송할 JSON 형식의 데이터입니다.
  + **형식:** 유효한 JSON 객체입니다. 빈 요청의 경우 \$1\$1
  + **POST 요청 예제(리소스 생성):**

    ```
    {
      "title": "My New Post",
      "body": "This is the content of my new post.",
      "userId": 1,
      "tags": ["automation", "api"],
      "published": true
    }
    ```
  + **PUT 요청 예제(리소스 업데이트):**

    ```
    {
      "status": "completed",
      "completedDate": "2026-01-27",
      "notes": "Task finished successfully"
    }
    ```
+ **출력 변수(선택 사항)**
  + **설명:** 후속 자동화 작업에 사용할 API 호출의 JSON 응답을 저장하는 변수 이름입니다.
  + **형식:** 영숫자 변수 이름(공백 없음)
  + **예:** `apiResponse`, `userData`, `orderDetails` 

### API 사용 예
<a name="rest-api-examples"></a>

#### 예제 1: GET 요청 - 티켓 세부 정보 검색
<a name="rest-api-example-get"></a>

**시나리오:** 외부 티켓팅 시스템에서 기존 지원 티켓의 세부 정보 검색

**구성:**
+ **Q Action Connector ID:** rest-api-connector-tickets
+ **HTTP 메서드:** GET
+ **URI:** /tickets/`ticketId`
+ **추가 헤더:**

  ```
  Accept: application/json
  ```
+ **요청 본문:** \$1\$1( GET 요청의 경우 비어 있음)
+ **출력 변수:** ticketDetails

#### 예제 2: POST 요청 - 새 레코드 생성
<a name="rest-api-example-post"></a>

**시나리오:** 외부 티켓팅 시스템에 새 지원 티켓 제출

**구성:**
+ **Q Action Connector ID:** rest-api-connector-tickets
+ **HTTP 메서드:** POST
+ **URI:** `/tickets`
+ **추가 헤더:**

  ```
  Content-Type: application/json
  Accept: application/json
  ```
+ **요청 본문:**

  ```
  {
    "title": "{{ticketTitle}}",
    "description": "{{ticketDescription}}",
    "priority": "{{ticketPriority}}",
    "requestedBy": "{{userEmail}}",
    "category": "technical_support"
  }
  ```
+ **출력 변수:** `ticketResponse`