send_media

Send an image, video, audio, voice note, document or sticker.

Send an image, video, audio, voice note, document or sticker.

​

Input

Field	Type	Notes
kind	image, video, audio, document or sticker	Limits: 5 MB, 16 MB, 16 MB, 100 MB and 100 KB.
url	string	An https link. Give this or upload_id.
upload_id	string	From create_upload. Give this or url.
caption	string, optional	Up to 1024 characters.
filename	string, optional	Up to 240 characters.
voice	boolean, optional	Sends audio as a voice note.
reply_to	string, optional	Id of the message to quote.

​

Output

{ "message_id": string, "delivery": "sent" | "queued" }. queued means the 24-hour window is closed.

A sticker must be image/webp. The size and type are checked before anything is sent.

​

Message kinds

Kind	Agent to owner	Owner to agent
text	send_message	text
image	send_media, up to 5 MB	the image inline when up to 1 MB, otherwise a signed link
video	send_media, up to 16 MB	signed link
audio	send_media, up to 16 MB, voice for a voice note	signed link
document	send_media, up to 100 MB	signed link, file name and MIME type
sticker	send_media	signed link
location	send_location	latitude, longitude, name and address
contacts	send_contact	the contact cards
reaction	react	message_id and emoji, routed to the agent that sent the reacted message
choice	ask, up to 3 options as buttons and 4 to 10 as a list	option_id, title and optional description
quote	reply_to on every send	reply_to, routed to the agent that sent the quoted message