Tell your agent, and it posts to every channel you connected

채널

에이전트가 업리카로 텔레그램 채널·그룹에 올리는 방법. 내 봇, 봇이 올릴 수 있는 채팅, 그리고 Bot API 가 못 하는 것.

한눈에

이름	타입	설명
`characters`	text	4,096
`images`	media	up to 10 per post; more than that and the first 10 go out with a warning
`carousel`	media	2-10 items, images and video can be mixed
`video`	media	10 per post
`text alone`	media	allowed
`posts / 24h`	limit	28,800
`deletes / 24h`	limit	Telegram only within 48 hours of publishing, with no documented daily cap
`status`	state	live

이 숫자는 서버가 검증에 쓰는 파일에서 그대로 옵니다. 본문 상한이 미디어 유무로 갈립니다. 텍스트 메시지 4,096자, 캡션 1,024자, 코드포인트로 셉니다.

주소를 치지 않고 왜 채팅을 고르나요?

비공개 채널에는 @주소가 없고 텔레그램 앱 어디에도 안 보이는 숫자 id 뿐입니다. 그래서 토큰을 넣으면 업리카가 봇의 최근 업데이트를 읽어 봇이 추가된 채팅을 목록으로 보여 줍니다. 목록이 비면 봇을 관리자로 넣고 그 채팅에서 /start@내봇 을 보낸 뒤 다시 하세요.

미디어는 어떻게 나가나요?

이미지나 영상 하나는 본문을 캡션으로 단 사진·영상 메시지로 나갑니다. 여럿이면 앨범으로 나가는데 텔레그램은 그걸 메시지 여럿으로 저장합니다. 업리카가 메시지 id 를 전부 보관해서 삭제하면 첫 장이 아니라 앨범 전체가 지워집니다.

첫 글은 어떻게 올리나요?

본문으로 publish 를 부릅니다. 마크다운은 해석하지 않고 쓴 대로 나갑니다.

curl -X POST https://api.uplika.com/v1/posts \
  -H "Authorization: Bearer $UPLIKA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Shipped nested replies today.",
    "accountIds": ["conn_..."]
  }'

options.telegram 이 받는 것

이름	타입	설명
`content`	string	Text for this channel only. When set it replaces the shared content for this channel, and the length and media checks use it. Leave it out to use the shared content.

텔레그램에는 채널 고유 설정이 없습니다. 다른 채널처럼 content, 이 채널에만 나가는 다른 본문은 받습니다.

안 되는 것은?

지표, 댓글, 채널 기록 읽기. Bot API 에 그 메서드가 없어서 get_insights 와 list_replies 는 빈 값 대신 못 한다고 답합니다. 삭제는 발행 후 48시간 안에만 됩니다. 그 뒤에는 텔레그램이 봇의 삭제를 막고 오류가 그 사실을 말합니다.

자주 묻는 것

업리카가 내 텔레그램 계정을 보나요?

아니요. 내가 만든 봇 토큰을 봉해 두고 그것으로 Bot API 를 부릅니다. 내 계정은 관여하지 않습니다.

채팅 목록이 왜 비어 있나요?

봇이 아직 어느 채팅에도 관리자로 안 들어갔거나, 들어갔는데 업데이트가 안 닿았기 때문입니다. 넣고, 그 채팅에서 /start@내봇 을 보내고, 다시 하세요.

조회수가 왜 없나요?

Bot API 에 그 메서드가 없습니다. 빠진 기능이 아니라 텔레그램의 한계이고, get_insights 는 0 대신 지원 안 함이라고 답합니다.