Enviar uma mensagem de mídia

Mídia direta é um dos três modos mutuamente exclusivos do único endpoint de envio — não existe um endpoint separado /messages/media:

POST https://pilotstatus.com.br/v1/messages/send

Requisição

Autentique com sua chave de API com escopo de número no header x-api-key. Envie media + mediaType sem templateId e sem text.

string

obrigatório

Telefone de destino em E.164 com + inicial (ex.: +5511999999999).

string

obrigatório

Uma URL http(s) pública ou um data URI base64 (ex.: data:image/png;base64,...). Base64 funciona em números Meta Cloud API; números não oficiais (Pilot Status web) exigem uma URL pública.

string

obrigatório

image, video, document, audio, voice ou sticker.

string

Legenda opcional para image, video e document — não suportada para audio, voice ou sticker.

curl -X POST "https://pilotstatus.com.br/v1/messages/send" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ps_sua_chave_aqui" \
  -d '{
    "destinationNumber": "+5511999999999",
    "media": "https://cdn.example.com/photo.jpg",
    "mediaType": "image",
    "caption": "Aqui está o seu comprovante"
  }'

curl -X POST "https://pilotstatus.com.br/v1/messages/send" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ps_sua_chave_aqui" \
  -d '{
    "destinationNumber": "+5511999999999",
    "media": "https://cdn.example.com/voice.ogg",
    "mediaType": "audio"
  }'

curl -X POST "https://pilotstatus.com.br/v1/messages/send" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ps_sua_chave_aqui" \
  -d '{
    "destinationNumber": "+5511999999999",
    "media": "https://cdn.example.com/figurinha.webp",
    "mediaType": "sticker"
  }'

Resposta (202)

{
  "id": "msg_abc",
  "correlationId": "corr_123",
  "status": "QUEUED"
}

Observações

audio é sempre entregue como uma nota de voz (PTT) do WhatsApp.
sticker precisa ser image/webp e ter exatamente 512×512 pixels — estática até 100 KB, animada até 500 KB. Outro formato ou outra dimensão é recusado pelo WhatsApp, não por esta API: a falha chega no webhook message.failed, não na resposta 202. Figurinha não aceita caption nem mediaFilename (os dois retornam 400) e não pode ser enviada como mídia de template.
Neste modo, buttons, header, footer e variables não são permitidos — para combinar mídia com botões, use um envio de template (veja Enviar interativos).
Para formatos, limites de tamanho e diferenças entre provedores, veja o guia de mensagens de mídia; para a lista completa de parâmetros, veja Enviar uma mensagem.

Visão Geral

Mensagens

Modelos

Números

Conversas & Dados

Webhooks

Chamadas de Voz

Camada de Compatibilidade

Conta & Cobrança

Marca & Incorporação

Enviar uma mensagem de mídia — POST /v1/messages/send

Enviar uma mensagem de mídia

Requisição

Resposta (202)

Observações

​Enviar uma mensagem de mídia

​Requisição

​Resposta (202)

​Observações

Enviar uma mensagem de mídia

Requisição

Resposta (202)

Observações