안녕하세요, 천상나타입니다.

    알림 봇을 채널에 붙이는 작업을 하다가 보니 "텔레그램 채널 만들기 + 봇 만들기 + 둘 연결하기"가 생각보다 설명이 흩어져 있더라고요. 채널 생성은 쉬운데, 봇 연결과 chat_id 얻기에서 튜토리얼대로 안 되는 부분이 있었습니다. 제가 실제로 겪은 과정 그대로 한 번에 정리했어요.

    채널 생성부터 chat_id 획득까지 4단계 흐름

    1. 채널 만들기

    이건 정말 간단해요.

    1. 텔레그램 메뉴 → 새 채널
    2. 이름·소개 입력 (소개엔 채널이 주는 가치를 한 줄로 — 검색·공유될 때 보이는 얼굴입니다)
    3. 공개/비공개 선택 — 공개로 하면 t.me/아이디 주소가 생기고 검색에도 걸립니다. 구독자를 모을 채널이면 공개 추천

    2. 봇 만들기 — @BotFather

    봇 생성은 전부 @BotFather와의 대화로 끝납니다.

    1. 텔레그램 검색에서 @BotFather → 대화 시작
    2. /newbot 입력
    3. 표시 이름 입력 → username 입력 (반드시 bot으로 끝나야 함)
    4. 토큰 발급 — 123456789:AAE... 형태. 이게 봇의 전권을 쥔 열쇠라서 .env 같은 데 안전하게 보관하고, 유출됐다 싶으면 /revoke로 즉시 재발급하세요

    여기까지면 봇 자체는 완성이에요. 공개 채널에 붙일 거면 /setdescription, /setabouttext, /setuserpic으로 프로필도 채워두면 좋습니다.

    3. 봇을 채널 관리자로 추가 — 첫 번째 함정

    봇이 채널에 글을 쓰려면 관리자여야 합니다.

    1. 채널 → 맨 위 채널 이름 탭 → 관리자 → 관리자 추가
    2. 검색창에 봇의 @username 입력 → 선택 → 메시지 게시 권한 ON

    함정: 표시 이름으로는 검색이 안 될 수 있어요. 반드시 @xxx_bot 유저네임을 그대로 입력해야 목록에 뜹니다. 그래도 안 나오면 BotFather /mybots에서 username을 다시 확인해보세요.

    한 봇이 여러 채널의 관리자가 될 수 있어서, 채널이 늘어도 봇을 새로 만들 필요는 없습니다. 다만 공개 채널은 채널 성격에 맞는 전용 봇이 깔끔해요.

    4. chat_id 얻기 — @userinfobot 말고 이 방법으로

    봇 API로 메시지를 보내려면 채널의 chat_id가 필요한데, 흔한 안내가 "채널 메시지를 @userinfobot에 전달하면 알려준다"예요. 근데 실제로 해보니 전달 버튼 자체가 안 보이는 경우가 있었습니다.

    더 확실한 방법: 봇 API getUpdates로 직접 읽기.

    
    https://api.telegram.org/bot<토큰>/getUpdates
    

    봇을 채널 관리자로 넣은 뒤 채널에 메시지를 하나 올리면, 응답의 channel_post 이벤트 안에 채널 chat_id가 -100... 형태로 그대로 들어있어요. 관리자 등록 이벤트(my_chat_member)에도 찍힙니다.

    주의할 점 — getUpdates는 그 봇이 본 이벤트만 보여줘요. 봇이 관리자가 아니거나 다른 봇으로 조회하면 빈 배열이 나옵니다. 저는 새 봇으로 조회해서 계속 비어 나오다가, 알고 보니 예전 봇이 관리자로 들어가 있어서 예전 봇 토큰으로 조회하니 전부 보였어요. 봇이 여러 개면 "어느 봇으로 보고 있나"부터 확인하는 게 정답입니다.

    직접 겪은 함정 4가지 정리

    5. 실제로 메시지 보내기

    chat_id까지 구했으면 발송은 HTTP 요청 하나로 끝납니다.

    
    curl -X POST "https://api.telegram.org/bot<토큰>/sendMessage" \
      -d "chat_id=-100xxxxxxxxxx" \
      --data-urlencode "text=테스트 메시지"
    

    {"ok":true}가 오면 채널에 바로 올라가 있어요. 라이브러리 없이 curl만으로도 다 되는데, 이게 제일 확실한 연결 테스트이기도 합니다. 여기서 실패하면 토큰·chat_id·관리자 권한 셋 중 하나가 틀린 거예요.

    BotFather 커맨드와 API 호출 요약

    정리

    전체 순서만 보면 채널 생성 → BotFather로 봇 생성 → 봇을 관리자로 추가 → getUpdates로 chat_id 확인, 딱 4단계예요. 시간이 걸렸던 건 생성이 아니라 "봇이 안 보임", "전달 버튼 없음", "getUpdates 빈 배열" 같은 주변 함정들이었는데, 원인을 알고 나면 전부 1분이면 풀립니다.

    이 채널+봇 조합으로 저는 자동 알림(수집기 → 채널 발송)을 붙여서 쓰고 있는데, 그 자동화 파이프라인 얘기는 다음 글에서 정리할게요.

    728x90
    Posted by 천상나타.