AlphaKey 시작하기
AlphaKey는 기업용 통합 인증과 워크플로우 자동화를 한 플랫폼에서 제공하는 서비스입니다.
이 문서는 초보자도 빠르게 업무 자동화를 시작할 수 있도록 핵심 개념과 첫 설정 절차, 화면별 바로가기를 제공합니다.
빠른 시작 5단계
화면별 요약 및 바로가기
| 화면 | 주요 기능/목적 |
|---|
| 홈 | 최근 실행·수정, 템플릿, 사용량, 통계를 대시보드로 제공 |
| 플로우 | 폴더 기반 플로우 및 테이블 리스트 |
| 플로우 빌더 | 드래그 앤 드롭으로 트리거·액션 로직 설계 |
| 실행 이력 | 입력/출력, 처리 시간, 실패 지점 분석 |
| 커넥션 | Slack/AlphaKey/Google/API 인증 정보 등록·관리 |
| 템플릿 | 추천/인기/운영 템플릿 제공, 복사로 빠른 시작 |
| 템플릿 상세 | 목적/구성, 필요 커넥션, 미리보기/PNG 다운로드 |
핵심 개념 정리
| 개념 | 정의 | 유형/예시 |
|---|
| 트리거(Trigger) | 플로우의 시작 조건(플로우당 정확히 1개 필수) | API Endpoint, Helper Flow, Schedule, AlphaKey, Slack |
| 액션(Action) | 트리거 이후 순차 실행되는 동작(여러 개 가능) | App Action(Slack/AlphaKey 등), Function(분기/변환/처리) |
| 플로우(Flows) | 업무 자동화 로직 | — |
| 테이블(Tables) | 플로우가 저장/조회하는 데이터 저장소 | — |
| 커넥션(Connection) | 외부 서비스와 통신하기 위한 인증/권한 사전 등록 | Slack, Slack Admin, AlphaKey OPEN API, Google Workspace/Gmail, API Connector |
| 템플릿(Templates) | 미리 설계된 표준 자동화. 복사 후 내 플로우로 사용 | 운영(수정금지) 템플릿은 원본 변경 불가(복사본 사용) |
주요 기능 개요
1) 워크플로우 자동화
비개발자도 사용할 수 있는 노코드(No-code) 기반 빌더로 반복 업무를 자동화합니다.
- Drag & Drop 워크플로우 스튜디오
- 실시간 실행 로그 및 오류 추적
- Slack, Google Workspace, AlphaKey 등 다양한 앱 연동
2) Open API 연동
내·외부 시스템과 안전하게 연결하고 관리합니다. 워크플로우에서 API 호출/데이터 처리/이벤트 트리거를 자유롭게 구성할 수 있습니다.
- API Key/토큰 기반 보안
- REST API 지원
3) Event Hooks (웹훅)
AlphaKey의 Event Hooks는 특정 이벤트 발생 시 사용자가 등록한 Webhook URL로 데이터를 자동 전송하는 기능입니다. 등록된 URL이 실제로 사용자 소유인지 확인하기 위해 검증(
Verification) 절차를 수행합니다.
- 검증 흐름 요약: URL 등록 → AlphaKey가
{입력 URL}/verification으로 POST 호출 → 요청 헤더의 X-AlphaKey-Verification-Code 값을 그대로 응답하면 검증
성공
- 지원 응답 포맷:
text/plain(verificationCode={CODE}) 또는 application/json({"verificationCode": "{CODE}"})
- 검증 성공 시 Event Hook 상태가 “검증됨(Verified)”으로 변경되어 이벤트 전송이 활성화됩니다.
- 자세한 가이드: Event Hook 설정 및 검증 가이드
활용 예시
| 시나리오 | 설명 |
|---|
| 신규 입사자 자동 등록 | 인사 DB 변경 시 Google Workspace 계정 자동 생성 |
| 승인 프로세스 자동화 | 결재 요청 → 승인 → 결과 기록까지 자동 처리 |
| 외부 API 연동 | CRM/ERP/Slack 등 SaaS와 연결하여 플로우 구성 |
운영 체크리스트(요약)
| 점검 영역 | 체크 항목 | 팁/예시 |
|---|
| 커넥션 점검 | 인증 만료 여부, 권한 범위 확인(Slack Admin/AlphaKey 등) | Dev/Prod 분리 권장: Slack_Notification_Dev / Slack_Notification_Prod |
| 실패 모니터링 | 실행 이력에서 실패 단계의 입력/출력/에러 확인 | 병목 카드의 처리 시간으로 원인 추적 |
| 변경 관리 | 운영 템플릿 원본 수정 금지, 복사본에서 변경 | 이름 규칙: 서비스명_용도_환경 |
자주 묻는 질문(FAQ)
| 질문 | 답변 |
|---|
| 트리거를 여러 개 둘 수 있나요? | 아니요. 플로우당 트리거는 반드시 1개입니다. |
| 템플릿을 수정하면 원본이 바뀌나요? | 아니요. 템플릿은 복사본을 생성해 사용하며, 원본은 변경되지 않습니다. |
| Slack 관련 액션이 실패해요. | 커넥션(특히 Slack Admin 필요 여부)과 토큰 만료를 확인하고, 실행 이력에서 해당 카드의 입력/출력/에러를 점검하세요. |
| 외부 API 호출이 느려요. | 실행 이력에서 처리 시간이 긴 카드를 찾아 API 지연 여부를 확인하고 재시도/타임아웃 또는 설계를 조정하세요. |
관련 문서