Most problems are caused by the mailbox connection, the cron job or the mail settings. Check the cron log system/storage/logs/ka_messages.cron.log and the OpenCart error log (System > Maintenance > Error Logs) first. See also How to see extended error information.
Emails do not become tickets
- Cron does not run. The cron log has no new STARTED lines. Check the cron job (see Connecting the Mailbox and Setting Up Cron) and open the cron URL in the browser once: a blank page is correct, "secret_key is not valid" means a wrong key in the URL.
- The mailbox cannot be opened. The error log has "MailManager cannot connect to the server" with the reason. Check the IMAP hostname, port, SSL/TLS, username and password. For Gmail use an app password. Outlook.com and Microsoft 365 mailboxes cannot be used (they require OAuth2).
- The PHP imap extension is missing. The error log has "Call to undefined function imap_open()". Ask your hosting to enable the extension. PHP 8.4 does not include it.
- The email was skipped. Look for its line in the cron log and in the SKIPPED or BANNED folder of the mailbox (see How Emails Become Tickets).
Emails are not sent
- Check the OpenCart mail settings on the Mail tab of System > Settings and send a test, for example with Forgotten Password. See How to configure emails in Opencart.
- A customer gets the emails in English, not in his language. There are no email templates for his storefront language; add them (see Email Notifications).
- Alerts about new orders or reviews come to the support mailbox. Admin E-Mail in System > Settings is empty; fill it in.
- An administrator gets nothing. Check that he is the assigned administrator of the ticket and that his user email is not the same as System E-Mail.
- Failed emails are retried by cron automatically; use Resend on the ticket page after fixing the cause.
Nobody is notified about new tickets
Default Assigned User is empty in the module settings. New tickets then stay without an administrator, and no administrator gets emails about them. Choose a user in the settings and assign the existing tickets on their pages: the assigned administrator gets an email about each of them.
A reassigned administrator did not get an email
The email "Ticket #N Was Assigned to You" goes to the user email of the new administrator (System > Users > Users). It is not sent when an administrator assigns a ticket to himself, and it is not sent to an address equal to System E-Mail. Check the delivery as for other emails above.
Replies create new tickets
- The customer wrote a new email instead of replying, or his mail client removed the reply headers. Move the message to the right ticket (see Editing, Moving, Splitting and Deleting Messages).
- The file
system/config/ka_messages.phpwas lost or replaced, for example after moving the store to another server. Replies to emails sent before cannot be linked. Restore the file from a backup. - An administrator replied from an address that is not his admin user email: such replies are skipped, see the cron log.
Quoted text stays in the messages
Text above the line ----- REPLY ABOVE THIS LINE ----- is kept, so the line "On ..., Tech Corner wrote:" that mail clients add above the quote remains. If a whole quote stays, the mail client has removed the marker line; edit the message if needed.
A customer does not see his tickets
- His email is not confirmed: he sees "Please verify your email address..." and should click Verify Email on the account edit page, or use Forgotten Password.
- The ticket is not verified (from the contact form): click Verified on the ticket page, or wait for the customer to reply by email.
- He is not a customer of the ticket: add him in the ticket properties.
FAQ
Why are customer accounts created for people who write to us? Every message belongs to a customer, so an account is created for every new sender and every new address in To and CC. These accounts get the standard welcome email of OpenCart. Ban spam senders to stop it.
Can customers write without an account? Yes: by email or through the contact form. The account is created automatically, and the customer can use it later.
Can we use several support mailboxes? No, one mailbox per store installation.
Why is a ticket closed by the customer shown as not answered? Closing in the account adds the message "The ticket was closed by the customer." and this message clears the Answered flag. Click Mark Answered if you filter by this flag.
Do administrators' replies sent by email mark the ticket answered? Yes, like replies in the admin panel.
Is the module free? Yes. Customer Messages, Customer Email Verification and Messages For Multivendor are free and need no license key.