Fazer upload de mídia do WhatsApp

​

O que é

​

Antes de começar

• Conecte e registre o número de telefone remetente do WhatsApp.
• Armazene sua chave de API da YCloud com segurança.
• Prepare um arquivo que atenda aos limites de tamanho e tipos de mídia suportados pela Meta.
• Verifique se o tipo de mensagem de destino suporta um ID de mídia ou requer uma URL.

​

Como funciona

1. Faça o upload do arquivo para o número de telefone remetente.
2. Armazene o ID de mídia retornado.
3. Insira o ID de mídia no objeto de conteúdo correspondente da mensagem do WhatsApp.
4. Envie a mensagem antes que a mídia enviada expire.

​

Solicitação

curl --request POST \
  https://api.ycloud.com/v2/whatsapp/media/+16315551111/upload \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --form "file=@./invoice.pdf;type=application/pdf"

​

Resposta

{
  "id": "MEDIA_ID"
}

{
  "type": "document",
  "document": {
    "id": "MEDIA_ID",
    "filename": "invoice.pdf"
  }
}

​

Uso de mídia

​

Limites e solução de problemas

• Envie o tipo MIME correto com o arquivo enviado.
• Verifique os tipos de mídia e limites de tamanho suportados pela Meta antes de fazer o upload.
• Não reutilize um ID de mídia expirado.
• Mantenha o mesmo número de telefone remetente no upload e na mensagem.
• Para recursos públicos reutilizáveis, um link pode ser mais simples do que uploads repetidos quando o esquema da mensagem for compatível.