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 temporárias (assinadas) funcionam desde que ainda estejam 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

Estourar o limite resulta em delivery com error_code: media_invalid. URL inacessível resulta em 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 e guarde no seu storage se precisar 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: mídia de visualização única. O WhatsApp espera que ela não seja reencaminhada; trate como sensível.
  • sha256 permite deduplicar arquivos que chegam mais de uma vez.

​
Privacidade

Conteúdo de mensagens não fica em repouso no Wabox: o único lugar onde mídia recebida existe é o storage temporário das URLs assinadas, com expiração. Mensagens de texto não são armazenadas em lugar nenhum além da fila de saída (até serem enviadas).