Slack API

핵심 개념

Incoming Webhook

외부 시스템에서 Slack 채널로 메시지를 보낼 수 있는 단방향 URL 엔드포인트입니다. 인증 토큰 없이 간단히 POST 요청만으로 알림을 전송할 수 있습니다.

Bot Token

Slack App이 워크스페이스에 설치될 때 발급되는 인증 토큰으로, API 호출 시 Authorization 헤더에 포함하여 봇 권한으로 작업을 수행합니다.

Socket Mode

WebSocket 연결을 통해 Slack 이벤트를 실시간으로 수신하는 방식으로, 공개 인바운드 URL 없이도 버튼 클릭이나 슬래시 커맨드를 처리할 수 있습니다.

Block Kit

메시지 레이아웃을 구성하는 JSON 기반 UI 프레임워크로, 버튼·선택 메뉴·입력 필드 등 인터랙티브 요소를 조합해 리치한 메시지를 만듭니다.

Interactive Component

버튼, 선택 메뉴, 모달 등 사용자가 클릭하거나 입력할 수 있는 UI 요소로, 클릭 시 지정된 엔드포인트로 payload가 전송됩니다.

Incoming Webhook으로 메시지 전송

Webhook URL로 JSON을 POST하여 채널에 텍스트와 버튼이 포함된 메시지를 전송합니다. 버튼 클릭 시 action_id가 포함된 payload가 앱 서버로 전달됩니다.

curl -X POST https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXX \
  -H 'Content-Type: application/json' \
  -d '{
    "text": "빌드가 완료되었습니다.",
    "blocks": [
      {
        "type": "section",
        "text": {
          "type": "mrkdwn",
          "text": "*빌드 #42* 성공 :white_check_mark:"
        }
      },
      {
        "type": "actions",
        "elements": [
          {
            "type": "button",
            "text": {"type": "plain_text", "text": "배포하기"},
            "action_id": "deploy_button"
          }
        ]
      }
    ]
  }'