​

Enviar uma mensagem de mídia

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

​

Requisição

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": "voice"
  }'

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

• Para enviar uma nota de voz (PTT) do WhatsApp em qualquer número, use voice. Use audio só quando quiser um arquivo de áudio em um número oficial (Meta Cloud API) — em números não oficiais (Pilot Status web), audio também chega como nota de voz. Veja Áudio e nota de voz.
• 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.