Support in message webhook for notifications/receiving audio and image messages with “view-once” mode #1634
Description
We request that the Waha HTTP API message webhook include a return (or at least a notification) whenever an incoming message contains an audio or image marked as view-once. If it is not possible to deliver the file through the webhook, the webhook should at least indicate that a view-once media file was received (e.g., metadata and ID), so client systems can display the proper warning and handle privacy restrictions correctly.
Motivation / why this is important:
Platforms integrated with inbox/CRM systems must know when media arrives that can only be viewed once — this affects UI behavior, logging, auditing, and customer service workflows. Without this notification, the media may be lost or operators may assume there is no file attached.
Acceptance criteria:
- The webhook must include a view_once boolean field for media messages.
- Documentation must be updated with payload examples including view-once media.
- Integration tests must cover both receiving view-once media and receiving notifications when the file cannot be forwarded.
Suporte na webhook de mensagens para notificações/recebimento de áudios e imagens com “visualização única”
Solicitamos que a webhook de mensagens da Waha HTTP API inclua o retorno (ou pelo menos uma notificação) quando uma mensagem chegar contendo um áudio ou imagem marcada como visualização única (view-once). Caso não seja possível enviar o arquivo pela webhook, que ao menos seja indicado que um arquivo view-once foi recebido (ex.: metadados e ID), permitindo que clientes exibam avisos e tratem corretamente as restrições de privacidade.
Motivação / por que é importante:
Sistemas integrados como inbox/CRM precisam saber quando chegam mídias que só podem ser visualizadas uma vez — isso afeta a exibição, registro em logs, auditoria e fluxos de atendimento. Sem essa notificação, a mídia pode ser perdida ou o operador pode acreditar que não há nenhum arquivo anexado.
Critérios de aceite:
- A webhook deve incluir o campo view_once (boolean) nas mensagens de mídia.
- A documentação deve ser atualizada com exemplos de payload contendo mídias view-once.
- Testes de integração devem demonstrar tanto o recebimento de mídias view-once quanto a notificação caso o arquivo não possa ser enviado.