텔레그램 포럼 토픽에서 그냥 쓴 글이 답장으로 읽혔다
지시를 썼는데 아무 일도 일어나지 않았다. 처리 중 표시가 뜨지 않았고 오류 메시지도 없었다. 채팅에서 보기에는 봇이 메시지를 못 받은 것과 구별이 되지 않았다.
2026년 10월 중순의 일이다. 커뮤니티용 텔레그램 봇은 포럼 토픽이 켜진 그룹에서 토픽별로 다른 기능을 맡는데, 그중 한 토픽에서는 사용자가 쓴 글을 지시로 받아 처리한다. 지시를 받으면 먼저 처리 중이라는 표시를 띄우고, 끝나면 결과를 올린다. 그 표시조차 없이 같은 유형으로 세 번 사라졌다.
세 번 모두 보낸 직후에 반응이 없다는 걸 알았다. 자정 무렵에 한 번, 이튿날 아침에 두 번이었다. 첫 번째부터 고친 커밋까지 여덟 시간 반쯤 걸렸다.
고치기 전에 로그 한 줄부터 넣었다
예외가 없으니 트레이스백도 없었다. 메시지 핸들러는 텍스트를 받아 여러 갈래 중 하나로 넘기고, 어느 갈래에도 해당하지 않으면 False를 반환하고 끝난다. 조용히 False가 나가는 경로가 여러 곳이라 사라진 지시가 그중 어디로 빠졌는지 알 방법이 없었다.
원인을 추측해서 고치지 않고 진단용 로그를 먼저 넣었다. 핸들러 진입부에서 메시지 id, 보낸 사람, reply_to 대상의 id, 본문 길이를 한 줄로 남긴다. 다음에 사라지면 어디까지 왔는지는 보인다.
다음 지시가 사라졌을 때 로그에 답이 있었다. 사용자는 답장 기능을 쓰지 않고 그냥 글을 썼는데 로그의 reply_to에는 값이 들어 있었다. 그 토픽의 thread id와 같은 숫자였다.
토픽에 그냥 쓴 글에도 reply_to_message가 온다
포럼 토픽은 토픽을 만들 때 생기는 서비스 메시지를 머리로 하는 스레드다. 토픽의 message_thread_id는 그 서비스 메시지의 id와 같다. 그리고 토픽 안에 쓴 일반 메시지는 reply_to_message에 이 토픽 머리 메시지가 채워져서 봇에게 온다. 사용자가 누구에게도 답장하지 않았는데도 그렇다.
내 코드는 답장 여부를 이렇게 판정하고 있었다.
reply = message.reply_to_message
if reply is not None:
... # 답장 갈래: 답장 대상이 무엇인지에 따라 처리
토픽이 아닌 채팅에서는 맞는 판정이다. 토픽에서는 그냥 쓴 글이 답장으로 분류된다. 답장 갈래는 답장 대상이 무엇인지를 보고 할 일을 정하는데, 토픽 머리 메시지는 그 조건 어디에도 해당하지 않는다. 답장 갈래로 들어갔다가 아무 데도 걸리지 않고 False로 끝났고, 원래 가야 했던 “그냥 쓴 글” 갈래는 타 보지도 못했다.
정상적인 반환값으로 끝났으니 로그에도 채팅에도 남는 것이 없었다. 처리 중 표시는 갈래 안에서 띄우는데 그 갈래에 닿지 못했으니 표시도 뜨지 않았다.
수정은 토픽 머리를 가리키는 reply_to_message를 답장으로 치지 않는 것이다.
reply = message.reply_to_message
# 포럼 토픽의 그냥 글은 reply_to_message 에 토픽 머리(생성 서비스 메시지,
# id = thread id)가 채워져 온다. 답장이 아니다.
if reply is not None and (
reply.message_id == getattr(message, "message_thread_id", None)
or getattr(reply, "forum_topic_created", None)
):
reply = None
조건은 두 개고 하나만 맞아도 된다. 답장 대상의 id가 메시지의 thread id와 같거나, 답장 대상이 토픽 생성 서비스 메시지(forum_topic_created가 채워진 메시지)인 경우다. 갈래를 나누기 전에 이 정규화를 한 번 해 두면 아래의 분기는 고칠 필요가 없다. 사용자가 토픽 안에서 특정 메시지에 실제로 답장한 경우에는 reply_to_message가 그 메시지를 가리키므로 이 조건에 걸리지 않는다.
테스트도 하나 추가했다. thread id와 같은 id를 가진 토픽 생성 메시지를 reply_to_message로 단 가짜 메시지를 만들어 핸들러에 넣고, 그냥 쓴 글의 갈래로 넘어가는지 확인한다.
수정 뒤에는 같은 지시에 처리 중 표시가 바로 떴다.
석 달 전의 Message thread not found
토픽 때문에 걸린 건 이번이 처음이 아니었다. 같은 해 7월에 다른 기능에서, 그룹의 General 토픽으로 확인 메시지를 보내려다 이런 오류로 실패했다.
Message thread not found
이쪽은 봇이 보내는 방향의 규칙이다.
포럼 그룹에는 따로 만들지 않아도 있는 General 토픽이 있다. General 토픽에 쓴 메시지에는 message_thread_id가 없다. 내 코드는 토픽을 구분해서 다루기 편하도록 이 빈 값을 1로 채워 두고 썼다.
thread_id = message.message_thread_id or 1
들어온 메시지가 어느 토픽 것인지 비교하는 데는 이 값이 편했다. 그런데 그 값을 발송에도 그대로 넘겼다. General 토픽으로 확인 메시지를 보내면서 message_thread_id=1을 넣었고, 텔레그램은 “Message thread not found”로 거절했다. General 토픽으로 보내려면 이 필드를 아예 넣지 않아야 한다.
발송 직전에 값을 바꿔 주는 작은 함수를 두고, 발송에 넘기는 thread id는 이 함수를 거치게 했다.
def _thread_arg(thread_id: int | None) -> int | None:
# General 토픽(1)은 필드를 생략해서 지정한다.
return None if thread_id in (None, 1) else thread_id
내부에서 쓰는 표현과 API에 넘기는 표현이 다르다는 걸 함수 이름으로 드러낸 셈이다. 비교할 때는 1, 보낼 때는 생략이다.
토픽이 없는 채팅에서 만든 코드를 토픽 그룹에 붙이면서 받는 쪽의 reply_to_message와 보내는 쪽의 message_thread_id에서 한 번씩 걸렸다.