카카오워크 API로 업무 알림 자동화 (시스템 설계, 센서 연동, 알림 최적화)
업무 중에 누군가 계속 화면을 바라보고 있어야 하는 상황, 한 번쯤 겪어보셨을 겁니다. 저도 그랬습니다. 차량이 들어왔는지, 온도가 괜찮은지, 사람이 직접 확인해야 하는 일들이 하나씩 쌓이기 시작하면서 카카오워크 API를 이용한 사내 알림 자동화 시스템을 직접 설계하고 운영하게 됐습니다.
시스템 설계: 사람이 보던 것을 기계가 대신 보게 만들다
회사에서 처음 받은 미션은 단순했습니다. 주말에 정문을 통과하는 차량을 감지하면 담당자에게 알려달라는 것이었습니다. 물류 차량은 들어와야 하지만 관계없는 외부 차량이 무단으로 주차하는 문제가 반복되고 있었고, 그렇다고 사람이 매주말 정문을 지킬 수는 없는 노릇이었습니다.
그래서 정문에 센서를 설치하고, 차량이 지나가면 신호를 받아 서버로 전송하는 구조를 만들었습니다. 여기서 사용한 것이 ESP8266이라는 Wi-Fi 내장 마이크로컨트롤러입니다. ESP8266이란 저렴한 비용으로 Wi-Fi 통신이 가능한 초소형 컴퓨터 모듈로, IoT(사물인터넷) 프로젝트에서 많이 쓰입니다. 센서가 이벤트를 감지하면 ESP8266이 이를 받아 회사 내부 서버로 HTTP 요청을 날리는 방식입니다.
서버에서는 그 데이터를 받아 기록하고, 조건에 따라 카카오워크 API를 호출합니다. 여기서 HTTP RPC(Remote Procedure Call)라는 방식이 사용됩니다. HTTP RPC란 특정 기능을 URL로 표현해서 호출하는 방식으로, REST API가 리소스 중심으로 설계되는 것과는 달리 기능 중심으로 URL이 구성됩니다. 카카오워크 API가 이 방식을 채택하고 있어서, 예를 들어 메시지를 보내는 기능은 카카오워크 공식 API 문서에서 확인할 수 있듯이 https://api.kakaowork.com/v1/messages.send 같은 URL로 표현됩니다.
전체 흐름을 정리하면 이렇습니다.
- 정문 센서가 차량을 감지하고 신호를 발생시킵니다.
- ESP8266이 신호를 받아 Wi-Fi를 통해 회사 서버에 HTTP 요청을 전송합니다.
- 서버에서 데이터를 받아 데이터베이스에 저장하고 조건을 판단합니다.
- 조건이 충족되면 카카오워크 API(messages.send)를 호출합니다.
- 담당자의 카카오워크 앱에 알림 메시지가 도착합니다.
제가 직접 설계하면서 느낀 것은, 이 구조가 생각보다 단순하다는 점이었습니다. 핵심은 센서가 사실을 전달하고, 서버가 그 사실을 판단하고, 필요한 경우에만 사람에게 알린다는 것입니다. 기술보다 이 흐름을 먼저 그리는 것이 훨씬 중요했습니다.
센서 연동: 온습도 측정기로 같은 구조를 반복 적용하다
차량 감지 시스템이 안정적으로 돌아가고 나서, 비슷한 방식으로 회사 생산시설의 온습도 관리 시스템도 만들었습니다. 각 위치에 온습도 센서를 설치하고, 역시 ESP8266을 통해 측정값을 서버로 전송하는 구조였습니다. 센서는 달라졌지만 구조는 거의 동일했습니다.
서버에서는 전달받은 온도와 습도 값을 데이터베이스에 저장하고, 미리 설정해둔 임계값(Threshold)과 비교합니다. 임계값이란 정상 범위의 경계가 되는 기준 수치로, 이 값을 넘거나 밑돌 때 알림이 발생하도록 설정합니다. 예를 들어 온도가 정해진 상한선 이상이 되면 카카오워크 API를 호출해서 관리자에게 메시지를 보내는 방식입니다.
이 시스템을 만들 때 카카오워크 API에서 사용한 것은 주로 messages.send와 users.find_by_email이었습니다. users.find_by_email이란 이메일 주소로 워크스페이스 멤버 정보를 조회하는 API로, 담당자의 사용자 ID를 동적으로 찾아서 메시지를 보낼 때 유용합니다. 담당자가 바뀌어도 이메일만 수정하면 되기 때문에 유지보수 측면에서도 편리했습니다.
솔직히 이건 예상 밖이었습니다. 처음에는 API를 쓰려면 복잡한 인증 과정이 많을 것이라고 생각했는데, 카카오워크 API는 Bot 토큰을 HTTP 헤더에 담아 보내는 방식으로 인증이 처리되어 구조 자체는 크게 복잡하지 않았습니다. 문서도 기능별로 잘 정리되어 있어서 Users, Conversations, Messages 같은 API 종류별로 필요한 것을 찾기가 수월했습니다.
카카오워크가 업무용 메신저라는 점도 중요했습니다. 카카오톡으로 웹 발신 메시지를 보내려면 비용 문제나 규제가 따릅니다. 일반적으로 카카오톡 알림톡은 사업자 심사, 템플릿 승인 등 절차가 복잡하고 건당 비용이 발생합니다. 반면 카카오워크는 사내 플랫폼으로 API가 체계적으로 정리되어 있어서 내부 알림 용도로는 훨씬 합리적인 선택이었습니다. 무엇보다 직원들이 이미 업무에서 쓰고 있는 메신저라 별도의 앱 설치나 교육이 필요 없다는 것이 가장 실용적인 장점이었습니다.
알림 최적화: 많이 보내면 의미가 없어진다
시스템을 처음 만들고 나서 한 가지 실수를 했습니다. 이벤트가 발생할 때마다 무조건 알림을 보내도록 설정했다가, 담당자에게 알림이 너무 많이 쌓이는 문제가 생겼습니다. 온도가 기준을 살짝 넘었다가 바로 내려와도 알림이 가고, 차량이 정상적으로 지나가도 알림이 갔습니다. 결국 알림을 아무도 제대로 확인하지 않게 됐습니다.
이 문제를 해결하기 위해 서버 로직에 디바운싱(Debouncing) 처리를 추가했습니다. 디바운싱이란 연속으로 발생하는 이벤트를 일정 시간 묶어서 한 번만 처리하도록 만드는 기법입니다. 온도가 일정 시간 이상 지속적으로 범위를 벗어났을 때만 알림이 가도록 조건을 바꿨고, 같은 유형의 알림은 일정 시간 내에 중복으로 발송되지 않도록 처리했습니다.
차량 감지 시스템도 비슷하게 조정했습니다. 주중 정상 운영 시간대에는 알림을 보내지 않고, 주말이나 야간 시간대에만 알림이 발생하도록 시간 조건을 추가했습니다. 서버에 조건 판단 로직이 있었기 때문에 이런 수정이 어렵지 않았습니다. 만약 센서에서 카카오워크로 직접 메시지를 보내는 구조였다면 이런 유연한 조건 처리는 불가능했을 것입니다.
제 경험상 이건 좀 다릅니다. 알림 시스템의 완성도는 “얼마나 많이 보내느냐”가 아니라 “얼마나 필요한 순간에만 보내느냐”에 달려 있습니다. 알림이 너무 많으면 사람은 알림 자체를 무시하기 시작합니다. 결국 가장 중요한 순간에 알림이 눈에 띄지 않게 되는 것입니다.
다만 카카오워크 API를 쓰면서 한 가지 아쉬운 점도 있었습니다. 메시지 발송 자체는 잘 되는데, 실제 담당자 기기에서 알림 푸시(Push Notification)가 뜨지 않는 경우가 종종 있었습니다. 푸시 알림이란 앱이 실행되지 않은 상태에서도 기기 화면에 표시되는 알림을 말합니다. 이건 카카오워크 앱의 알림 설정이나 기기 자체의 배터리 최적화 설정과 관련된 문제였는데, 발송 측에서 완전히 제어할 수 없다는 것이 아쉬웠습니다. 그래도 메시지 발송 자체는 안정적이고, 발신자 정보나 메시지 내용도 자유롭게 구성할 수 있어서 전반적인 활용성은 충분히 높다고 생각합니다.
카카오워크 API에 대한 더 자세한 기술 문서는 카카오 i 개발자 센터 공식 문서에서 확인할 수 있습니다. Users, Conversations, Messages, Reactive 등 기능별로 분류가 잘 되어 있어서 원하는 기능을 찾기 수월합니다.
자주 묻는 질문
Q. 카카오워크 API를 쓰려면 별도의 계정이나 비용이 필요한가요?
A. 카카오워크 워크스페이스가 있어야 하고, 그 안에서 Bot을 생성해야 API를 사용할 수 있습니다. Bot 생성 자체는 워크스페이스 관리자 권한으로 가능하며, 내부 알림 자동화 용도로 활용할 때는 별도의 추가 비용 없이 사용할 수 있다는 점이 카카오톡 웹 발신 대비 큰 장점입니다.
Q. 센서에서 카카오워크로 직접 메시지를 보내면 안 되나요?
A. 기술적으로 가능하지만, 직접 연결 구조는 조건 판단이 어렵고 유지보수도 까다롭습니다. 서버를 중간에 두면 데이터 저장, 조건 변경, 알림 빈도 조절 등을 유연하게 처리할 수 있습니다. 제가 직접 써봤는데, 서버를 중간 단계로 두는 것이 장기 운영에서 훨씬 유리했습니다.
Q. 카카오워크 API에서 messages.send와 messages.send_by_email은 어떻게 다른가요?
A. messages.send는 채팅방 ID를 알고 있을 때 해당 채팅방에 메시지를 보내는 방식이고, messages.send_by_email은 이메일 주소로 사용자를 찾아 1:1 채팅방에 바로 메시지를 보내는 방식입니다. 담당자가 자주 바뀌는 환경이라면 이메일 기반 발송이 더 편리하고, 특정 채팅방으로 보내야 한다면 conversations.open으로 채팅방을 먼저 열고 messages.send를 사용하는 것이 일반적입니다.
Q. 카카오워크 알림이 기기에 뜨지 않는 경우는 왜 발생하나요?
A. 메시지 발송 자체는 서버에서 API 호출로 완료되지만, 실제 기기에서 푸시 알림이 뜨는 것은 카카오워크 앱의 알림 설정, 기기의 배터리 최적화 설정, 네트워크 상태에 따라 달라집니다. 발송 측에서 완전히 제어할 수 없는 영역이기 때문에, 중요도가 높은 알림이라면 수신자가 앱 알림 설정을 확인해두는 것이 좋습니다.
Q. 이런 시스템을 만들 때 어떤 서버 언어가 적합한가요?
A. 카카오워크 API는 HTTP 기반이기 때문에 서버 언어에 제한이 없습니다. 저는 PHP를 사용했지만 Python, Node.js, Java 등 HTTP 요청을 처리할 수 있는 언어라면 무엇이든 동일하게 적용할 수 있습니다. 중요한 것은 언어 선택보다 조건 판단 로직을 어떻게 설계하느냐입니다.
지금 회사에서 누군가 반복적으로 화면을 보며 확인하고 있는 일이 있다면, 한 번쯤 생각해보시면 좋겠습니다. 그 확인 작업이 정말 사람이 해야 하는 일인지를요. 저는 이 시스템을 만들고 나서 업무에서 자동화가 가능한 영역을 먼저 찾는 습관이 생겼습니다. 카카오워크 API 하나가 만들어낸 작은 변화였지만, 실제 업무 흐름에서는 꽤 큰 차이가 났습니다.
—
참고: https://docs.kakaoi.ai/kakao_work/webapireference/