Telegram Bot API 10.3 ephemeral sendVideo with a Sume clip

Bot API 10.3 adds ephemeral_message_parameters to sendVideo. Send a finished Sume artifact URL from your webhook handler; steps, retries and limits.

4 min readSume
All posts

Wait for the Sume job's terminal webhook, take the media.sume.com artifact url from the payload, and pass it to sendVideo with the new ephemeral_message_parameters field. Sume produces the file; whether and how Telegram shows it as ephemeral is defined by Telegram's Bot API 10.3 changelog.

What changed in Bot API 10.3?

The changelog adds the class EphemeralMessageParameters and replaces the parameters receiver_user_id and callback_query_id in methods including sendMessage, sendPhoto, sendVideo and sendVoice with one parameter, ephemeral_message_parameters. It also adds replace_callback_query_message, which lets a bot show an ephemeral message in place of the original, and editEphemeralMessageMedia, which supports uploading new files.

Telegram Bot API 10.3 ephemeral changes, read 2026-10-01.
ItemAs written in the changelog
ephemeral_message_parametersReplaces receiver_user_id and callback_query_id on send methods
replace_callback_query_messageShows an ephemeral message in place of the original
editEphemeralMessageMediaSupports upload of new files

Where does the video URL come from?

Completed Sume jobs can include public artifacts under https://media.sume.com, and the webhook payload carries them as payload.artifacts[].url. Sume-owned artifact URLs are the public contract, so use those, not provider links. Webhook URLs must be public HTTPS; localhost and private-network URLs are rejected, so your bot server needs a public endpoint. See Job webhooks.

What happens if my bot handler is slow or down?

Sume retries a job webhook up to 10 attempts, with a 10s timeout per attempt. So acknowledge quickly, store the event, and call Telegram afterward. Dedupe on job_id so a retry does not send the clip twice, and keep status_url polling as the fallback for deliveries that never arrive.

What should I check before sending?

Confirm the event is job.completed, verify the signature, and check Telegram's own file limits in its documentation; this post does not state them. For a non-ephemeral flow, see Telegram bot AI video generation.

Sources

Related posts

More in Integrations

All Integrations posts

Written by Sume