Messages, attachments, read acknowledgements and delivery evidence

Configure the maximum attachment size

Follow this guide to set a limit from 1 to 32 MB in Settings and verify larger uploads are rejected. The guide then takes you through the correct route, the checks to complete before making changes, the workflow in order, and the evidence to review afterwards.

Audience: Authorised inbox staffPermission: AdministratorModule v1.0.0 · 2026.07.30-r20.5
Jump to steps
Where to goAdmin Area → WhatsApp → Settings
Before you start
  • Verify the module is active and select the intended WhatsApp account before changing any operational record.
  • Use an account with the stated native CRM capability and per-account access.
  • Test with controlled customer/contact data before relying on live verification, email or CRM automation.

What you’ll accomplish

Set a limit from 1 to 32 MB in Settings and verify larger uploads are rejected. These instructions follow the supplied r20.5 controller, model, view, installer, connector and automation flow.

Follow these steps

  1. Go to Admin Area → WhatsApp → Settings.
  2. Find the control used to configure the maximum attachment size.
  3. Select or enter only the supported value described below.
  4. Select the page’s Save, Save settings, Save access control or Save controls action.
  5. Reload or open the affected Inbox/account and verify the new behaviour.

Fields and options to review

Reply textmaximum 10,000 characters
Attachmentoptional when text is present
Maximum attachment sizeadministrator setting, 1–32 MB
Message direction and WhatsApp message IDMessage direction and WhatsApp message ID

Rules the system enforces

  • A send request requires reply permission and either non-empty text or one accepted attachment.
  • The server validates MIME type using file content and stores a randomised filename in the protected upload area.
  • Opening an unread conversation asks the linked device to send a real read acknowledgement before clearing CRM unread state.
  • Set a limit from 1 to 32 MB in Settings and verify larger uploads are rejected.

How to confirm it worked

  • The requested action completes without a permission, validation, connector or native CRM error.
  • The selected account or conversation shows the expected state without changing another account’s data.
  • Where the action creates evidence, confirm the message, native record, verification event, portal history or audit entry is present.

Security, privacy and troubleshooting checks

  • Never expose connector tokens, loopback ports, authentication directories or raw customer verification replies.
  • Use the supported Connections, Access Control, Settings and Audit Trail pages rather than editing runtime or database records directly.
  • If the expected control is missing, verify both native capability and per-account permission before treating it as an installation fault.