Skip to main content

​
Enviando

O campo de mídia (image, audio, video, ptv, gif, document, sticker) aceita três formas:
O engine baixa a URL na hora do envio. Ela precisa ser acessível da internet, sem autenticação, e responder em poucos segundos. URLs assinadas funcionam se ainda forem válidas quando a mensagem sair da fila.
O Wabox não armazena a mídia enviada: ela passa pelo payload, é cifrada e sobe para os servidores do WhatsApp, e o corpo é descartado.

​
Limites

Se a mídia passar do limite, o delivery vem com error_code: media_invalid. Se a URL estiver inacessível, vem media_download_failed.

​
Formatos e conversões

Os servidores do Wabox têm ffmpeg, então a maioria das conversões é automática.
Se um servidor específico estiver sem ffmpeg, o envio ainda funciona: áudio vai como está (pode não tocar no iOS se não for Opus), sticker exige WebP e GIF exige mp4.

​
Recebendo

Mídias recebidas chegam no webhook received já decifradas, como URL assinada:
  • A URL expira em 24 horas. Baixe o arquivo e guarde no seu storage se precisar dele depois; o Wabox não é um repositório.
  • Se a decifração ou o download falhar, url vem ausente e download_error diz o motivo. Peça para o contato reenviar.
  • view_once: true indica mídia de visualização única. O WhatsApp espera que ela não seja reencaminhada, então trate-a como sensível.
  • Use sha256 para deduplicar arquivos que chegam mais de uma vez.

​
Privacidade

O Wabox não guarda em repouso o conteúdo das mensagens em trânsito. A mídia recebida só existe no storage temporário das URLs assinadas, com expiração. O texto das mensagens só fica na fila de saída, até o envio. A exceção é o histórico recente que o celular envia ao parear: até 50 mensagens por conversa, só metadados de mídia (nunca os bytes), apagado ao desligar history_enabled, deslogar ou excluir a instância.