Skip to main content
send_conversation_media sends an image, video, or PDF inside an open customer service window. The assistant does not generate the file. You provide a file you already have. Outside the 24-hour window, this send is rejected and the assistant uses an approved template instead.

Ask this

What the assistant calls

1

Read the file rules

get_media_guidelines runs before the upload. HTML, SVG, scripts, and executables are rejected. A partial or cut-off file is rejected and is not a media id.
2

Upload

upload_media hosts the file. Pass a public https URL or one complete base64 value up to 5 MB, plus mimeType and filename when you have them.
3

Send in the thread

send_conversation_media takes the conversation id, mediaType of image, video, or document, and mediaUrl from the upload or a complete mediaBase64. A public URL is sent as a link. The caption is optional. The assistant sends it only after you ask, and only while sessionExpiresAt from list_conversations is still in the future.
Template header files and catalog images follow different size rules. Those are on Media. Thread tools are on Inbox.