Skip to main content
Para enviar imagens, vídeo, áudio ou documentos, primeiro você envia o arquivo e obtém um file_uuid, que depois passa a uma ação de envio.
1

Peça uma URL de upload

Com { filename, mime_type, size_bytes }. Responde 201 com file_uuid, upload_url, upload_token, storage_path e expires_at.
2

Envie o binário

Envie o arquivo para a upload_url que você recebeu, antes que expire (expires_at).
3

Confirme

Com { file_uuid }. Responde 200 com file_uuid, mime_type, size_bytes, download_url e expires_at. A partir daqui o file_uuid é enviável.
Uma vez confirmado, passe o file_uuid a uma ação de envio — como mídia direta em send_message, ou como header de um template:
O header.type ∈ image | video | document leva file_uuid (document aceita um filename opcional). Em send_message no modo mídia, o file_uuid vai no nível da ação com body como legenda opcional (o áudio não admite legenda).
Se o preflight rejeitar o grupo, a resposta é um 4xx síncrono e nenhuma ação é executada. Ver Erros.

​
Exemplo executável

O fluxo completo em três chamadas. O file_uuid que o passo 3 confirma é o que você depois passa a uma ação de envio. 1 · Peça uma URL de upload
2 · Envie o binário para a upload_url antes que expire
3 · Confirme