Slack·Discord 알림 연결
프로젝트 설정에서 알림 받을 주소를 등록하면 중요한 변경 사항이 팀 채널로 전달됩니다.
Slack / Discord 연결
알림 주소 받기
Slack은 '채널 설정 → 앱 → Incoming Webhooks', Discord는 '채널 편집 → 연동 → 웹훅 만들기'에서 메시지를 받을 채널의 주소(URL)를 만들어 복사합니다.
프로젝트 설정에 등록
Tabple 프로젝트 설정 > '앱 & 연동' 탭에서 '웹훅 직접 등록'을 누르고, '연동 추가'로 Slack·Discord·Webhook 중 종류를 고른 뒤 주소를 붙여넣습니다. 이름은 비워 두어도 됩니다. 마켓에서 'Slack'·'Discord'·'범용 웹훅' 앱을 설치해도 같은 연동이 만들어집니다.
알림 종류 선택
'알림 이벤트'에서 받고 싶은 이벤트만 고르세요. 채팅(채팅 메시지·채팅 멘션)과 '태스크 & 기타'(태스크 생성·이동·완료·삭제, 담당자 지정, 댓글 작성, 앱 설치·제거)가 있고, '웹훅 직접 등록'에서는 처음에 태스크 생성·이동·완료, 댓글 작성, 채팅 메시지가 선택되어 있습니다.
발송되는 이벤트
- task.created — 새 태스크 생성 (반복 일정을 만들면 회차마다 한 건)
- task.moved — 컬럼 이동 (이전·이후 컬럼명 포함 — 보드에서 끌어 옮기기·일괄 이동 포함)
- task.completed — 완료 컬럼 도착
- task.assigned — 새 담당자 지정 (새로 맡은 사람마다 한 건, 담당자 이름 포함)
- task.deleted — 태스크 삭제 (일괄 삭제는 태스크마다 한 건)
- comment.created — 태스크에 새 댓글 (본문 앞부분 포함)
- chat.message / chat.mention — 채널에 올라온 채팅 메시지·멘션 (스레드 답글은 보내지 않음)
- app.installed / app.uninstalled — 이 프로젝트에 앱을 설치하거나 제거함
직접 만든 시스템과 연결
전송 형식
'Webhook' 종류로 등록하면 이벤트가 생길 때마다 JSON 본문을 POST로 받습니다. 이벤트 종류(event)와 프로젝트, 작업한 사람, 태스크·댓글·채팅 정보, 시각(timestamp)이 한 번에 담겨 옵니다. Zapier·Make·n8n 같은 자동화 도구도 이 방식으로 연결합니다.
{
"event": "task.completed",
"project": { "id": 12, "name": "Marketing Sprint" },
"actor": { "id": 7, "name": "Geun" },
"task": { "id": 4521, "title": "랜딩 카피 검토", "priority": "high",
"url": "https://tabple.com/projects/12/board?task=4521" },
"from": { "name": "진행 중" },
"to": { "name": "완료" },
"timestamp": "2026-05-05T08:21:11.302Z"
}전송 실패
받는 쪽이 5초 안에 응답하지 않거나 오류를 돌려주면 2초, 8초 간격으로 처음 시도를 포함해 최대 3번까지 다시 보냅니다. 400번대 오류(429 제외)는 다시 보내도 같은 답이라 재시도하지 않습니다. 끝내 실패해도 Tabple 작업은 계속 진행됩니다. 프로젝트 설정 > '앱 & 연동' > '설치된 앱'에서 '전달 로그'를 열면 최근 50건의 이벤트·상태·시도 횟수·응답 코드를 볼 수 있고, 전달 로그는 30일 동안 보관됩니다.
요청 서명 확인
마켓에서 웹훅 앱을 설치할 때 '서명 시크릿 (선택)'을 채우면 모든 요청에 X-Tabple-Timestamp(Unix 초)와 X-Tabple-Signature 헤더가 붙습니다. 서명은 <타임스탬프>.<원본 본문> 문자열을 시크릿으로 HMAC-SHA256 계산한 hex 값 앞에 v1=을 붙인 형태입니다.