Activepieces 연동

Activepieces 플로우 안에서 Asyntai 어시스턴트를 사용하세요

유료 플랜 필요: Activepieces 연동은 Starter, Standard, Pro 요금제에서 작동합니다. 요금제 보기

개요

Activepieces는 오픈 소스 자동화 도구입니다. Asyntai 피스가 고객 메시지를 어시스턴트에 보내고 답변을 돌려줍니다. 그 답변은 플로우 어디로든 보낼 수 있습니다. 이메일 회신, Slack 메시지, 헬프데스크 티켓, 데이터베이스 행 등입니다.

사용 가능한 액션

Asyntai 피스는 두 가지 액션을 제공합니다:

어시스턴트에게 질문 - 고객 메시지를 하나의 어시스턴트에 보내고 답변을 돌려줍니다
사용자 지정 API 호출 - 같은 연결로 Asyntai API의 모든 엔드포인트를 호출합니다

참고: 피스는 npm에서 설치합니다. 직접 운영하는 Activepieces 인스턴스나 Activepieces Cloud의 플랫폼 관리자 권한이 필요합니다.

설치 방법

다음 단계로 Asyntai를 Activepieces에 연결하세요:

API 키 받기

API 설정 페이지를 열고 키를 만드세요:

https://asyntai.com/settings/api/

키를 복사해 안전하게 보관하세요. 키를 가진 사람은 누구나 API로 Asyntai 계정에 접근할 수 있습니다.

Asyntai 피스 설치

Activepieces에서 Settings, 그다음 My Pieces, 그다음 Install Piece로 이동하세요. 이 패키지 이름을 입력하세요:

@asyntai/piece-asyntai

계정 연결하기

플로우에 Asyntai 단계를 추가하세요. 새 연결을 만들고 API 키를 붙여넣으세요. Activepieces는 키를 즉시 확인하고 잘못되면 오류를 표시합니다.

플로우 구성

플로우는 두 부분으로 이루어집니다:

트리거: 새 이메일, 폼 입력, 웹훅 같은 모든 Activepieces 트리거
액션: Asyntai - 어시스턴트에게 질문

트리거에서 Asyntai 액션으로 고객 메시지와 고정된 대화 ID를 전달하세요.

답변 돌려보내기

답변을 전달할 단계를 하나 더 추가하세요. Gmail, Slack, 헬프데스크, SMS 서비스 등입니다. 회신 본문에는 Asyntai 단계의 answer 필드를 사용하세요.

테스트 후 게시

실제 고객 질문으로 테스트하세요. 답변을 확인한 뒤 플로우를 게시하세요.

어시스턴트에게 질문 입력값

Assistant Website(필수) - 답변할 어시스턴트. 목록은 계정에서 불러옵니다.
Customer Message(필수) - 어시스턴트가 답해야 할 텍스트.
Conversation ID(필수) - 이 고객이나 스레드의 고정 값. 이메일 주소나 티켓 번호 등입니다.
Source Channel(필수) - 메시지가 들어온 곳. 이메일 채널은 어시스턴트에 이메일 지침을 추가합니다.

어시스턴트에게 질문 출력값

answer - 어시스턴트의 답변.
conversation_id - 답변이 속한 스레드.
ai_disclosure - AI 고지 문구. 고객에게 표시하세요.
success - 호출 성공 여부.

팁: Asyntai 대시보드에서 지침, 자주 묻는 질문, 지식 베이스 내용을 추가하면 답변이 좋아집니다.

대화 기록

Asyntai는 보낸 대화 ID로 기록을 보관합니다. 같은 고객에게 같은 값을 쓰면 어시스턴트가 이전 메시지를 기억합니다. 새 값을 쓰면 새 스레드가 시작됩니다.

호출할 때마다 기록에 메시지가 하나 추가되므로 재실행하면 중복 항목이 생깁니다. 재시도를 설정할 때 이 점을 기억하세요.

활용 사례

이메일 지원: 새 이메일이 오면 어시스턴트가 답변을 쓰고 Gmail이 보냅니다
Slack 헬프데스크: Slack 채널의 질문에 같은 스레드로 답변합니다
폼 회신: 문의 폼 입력이 몇 초 안에 이메일 답변을 보냅니다
티켓 분류: 어시스턴트가 간단한 티켓에 답하고 나머지는 사람에게 넘깁니다
SMS 답변: 문자 서비스를 연결해 고객의 휴대폰으로 답하세요

소스 코드

이 피스는 MIT 라이선스의 오픈 소스입니다. npm 패키지 이름은 다음과 같습니다: