외부 서비스 연결이란?
wiiiv는 다양한 서비스와 연동하여 업무 범위를 넓힙니다. 지식에 등록한 백엔드 API 문서에서 연결 정보를 자동으로 추출하고, Gmail로 메일을 보내고, Slack에 알림을 전달하고, Google Calendar에 일정을 등록하고, Jira에 이슈를 만드는 것까지 대화 한마디로 처리할 수 있습니다.
연결은 한 번만 설정하면 됩니다. 이후에는 wiiiv가 대화 맥락에서 어떤 서비스를 사용할지 자동으로 판단합니다.
어디에서 찾나요?
좌측 사이드바 하단의 ⚙️ 설정 아이콘을 누르고, 상단 탭에서 "연결"을 선택하면 외부 서비스 연결 화면이 나타납니다.
백엔드 API 자동 연결
wiiiv는 지식 페이지에 등록한 문서 가운데 백엔드 API 문서를 자동으로 인식합니다. 문서에 HTTP 메소드(GET/POST/PUT/DELETE)가 3개 이상 포함되어 있고 Base URL이 명시되어 있으면, 연결 페이지의 Internal Backend API 영역에 카드가 자동으로 생성됩니다.
사용자가 직접 연결을 만들 필요가 없습니다. 지식에 API 문서를 등록하기만 하면 wiiiv가 서비스 이름과 Base URL을 추출해서 연결 카드를 만들어 줍니다.
자격증명 등록
카드가 생성된 뒤에는 해당 API의 ID/Password를 등록해야 합니다. 카드 하단의 Change Credentials 버튼을 누르면 입력 창이 열립니다. 자격증명이 등록되면 wiiiv가 대화 중에 해당 API를 호출할 때 자동으로 인증을 처리합니다.
자격증명 입력 화면
Change Credentials를 누르면 아래와 같은 입력 창이 열립니다. 해당 백엔드 API의 ID와 Password를 입력하고 Save를 누르면 등록이 완료됩니다.
연결 테스트
자격증명을 등록하면 wiiiv가 자동으로 연결 테스트를 수행합니다. 카드에 Connected 배지가 표시되면 정상적으로 연결된 것입니다. 이후 대화에서 해당 API를 자유롭게 사용할 수 있습니다.
한 번에 연결: OAuth 로그인
Google과 Microsoft 365는 OAuth를 지원합니다. 카드의 "🔗 클릭 한 번에" 버튼을 누르면 해당 서비스의 로그인 화면으로 이동합니다. 로그인하고 권한을 허용하면 연결이 완료됩니다. 별도의 키나 토큰을 입력할 필요가 없습니다.
Google — Gmail, Calendar, Drive
Google 계정을 연결하면 wiiiv가 다음 기능을 사용할 수 있습니다:
- Gmail — 메일 읽기, 메일 보내기
- Google Calendar — 일정 조회, 일정 등록
- Google Drive — 파일 접근, 문서 읽기
Microsoft 365 — Outlook, Calendar
Microsoft 계정을 연결하면 Outlook 메일 전송과 캘린더 관리가 가능합니다. 회사에서 Microsoft 365를 사용한다면 이 방법이 적합합니다.
연결 후에는 카드에 연결됨 배지가 표시됩니다. 카드를 펼치면 연결된 이메일, 허용된 권한 목록을 확인할 수 있습니다.
메신저 연결
메신저를 연결하면 wiiiv가 대화 중에 알림을 보내거나, 워크플로우가 완료되었을 때 자동으로 결과를 전달합니다.
Slack
Slack 연결에는 두 가지 방법이 있습니다. Bot Token(권장)은 여러 채널에 메시지를 보낼 수 있고, Webhook URL은 하나의 채널에만 보낼 수 있지만 설정이 간단합니다. 두 가지를 모두 등록하면 Bot Token이 우선 사용됩니다.
| 구분 | Bot Token (권장) | Webhook URL |
|---|---|---|
| 채널 | 여러 채널 지원 | 발급된 채널 1개만 |
| 설정 | Slack App 생성 필요 | 채널 설정에서 즉시 발급 |
| 형식 | xoxb-... | https://hooks.slack.com/... |
Discord / Telegram (Pro)
Discord는 Webhook URL 또는 Bot Token으로, Telegram은 BotFather에서 발급받은 Bot Token과 Chat ID로 연결합니다. 이 서비스들은 Pro 플랜에서 사용할 수 있습니다.
협업 도구 연결 (Pro)
프로젝트 관리와 문서 협업 도구를 연결하면, 대화 중에 "이 내용으로 Notion에 페이지 만들어줘"나 "이 버그를 Jira에 이슈로 등록해줘" 같은 요청을 처리할 수 있습니다.
대화 중 연결 안내
서비스를 미리 연결하지 않아도 괜찮습니다. wiiiv는 대화 중에 외부 서비스가 필요한 상황을 감지하면, 해당 서비스의 연결 카드를 대화 안에서 직접 안내합니다.
Gmail / Calendar / Drive — One-click OAuth 🔗 클릭 한 번에
Outlook / Calendar 🔗 클릭 한 번에
카드를 클릭하면 OAuth 로그인 화면으로 이동하거나, 설정 화면의 해당 서비스로 바로 연결됩니다. 연결이 완료되면 원래 요청을 이어서 처리합니다.
보안과 자격증명
모든 자격증명(토큰, 비밀번호, API 키)은 암호화되어 저장됩니다. 등록 후에는 원본 값을 다시 조회할 수 없습니다. 토큰이 만료되거나 변경되면 기존 연결을 삭제하고 새로 등록합니다.
연결 관리
- 삭제 — 카드의 🗑 버튼으로 자격증명을 삭제합니다
- 수정 — 수동 입력 방식은 ✏️ 버튼으로 정보를 수정할 수 있습니다
- 재연결 — OAuth는 다시 로그인하면 갱신됩니다
Community와 Pro
대부분의 핵심 연결은 Community(무료) 플랜에서 사용할 수 있습니다. Pro 플랜은 추가 서비스와 제한 해제를 제공합니다.
| 서비스 | Community | Pro |
|---|---|---|
| Google (Gmail/Calendar/Drive) | ✓ | ✓ |
| Microsoft 365 (Outlook) | ✓ | ✓ |
| Slack | ✓ | ✓ |
| 메일 동시 연결 (Google + Microsoft) | 하나만 | 둘 다 |
| SMTP (사내 메일 서버) | — | ✓ |
| Discord / Telegram | — | ✓ |
| Notion / Jira / Linear | — | ✓ |
| Generic Webhook | — | ✓ |