Enviar mídia

POST

/api/send/media

Enfileira o envio de imagem, vídeo, documento ou áudio a partir de uma URL pública.
Não há upload de arquivo aqui — a plataforma busca o arquivo na media_url, que
precisa estar acessível pela internet.

Responde 202, não 200. Uma media_url inacessível ou de tipo incompatível só
falha no processamento do job.

Requer janela de 24h aberta, como a mensagem livre.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonNecessário

Exemplo

{
    "phone": "+5511999999999",
    "media_type": "image",
    "media_url": "https://exemplo.com/nota-fiscal.pdf",
    "caption": "string",
    "file_name": "nota-fiscal.pdf",
    "from": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "string"
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://titov.com.br/api/send/media' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "phone": "+5511999999999",
    "media_type": "image",
    "media_url": "https://exemplo.com/nota-fiscal.pdf",
    "caption": "string",
    "file_name": "nota-fiscal.pdf",
    "from": "string",
    "first_name": "string",
    "last_name": "string",
    "email": "string"
}'

Respostas

🟢202Aceite

application/json

Aceito e enfileirado. Não confirma entrega — apenas que a mensagem entrou na fila.

Bodyapplication/json

Exemplo

{
    "status": "queued",
    "message_id": "e7c1a2b4-9d3f-4a5e-8b6c-0f1d2e3a4b5c"
}

🟠400Requisição Inválida

🟠401Não Autorizado

🟠429

🔴500Erro do Servidor

Modificado em 2026-07-17 11:51:13

Página anterior

Enviar mensagem livre

Próxima página

Listar contatos