Pular para o conteúdo principal

​
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.
​
destinationNumber
string
obrigatório
Telefone de destino em E.164 com + inicial (ex.: +5511999999999).
​
media
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.
​
mediaType
string
obrigatório
image, video, document ou audio.
​
caption
string
Legenda opcional para image, video e document — não suportada para 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/photo.jpg",
    "mediaType": "image",
    "caption": "Aqui está o seu comprovante"
  }'

​
Resposta (202)

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

​
Observações

  • audio é sempre entregue como uma nota de voz (PTT) do WhatsApp.
  • 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.