Review messages
The Messages page is where you view and filter all content captured by the WappSense WhatsApp bot for a specific
project. This includes text messages and, depending on your enabled services, can also include images, audio (with
transcription), videos, and documents.
Important: The Messages page only shows messages that were captured by the bot after a project was linked to a WhatsApp
group. If the bot is not linked (or the code was not detected), you will see “No messages found.”
6.1 What you can do in Messages
From this screen you can:
- Select a Project and view only its captured messages
- Filter messages by a Date Range
- Search by tags and text (e.g., #front, #issue, #progress)
- Filter by Message Type: All, Text, Image, Audio, Video, Document
- Quickly confirm whether the bot is capturing content correctly before generating reports
6.2 Select Project
Use the Project dropdown to choose which project’s messages you want to view.
- If you do not select a project, results may stay empty (depending on system configuration).
- If a project is selected but the bot is not linked, or there are no captured messages yet, you will see No messages
found.
Best practice: Always pick the project first, then set the date range and search filters.
6.3 Date Range filter
The Date Range selector allows you to limit results to messages received within a specific time window.
- Click the calendar icon and choose the start and end dates.
- Date ranges are particularly important when preparing reports (daily/weekly summaries, worklogs, incident tracking,
etc.).
Note: The meaning of “today” and the grouping of messages across days depends on the Project Timezone configured in the
project settings.
6.4 Search (tags and text)
The Search (tags and text) field lets you search through captured messages using:
- Free text, e.g. leak, invoice, delivery, repaired
- Hashtags, e.g. #front, #roof, #issue, #before, #after
- A combination of both, depending on your team’s tagging habits
This is especially useful when your WhatsApp group contains lots of updates and you need to isolate a specific topic or
area.
Recommended usage
- Use tags to categorize work updates consistently (examples: #progress, #blocked, #materials, #safety).
- Use location/area tags for photos and inspections (examples: #front, #backyard, #kitchen, #panelA).
6.5 Message Type filters
Under Message Type, you can filter the results by content type:
- ALL: Shows all captured messages for the selected project and filters.
- TEXT: Only plain text messages (including translated text if Translation is enabled).
- IMAGE: Photos/images sent to the WhatsApp group (often tagged with hashtags for reporting).
- AUDIO: Voice notes. If Voice Transcription is enabled, the system can display or store the transcription as text for
searching/reporting.
- VIDEO: Video files sent to the group.
- DOCUMENT: Files such as PDFs or other shared documents (if supported by your integration and plan).
Tip: When preparing a report that focuses on visuals, filter by IMAGE and use tags (e.g., #front) to quickly locate the
exact photos you want.
6.6 Why you might see “No messages found”
Common reasons include:
- The project has not been linked to a WhatsApp group yet.
- The bot was added to the group, but the linking code was not sent or not detected.
- The selected date range does not include any captured messages.
- The selected Message Type filter is too restrictive (e.g., AUDIO only, but no audios were sent).
- The group is active, but no messages have been captured since linking (e.g., the bot was added recently).
Quick troubleshooting checklist
1. Confirm the correct Project is selected.
2. Expand the Date Range (try a larger window).
3. Switch Message Type to ALL.
4. Confirm the WhatsApp group is linked (project status shows connected) and the bot is still in the group.