텔레그램 봇 메시지 서식 — 표·코드·접히는 인용을 휴대폰 폭에 맞추기

말풍선은 좁고, 늘 좁을 것이다

봇 메시지는 사람들이 흔히 주는 것보다 많은 구조를 담을 수 있습니다. 제목, 표, 접히는 인용, 코드, 수식. 모두 첨부도, 열 것도 없이 평범한 말풍선 안에 그려집니다. 그러면 능력과 상관없는 질문이 생깁니다. 대화 속 메시지가 메시지이기를 그만두기 전까지 구조를 얼마나 실을 수 있을까.

봇 출력의 서식 실수 대부분은 넓은 화면에서 쓰고 좁은 화면에서 읽히는 데서 옵니다. 열이 많은 표는 편집기에서는 읽히고, 거의 모두가 읽는 휴대폰에서는 줄 바뀐 조각 더미가 됩니다.

쓸 만한 규율은 폭을 고정되고 짧은 것으로 보는 것입니다. 열 두세 개, 줄이 안 바뀔 만큼 짧은 값, 한 단어짜리 제목. 거기 안 맞는 건 표의 문제가 아니라 답이 파일이나, 링크나, 여러 메시지가 되고 싶다는 신호입니다.

길이도 같습니다. 말풍선은 많이 담을 수 있고 독자는 그렇지 않습니다. 화면 여러 개를 채우는 메시지는 밑에 구조가 아무리 좋아도 첫 줄까지 훑이고 스크롤되어 지나갑니다.

공식 봇 API 는 이런 구조를 리치 메시지로 정리했습니다. 문단·제목·목록·표·수식·접히는 블록 같은 블록 종류가 있고, AI 답을 서식째 흘리는 것도 같은 묶음입니다(공식 문서의 변경 기록).

묻고 답하기

봇이 서식 잘 된 메시지를 보냈고 누가 전달했다. 무엇이 도착하나

서식은 들어 있는 대화가 입히는 게 아니라 메시지에 속해서 같이 갑니다. 양쪽에서 알아 둘 만합니다. 잘 짠 봇 답은 누가 동료에게 넘겨도 계속 통하고, 그 모양으로 돌면 곤란한 건 애초에 메시지에 넣지 말아야 합니다. 따라가지 않는 건 메시지 밖의 것입니다. 메시지에 붙은 버튼이 흔히 빠집니다.

열 많은 표는 휴대폰에서 어떻게 되나

말풍선은 페이지가 아니고, 폭은 휴대폰이 주는 만큼입니다. 안 맞는 열은 줄이 바뀌고, 정렬이 무너지고, 비교를 뻔하게 해 주던 표가 대화에서 가장 읽기 어려운 것이 됩니다. 정말 열이 많아야 한다면 정직한 선택지는 줄을 줄이거나, 파일로, 또는 제대로 배치할 수 있는 곳의 링크입니다.

평범한 글에 코드 덩어리가 맞는 건 언제인가

코드 덩어리는 띄어쓰기와 문장 부호를 정확히 지키고, 독자에게 손으로 고르지 않고 복사할 방법을 줍니다. 그래서 참조 번호, 식별자, 명령어, 글자 하나 틀리면 망가지는 모든 것에 맞습니다. 코드든 아니든. 강조로 쓰는 게 오용입니다. 평범한 문장을 읽기 어렵게 하고, 글이 뜻하지 않는 신호를 보냅니다.

봇 답이 길지만 잘 짜였다. 무엇으로 시작해야 하나

첫 줄이 읽힌다고 보장되는 유일한 부분이고, 대화에서는 알림과 대화 목록에 나오는 부분이기도 합니다. 그 밑의 구조는 이어 읽는 사람을 돕고, 맨 위 제목은 답을 한 줄 늦추며 독자가 이미 아는 걸 되풀이합니다. 질문을 다시 쓰는 건 더 나쁩니다. 중요한 한 줄을 사용자가 준 정보로 채웁니다.

구조는 명료함과 같지 않다

이름 붙여 둘 만한 패턴이 있습니다. 좋은 뜻의 봇들이 늘 빠집니다. 두 문장짜리 내용에 제목, 목록, 표, 인용을 다 입힌 답. 서식은 메시지를 생각한 것처럼 보이게 하고 읽는 데 몇 배 오래 걸리게 합니다.

쓸 만한 규칙은 구조를 내용이 벌어야 한다는 것입니다. 정말 목록이 있을 때 목록. 같은 항목으로 여럿을 비교할 때 표. 부분이 여럿일 때만 제목. 그보다 짧은 것에 입힌 건 전부 문단이었으면 나았을 메시지의 장식입니다.

절제가 구조가 나타날 때 통하게 하는 것이기도 합니다. 모든 답이 서식을 입으면 아무것도 눈에 띄지 않고, 내용에 모양이 있을 때 서식이 나오면 독자는 그게 뜻이 있다는 걸 배웁니다. 봇이 답을 흘리는 방식은 봇의 자라는 답에 있습니다.

봇 출력에 서식 입히기

1. 답을 첫 줄에 둡니다. 보장되는 건 그 줄뿐입니다.
2. 좁은 화면을 가정합니다. 열은 많아야 두세 개.
3. 긴 부분은 접히는 인용으로. 짧으면서 완전하게.
4. 정확한 문자열에 코드 덩어리를. 강조용이 아니라.
5. 구조는 내용이 벌게 합니다. 목록에는 목록이 있어야 합니다.
6. 휴대폰의 진짜 대화에서 확인합니다. 남이 보기 전에.