Como Enviar Mensagens com Midia pela API do WhatsApp

Tipos de Midia Suportados

A API do WhatsApp Business suporta o envio de quatro tipos principais de midia: imagens, videos, documentos e audios. Cada tipo tem limites de tamanho e formatos especificos que devem ser respeitados.

Metodos de Envio

Existem duas formas de enviar midia:

1. Por URL: Fornecer uma URL publica do arquivo (mais simples)
2. Por Media ID: Fazer upload previo e usar o ID retornado (mais confiavel)

Enviando Imagem por URL

POST /v18.0/{PHONE_ID}/messages
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "image",
  "image": {
    "link": "https://exemplo.com/imagem.jpg",
    "caption": "Confira nossa nova colecao!"
  }
}

Fazendo Upload Previo

Para maior confiabilidade, faca upload do arquivo antes de envia-lo:

// Passo 1: Upload
POST /v18.0/{PHONE_ID}/media
Content-Type: multipart/form-data
file: [arquivo binario]
type: "image/jpeg"
messaging_product: "whatsapp"

// Resposta: { "id": "MEDIA_ID_123" }

// Passo 2: Enviar usando o Media ID
POST /v18.0/{PHONE_ID}/messages
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "image",
  "image": {
    "id": "MEDIA_ID_123",
    "caption": "Confira nossa nova colecao!"
  }
}

Enviando Documentos

Documentos sao ideais para enviar recibos, contratos e catalogos em PDF:

{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "document",
  "document": {
    "link": "https://exemplo.com/catalogo.pdf",
    "caption": "Catalogo de produtos 2025",
    "filename": "catalogo-2025.pdf"
  }
}

Dicas Importantes

• Comprima imagens e videos antes do envio para economizar banda e custos
• Use o campo caption para adicionar contexto a midia
• Em templates com header de midia, o upload deve ser feito no momento do envio
• Media IDs expiram apos 30 dias — faca novo upload se necessario
• URLs precisam ser publicamente acessiveis (sem autenticacao)

Conclusao

Mensagens com midia tem taxas de engajamento significativamente maiores que mensagens de texto puro. Domine os diferentes tipos de midia e seus limites para criar campanhas mais visuais e impactantes no WhatsApp.