How Qualimero Uses Cookies and Browser Storage for Web Chat & WhatsApp
Qualimero uses a set of secure cookies and browser storage items to ensure that your website’s web chat widget and WhatsApp conversation features work smoothly. This article explains what each cookie does, what data it stores, and how it helps provide a better customer experience.
🔐 Security Standards for All Cookies
All Qualimero cookies follow strict security practices:
Secure: Enabled (cookies are sent only over HTTPS)
SameSite: None (allows cross-site communication for integrations)
Path: / (accessible across your entire domain)
Domain: Uses your website’s root domain
These settings allow the chat widget and WhatsApp integrations to work reliably while protecting user data.
🍪 Cookies Used by Qualimero
1. qualimero-user-jwt
Purpose: Stores the user’s session authentication token
Type: String (JWT)
2. qualimero-user-id
Purpose: A unique identifier for the user
Type: String
3. qualimero-hide-web-chat
Purpose: Remembers whether the user manually hid the chat widget
Type: Boolean (0 or 1)
4. qualimero-is-chat-visible
Purpose: Tracks whether the chat widget is currently open or closed
Type: Boolean
5. qualimero-chat-scroll-position
Purpose: Saves the user’s scroll position inside the chat
Why: Ensures seamless navigation when the user returns
Type: Number
6. qualimero-did-show-feedback
Purpose: Tracks whether the feedback request has already been shown
Type: Boolean
7. qualimero-did-auto-display-chat
Purpose: Prevents the chat from automatically popping up more than once
Type: Boolean
8. qualimero-hide-indicators
Purpose: Saves the user’s preference for hiding notification badges
Type: Boolean
9. qualimero-recommended-products
Purpose: Stores the list of product recommendations shown to the user
Type: JSON array
10. qualimero-viewed-product-messages
Purpose: Tracks which product messages the user has already seen
Type: JSON array
📦 Browser Storage (localStorage)
Qualimero also uses localStorage to improve performance and reduce server requests. None of the items below contain personal user data.
1. qualimero-web-config
Purpose: Caches the main web chat configuration
Contents:
Chatbot settings
Cache timestamp
Version tag
Expiry: Automatically refreshed every 24 hours
Personal Data: No
2. qualimero-agent-data
Purpose: Caches agent and bot metadata
Contents:
Agent configuration
Cache timestamp
Expiry: 24 hours
Personal Data: No
📘 Summary
Qualimero uses a combination of cookies and browser storage to:
Maintain a consistent chat experience
Personalize interactions (e.g., product recommendations)
Improve loading speed
Ensure authentication and session continuity
Prevent repeated prompts or auto-opens
All cookies are secure, and cached data is short-lived to ensure privacy and performance.
If you need help customizing cookie behavior or implementing this information into your Privacy Policy or GDPR documentation, feel free to ask!