협업툴 플로우에서 제공하는 API 및 웹훅 기능과 관련해, '자주 묻는 질문' 형태로 주요 내용을 정리해 보았습니다.
Q1. 플로우에서 API 기능을 사용하려면 어떤 요금제를 이용해야 할까요?
우선 현재 플로우는 '비즈니스 플랜' 하나의 요금제로 단일 운영되고 있습니다. 플로우의 API 기능은 해당 요금제 기반의 '기업 소속 유료 계정(비즈니스 계정)' 사용 시에만 이용이 가능합니다. 비즈니스 계정 최초 가입 시 제공되는 14일 무료체험 기간 중에도 API 기능을 이용해 보실 수 있으니, 도입 전에 충분히 테스트해 보시는 것을 추천드려요! 😊
단, 무료 외부인 계정(게스트 계정) 사용 시에는 기능 이용이 불가하니 참고해 주세요!
Q2. API 인증(토큰/키)은 어떻게 발급받나요?
API 인증 방법은 개발자 포털의 Getting Started > Authorization 메뉴에서 상세하게 안내하고 있어요. 인증키는 기업 관리자 권한을 가진 사용자에 한해서 발급이 가능하며, 관리자가 개발자 포털에 로그인한 뒤 확인 가능합니다.
TIP. 발급받은 인증 정보(토큰/키)는 보안을 위해 외부에 노출되지 않도록 안전하게 관리해 주세요!
Q3. 알림봇 메시지는 어떻게 보내나요?
알림봇 메시지 발송은 크게 두 단계로 진행돼요.
1) STEP 1. 알림봇 ID(Bot) 생성
기업 내 관리자가 개발자 포털 접속 후 로그인한 뒤(아래 이미지의 ①~②단계),
우측 상단의 '이름' 부분을 클릭하여 Admin에 진입한 뒤, Bots > Manage Bots > + Create Bot 을 눌러 봇 ID를 생성할 수 있습니다.
2) STEP 2. 메시지 전송 API 호출
이후 개발자 포털 메인 화면으로 돌아와, Endpoints(v1) 카테고리에서 Bots 를 눌러 '알림봇 메시지 전송(POST /v1/bots/{botId}/notifications)' 엔드 포인트를 사용하면 됩니다. 클릭 시 자세한 가이드를 확인할 수 있습니다.
TIP. 위 방법으로 추가한 알림봇 계정은, 우리 회사의 직원처럼 프로젝트에 초대하는 것도 가능합니다. (👉🏻 프로젝트에 초대하는 방법)
Q4. 알림봇 ID는 몇 개까지 만들 수 있나요?
알림봇 ID는 기업 당 최대 2개까지 생성 가능합니다.
Q5. API 호출이 실패하면 어떻게 해야 하나요?
API 호출이 실패하는 경우, 아래 항목을 순서대로 확인해 주세요!
1. 인증 정보 확인 — 토큰/키가 올바르게 입력되었는지 확인해 주세요. (Getting Started > Authorization 참고)
2. 요청 형식 확인 — 각 API 문서의 Request 탭에서 필수 값과 형식이 맞는지 확인해 주세요.
3. 에러 내용 확인 — 각 API 문서의 Error 탭에서 반환된 에러 코드의 원인과 대응 방법을 확인하실 수 있어요.
위 사항을 모두 확인했음에도 문제가 지속된다면, 개발자 포털 좌측 하단의 '의견 보내기' 버튼 또는 플로우 문의 채널로 말씀해 주세요. 빠르게 도와드리겠습니다! 🙌
Q6. 채팅방 및 프로젝트의 '연동코드'가 보이지 않아요.
특정 채팅방 혹은 프로젝트에서 연동코드가 확인되지 않는 경우, 개발자 포털 좌측 하단의 '의견 보내기' 버튼 또는 플로우 문의 채널로 문의 주시는 경우 빠르게 도움 드릴 수 있도록 하겠습니다!
📌 더 자세한 내용은 개발자 센터(OPEN API 센터)에서 확인하세요!
기능 연동 중 문제가 발생하거나 도입 관련 추가 문의가 있으시면, 언제든 채팅 또는 홈페이지 문의 채널로 편하게 말씀해 주세요. 😊