waha icon indicating copy to clipboard operation
waha copied to clipboard

Support in message webhook for notifications/receiving audio and image messages with “view-once” mode

Open oasilap opened this issue 1 month ago • 3 comments

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.

oasilap avatar Nov 15 '25 02:11 oasilap