Connect the mailbox
Connect the firm's Gmail, Google Workspace or own-domain mailbox, what HodariQ reads and sends, and how to change or disconnect it.
HodariQ reads one mailbox per firm, usually the shared address the clients and contractors write to (info@ or qs@ your firm). A Senior QS / Manager connects it once in Settings › Inbox.
Gmail or Google Workspace
Google does not let other systems sign in with the usual password: they need an app password, a separate 16-letter password that works only for the mail.
- 1In the Google account of the mailbox, open Security and switch on 2-Step Verification if it is off.
- 2In the same page open App passwords, type a name such as HodariQ and press Create. Google shows 16 letters; copy them.
- 3In HodariQ open Settings, go to Inbox and press Connect mailbox.
- 4Choose Gmail or Google Workspace, type the Mailbox address and paste the app password in Password (the spaces do not matter).
- 5Press Connect and test. HodariQ signs in to read the mailbox, then to send from it. When both work it says Mailbox connected and the setting shows Connected: with the address.
A mailbox on your own domain
Most Tanzanian hosting (cPanel and similar) gives each mailbox an incoming server for IMAP and an outgoing server for SMTP, usually mail.yourfirm.co.tz. Ask your host for the two names and ports if they are not in your hosting panel.
- 1In Settings › Inbox press Connect mailbox and choose Another mail host.
- 2Type the Mailbox address and its usual Password.
- 3Type the Incoming server (IMAP) and its port (usually 993), the Outgoing server (SMTP), its port and the Encryption: 465 with SSL/TLS, or 587 with STARTTLS.
- 4Press Connect and test.
What HodariQ reads and sends
| What happens | |
|---|---|
| Reading | Every minute HodariQ reads the e-mails of the mailbox's inbox that are unread, brings each one in as a line of the Inbox with its attachments, and marks it read in the mailbox. E-mails already read before the mailbox was connected are not brought in: to bring some in, mark them unread in the mailbox. |
| Nothing deleted | HodariQ never deletes, moves or answers anything in the mailbox by itself. The mailbox stays the firm's own; people can keep using it as before. |
| Replies | A reply written in the Inbox is sent from the connected mailbox, under the name of the person who wrote it, as an answer in the same e-mail conversation. It also appears in the mailbox's sent items when the mail host keeps them. |
| HodariQ's own e-mails | The e-mail telling someone they were given work, and the morning e-mail, are sent from the same mailbox when it is connected. If one of them comes back into the mailbox it is put under Not work. |
Change or disconnect
- Change opens the same window: type the new address or password and press Connect and test. If the test fails, the old settings stay as they were.
- Disconnect stops reading and sending. The lines already in the Inbox stay, with their conversations; replies can no longer be sent until a mailbox is connected again.
- A changed password in Google or at the host stops the reading: connect again with the new app password.
Good to know
Mailboxes that only allow Microsoft sign-in (many Microsoft 365 accounts) cannot be connected with a password. The password is kept in the server settings of your HodariQ database and is never shown again in the Inbox settings. Only a Senior QS / Manager can connect, change or disconnect the mailbox.
Tip
After connecting, press Read the mailbox now in Settings › Inbox to bring the unread e-mails in at once instead of waiting up to a minute. HodariQ says how many came in and opens the Inbox on To check.
Something unclear? Ask us on WhatsApp: we answer the same day.