If you've ever tried to set a custom video avatar on Telegram from an iPhone clip, you've probably seen the file get accepted, then quietly never appear. No error, no toast, just nothing. I went down this rabbit hole and ended up building a bot to fix it. Here's what I learned.

The Pain: iPhone Videos Silently Fail

iPhone records video as HEVC (H.265) inside a .mov container by default. Telegram's video avatar feature has a very narrow spec, and HEVC isn't part of it. Desktop clients sometimes surface a generic error, but mobile clients usually accept the upload and then refuse to render it. You see the spinner, then nothing.

The first time this happened to me I thought my account was broken. Turns out the file just didn't match the spec.

What Telegram Actually Requires