FAQ

Everything you need to know about Qhub

We collected the questions we hear most. Didn't find yours? Message us and we'll answer quickly.

Getting Started

Qhub brings your customer conversations from different messaging channels into one inbox, so your team and the Smart Assistant can reply and follow up from a single place.

How it works

  1. Connect your channels (WhatsApp, Messenger, Instagram, Telegram, Live Chat Widget) from Channels & connections.
  2. Customer messages arrive directly in the Inbox.
  3. The Smart Assistant replies automatically if enabled, and transfers the conversation to an employee when needed.
  4. The assigned employee replies, then closes the conversation when it is done; it can also be closed automatically based on the auto-close settings.
  5. The customer receives a rating link after the conversation is closed.
  6. Track performance from Overview and Reports.

Note: You can also send marketing campaigns by WhatsApp and email from Campaigns.

The company account is created once by the account owner, who then invites the rest of the team.

  1. Open the Qhub sign-up page.
  2. Enter the required details.
  3. Accept the terms and conditions, then click Create account.
  4. Complete the account verification step (OTP).
  5. To sign in later, enter your email and password.

Note: Employees do not sign up by themselves; they receive an email invitation from Team.

Follow this order to get your account ready for its first conversation.

  1. Complete your company details in Settings → Company.
  2. Connect your first channel from Channels & connections (mandatory for the system to work).
  3. Invite your employees from Team and set each employee's role and departments.
  4. Enable the Smart Assistant from AI settings.
  5. Add quick replies and tags from Settings.
  6. Send a test message to your channel and make sure it appears in the Inbox.

The interface has a sidebar for navigation and a top bar for quick tools.

Sidebar

  1. Main: Overview, Inbox, Contacts, Reports.
  2. Management: Channels & connections, Departments, Team, Campaigns, AI settings.
  3. System: Complaints & Suggestions, Plans & billing, Settings.

Top bar

  1. Search: search conversations, contacts and employees.
  2. Knowledge base: the help icon that opens the help articles.
  3. Notifications: alerts about plans, employees, complaints and channels.
  4. Profile: your account details and sign out.

Note: What you can access depends on the permissions of your role.

The basic setup is quick: create your account, link your first channel from Channels & connections, and messages start arriving in the Inbox. The time depends on the channel: Telegram and the Live Chat Widget connect right away, while WhatsApp may need Meta approval depending on the linking method. Follow the order in "First-time setup checklist".

Channels

A channel is the way your customers reach you. You can link more than one account per channel, depending on your plan.

Messaging channels

WhatsApp Business

Facebook Messenger

Instagram Direct

Telegram

Live Chat Widget (for your website)

TikTok

Email

  1. Gmail: used for campaigns and notifications.

Note: Each channel card shows how many accounts are available to you and how many are used.

Note: Click Manage on a channel card to open its page: About the Channel, Linked Accounts, How to Link.

Qhub offers three ways to link a WhatsApp number. Choose the one that suits you.

  1. Open Channels & connections, then click Manage on the WhatsApp Business card.
  2. Click Link New Account.
  3. Choose a linking method (see the methods below).
  4. Follow the instructions until the number appears under Linked Accounts.

Linking methods

  1. Quick link via Meta (recommended): sign in with Facebook, with no manual data entry. Requires permissions on the Facebook Business account.
  2. Meta Business Cloud API (recommended): the official connection using credentials and a webhook. Requires a Meta Business setup and more details.
  3. WhatsApp Business App (Coexistence): keep using the WhatsApp Business app on your phone while messages sync with Qhub. The app must stay connected, and Meta approval may be required.

Note: WhatsApp message fees are paid directly to Meta from your Meta account and are separate from your Qhub subscription.

Note: After linking, add the account to the right department from Departments.

Telegram is linked through a bot that you create inside Telegram itself.

  1. Open Telegram and search for BotFather.
  2. Create a new bot and follow BotFather's instructions.
  3. Copy the Bot Token that BotFather sends you.
  4. In Qhub, open Channels & connections and click Manage on the Telegram card.
  5. Click Link New Account and paste the token into the linking wizard.
  6. Complete the steps until the bot appears under Linked Accounts.

Note: Keep the Bot Token secret; anyone who has it can control the bot.

The linking steps are the same for every channel; only the requirements differ.

  1. Open Channels & connections.
  2. Click Manage on the channel card you want.
  3. Click Link New Account and follow the steps.
  4. Make sure the account appears under Linked Accounts.

Note: Gmail is linked with an App Password, not your normal email password.

Note: If you have reached the maximum number of accounts for a channel, you will need to upgrade your plan to add a new one.

Messaging channels: WhatsApp Business, Facebook Messenger, Instagram Direct, Telegram and the Live Chat Widget for your website. TikTok is coming soon. Email (Gmail) is used for campaigns and notifications.

Not necessarily. Qhub offers three ways to link a WhatsApp number: Quick link via Meta, Meta Business Cloud API, or Coexistence, where you keep using the WhatsApp Business app on your phone. See "Connect WhatsApp Business" for details.

Yes. You can link more than one account per channel, depending on your plan. All their conversations arrive in the Inbox, and you can filter by channel. Each channel card shows how many accounts are available to you and how many are used.

WhatsApp message fees are paid directly to Meta from your Meta account and are separate from your Qhub subscription. Marketing messages to customers outside the 24-hour window require a template approved by Meta and are subject to Meta fees.

Yes. Link the Live Chat Widget from Channels & connections so the chat window appears to your website visitors. Their messages arrive in the Inbox like any other channel.

Conversations

The Inbox page shows customer conversations from all channels in one list.

  1. Search: find a conversation from the search box above the list.
  2. Filter: show conversations by channel or department.
  3. Sort: change the order of the list.
  4. Status: show conversations by their status.
  5. New conversation: start a conversation with a customer.
  6. Click any conversation to open it, read the messages and reply.

Open the conversation from the list.

  1. Type your reply in the message box below the conversation.
  2. Add what you need: a quick reply, emoji, attachment or voice message.
  3. Click send.

Internal note

  1. Switch from Reply to Internal note to write a note that only your team can see; it is not sent to the customer.

Note: On WhatsApp you can reply with free-form messages within 24 hours of the customer's last message; after that you need an approved message template.

Note: You cannot reply to a closed conversation until it is reopened.

Statuses

  1. New: received and not yet being worked on.
  2. In progress: an employee is working on it.
  3. Closed: the conversation is finished.

Change the status

  1. Open the conversation.
  2. Choose the status from the menu above the conversation, or click Close.
  3. When it is closed, a rating link is sent to the customer.
  4. To work on a closed conversation again, click Reopen.

Sessions

  1. Each time a conversation is opened and then closed counts as one session (shown as Round in the conversation). A divider with the session number and date appears between sessions, so the customer's full history stays in one conversation.

Note: You can set conversations to close automatically after a number of hours from AI settings → Transfer & schedule.

Assignment defines who is responsible for following up on the conversation.

  1. Open the conversation, then open the Details panel.
  2. Choose the employee in the assigned employee field.
  3. Choose the right department in the department field.

Note: You can filter the inbox by department to follow each department's conversations.

Note: Each employee's performance appears in Reports under Employee performance.

The Details panel next to the conversation gathers everything related to it.

  1. Assigned employee and department: who is following the conversation.
  2. Tags: add a tag to label the topic of the conversation.
  3. Customer category: set the category of the contact.
  4. Conversation attributes: extra data about the conversation.
  5. Generate summary: an automatic AI summary of the conversation.
  6. Full screen: view the conversation in full screen.

In the Inbox, click New conversation.

  1. Choose the Sending channel (the account you will send from).
  2. Choose the Contact, or click New contact to add one.
  3. Choose the responsible Employee, and the Department if you want.
  4. Choose a template from your quick replies, or leave it without a template to write free text.
  5. Write the Message, then click Send.

Note: On WhatsApp, messaging a customer who has not messaged you in the last 24 hours requires a message template approved by Meta.

Quick replies are ready-made texts you insert while replying. Tags are labels used to classify conversations.

Quick replies

  1. Open Settings → Quick replies.
  2. Click Add reply and enter the reply name and text.
  3. Organise replies into groups from Manage categories.

Tags

  1. Open Settings → Tags.
  2. Click New tag and enter the tag name.

Note: You can also add a new tag directly from the conversation details panel.

Note: The breakdown of conversations by tag appears in Reports.

A conversation is assigned to an employee and a department from the Details panel, and the assignment can be changed at any time. Each department is linked to its channels from Departments. If the Smart Assistant is on, it transfers conversations to the employee you choose in Transfer & schedule.

The conversation stays New in the Inbox until an employee picks it up. If the Smart Assistant is on for that channel, it replies to the customer in the meantime.

Yes. A closed conversation stays saved and appears when you filter the list by Status or search for it. To work on it again, click Reopen.

Yes. Each time a conversation is opened and closed counts as a session, with a divider showing the session number and date, so the customer's full history stays in one conversation.

Yes. In the Details panel, change the assigned employee or department at any time. Messages and internal notes stay in the same conversation.

Contacts

The Contacts page is your customer list, with each customer's phone number or username, last interaction and number of conversations.

  1. Open Contacts and click New contact.
  2. Enter the full name.
  3. Choose the channel, then enter the phone number or username.
  4. Choose a contact classification and add notes (optional).
  5. Click Add.

Note: Click View next to any contact to open its details.

Manage categories: create and edit categories for your customers.

  1. Search: search by name or number.
  2. Filters: filter the list by channel, type or status.
  3. Import/Export: add contacts in bulk from a file, or export the list.

Note: The customer category also appears in the conversation details panel and can be changed from there.

Team & Roles

Open Team and click Invite employee.

  1. Enter the name and email (phone number is optional).
  2. Choose the Role.
  3. Choose the Departments the employee works in.
  4. Turn on Hide customer numbers if the employee should not see customer phone numbers.
  5. Click Send invitation.

Note: The employee receives an invitation link by email, opens it and sets their own password.

Note: From the team list you can edit an employee, disable their account or delete it.

A role is a set of permissions that defines what an employee can see and do in the system.

  1. Open Team, then Roles & Permissions.
  2. Click New role.
  3. Enter the role name and select its permissions.
  4. Save the role, then choose it when you invite or edit an employee.

Note: The Admin role is a built-in system role with all permissions and cannot be edited.

Note: Changing a role's permissions applies to every employee who has that role.

A department groups the employees responsible for one type of conversation, such as Sales or Support.

  1. Open Departments and click New department.
  2. Enter the department name and description.
  3. Choose the department color.
  4. Search for channels and add them to the department.
  5. Click Add.
  6. Link employees to the department from Team when inviting or editing them.

Note: You can edit or delete a department from the Departments page.

No. What an employee sees depends on their Role and the Departments they belong to. You can also turn on Hide customer numbers when inviting them, so they don't see customers' phone numbers.

Yes. Open Reports → Employee performance: conversations, average reply, resolution rate and rating. A summary also appears on Overview.

Smart Assistant (AI)

The Smart Assistant replies to your customers automatically, using an AI provider that you connect to your account.

  1. Open AI settings.
  2. Turn the assistant on using the main switch.
  3. In the Connection tab, choose the provider: OpenAI, Claude or Gemini.
  4. Enter the API key, then click Check connection.
  5. Choose the Model and the Max response length.
  6. Select the Enabled channels the assistant works on.
  7. Save your changes.

Note: You get the API key from your account with the provider, and usage is billed by the provider directly.

Open AI settings → Language & tone.

  1. Choose the reply languages: Arabic, English, or both.
  2. Choose the tone that fits your brand.
  3. Choose the Arabic dialect.
  4. Save your changes.

Available tones

  1. Short and direct: quick answers without extra details.
  2. Friendly and enthusiastic: kind, sometimes uses emojis.
  3. Formal and professional: serious, organised language.
  4. Luxurious and elegant: a style that suits luxury brands.

Available dialects

  1. Simplified Modern Standard Arabic, Khaleeji, Egyptian, Levantine.

In the Knowledge & limits tab you define what the assistant knows about your company and what it must not discuss. Settings are configured for each linked account separately.

  1. Open AI settings → Knowledge & limits.
  2. Choose the linked account you want to configure.
  3. Write the Company knowledge (Prompt): who you are, what you offer and how the assistant should reply (up to 4,000 characters).
  4. Select the Learning sources: documents, employee replies.
  5. Add Forbidden topics, one per line.
  6. Write the reply sent when a forbidden topic is raised.
  7. Save your changes.

Note: The clearer and more up to date your instructions and documents are, the more accurate the assistant's replies will be.

Open AI settings → Transfer & schedule.

  1. Turn on Transfer to a human agent and set its conditions.
  2. Add the Keywords that trigger transfer (for example: complaint, refund).
  3. Choose the employee the conversation is transferred to.
  4. Set the employees' working hours for each day, and the assistant works the rest of the time, or let it work around the clock.
  5. Write the message sent outside working hours.
  6. Turn on Auto-close conversations and set the number of hours (optional).
  7. Save your changes.

Note: After the transfer, the employee takes over replying to the conversation.

Yes. Choose the reply dialect in AI settings → Language & tone: Simplified Modern Standard Arabic, Khaleeji, Egyptian or Levantine.

It replies in Arabic, English or both, depending on what you choose in Language & tone.

In Knowledge & limits, choose the linked account and write the Company knowledge (Prompt): who you are, what you offer and how the assistant should reply, up to 4,000 characters. Then select the Learning sources: documents and employee replies. Settings are configured for each linked account separately.

You can set the reply language, the tone (short and direct, friendly and enthusiastic, formal and professional, luxurious and elegant), the dialect, the company knowledge, the forbidden topics and the reply to them, and the channels it works on.

Yes. Turn it off completely with the main switch in AI settings, or run it on specific channels only by selecting the Enabled channels.

The assistant follows what you set. If a customer raises one of your Forbidden topics, it sends the reply you wrote for them. If a message contains one of your transfer Keywords (for example: complaint, refund), the conversation is transferred to the chosen employee. Write clear instructions and add keywords for the cases you want an employee to handle.

Yes. Turn on Transfer to a human agent in Transfer & schedule, and set its conditions, keywords and the employee who receives the conversation. After the transfer, the employee takes over; the full conversation stays in front of them, and they can Generate summary from the Details panel.

Yes. Set the employees' working hours for each day in Transfer & schedule; the assistant replies the rest of the time, or you can let it work around the clock. You can also write a message that is sent outside working hours.

The assistant runs on an AI provider that you connect to your account (OpenAI, Claude or Gemini) with an API key from your account with that provider. Usage is billed by the provider directly.

Campaigns

A campaign is a bulk message sent to a group of your customers at once or at a scheduled time.

  1. Open Campaigns, go to the WhatsApp campaigns tab and click New campaign.
  2. Enter the Campaign Name and choose the Sending Number.
  3. Choose Custom message or Message templates.
  4. Write the Message Text (up to 1000 characters). You can use variables in the form {{var}}.
  5. Add an Attachment (optional).
  6. Select the Target Audience.
  7. Choose the Timing: Send Now or schedule a time.
  8. Choose the Sending speed: Slow, Normal or Fast.
  9. Check the Preview, then send the campaign.

Note: A WhatsApp account must be linked first so it appears under Sending Number.

Note: Slow speed is the safest and is recommended for large campaigns.

Note: On WhatsApp, marketing messages to customers outside the 24-hour window require a template approved by Meta and are subject to Meta fees.

Message templates

  1. Open Campaigns and click Manage templates.
  2. Create a new template or edit an existing one.
  3. Use the template when creating a campaign by choosing Message templates.

Email campaigns

  1. Link your email from Channels & connections (Gmail).
  2. Open Campaigns and go to the Email campaigns tab.
  3. Create the campaign and set the audience and timing.

The Campaigns page shows a summary of how your campaigns are performing.

  1. Cards: total campaigns, messages sent, average open rate, scheduled campaigns.
  2. Campaigns table: message, audience, sent count, open rate, date and status for each campaign.
  3. Period filter: show the campaigns of a specific period.
  4. CSV: export the campaigns list to a file.

Yes. When creating a campaign, schedule a time instead of choosing Send Now. Scheduled campaigns appear on the Campaigns page.

You select the Target Audience in its own step while creating the campaign, from the contacts in your account.

Yes. The Campaigns page shows total campaigns, messages sent, average open rate and scheduled campaigns, and for each campaign: audience, sent count, open rate, date and status. You can export the list as CSV.

Check the Preview before sending. For large campaigns, choose the Slow sending speed; it is the safest.

Reports

Overview is the home page and shows a quick summary of your account activity during the selected period.

  1. Cards: the key conversation numbers for the period.
  2. Smart Assistant: a summary of the assistant's performance.
  3. Conversations last 7 days: number of conversations day by day.
  4. Status distribution: the share of conversations in each status.
  5. Latest conversations and Employee performance.

Note: The percentage next to a number is the change compared with the previous period of the same length.

Note: Change the date range at the top of the page to update the numbers.

Open Reports.

  1. Choose the date range and the account from the filters at the top of the page.
  2. Review the report sections.
  3. Click PDF or Excel to export the report.

Report sections

  1. Smart Assistant performance, Smart Assistant vs employees, and reasons for transfer to a human employee.
  2. New conversations and first response time.
  3. Peak hours: the busiest times during the week.
  4. Conversations by tag.
  5. Employee performance: conversations, average reply, resolution rate and rating.

After a conversation is closed, the customer receives a link to rate the conversation and the employee.

  1. Open Reports and scroll to the Contact ratings section.
  2. Choose the date range.
  3. Review Satisfaction distribution and Quick summary.
  4. Search by name or comment, or filter by rating.
  5. Open the conversation related to any rating from the table.

Note: The ratings table shows the conversation rating, the agent rating and the comment written by the customer.

From the moment the account is activated; every conversation that enters the system counts in Overview and Reports.

Yes. On the Reports page, click PDF or Excel.

On Overview, the percentage next to each number shows the change compared with the previous period of the same length. Change the date range at the top of the page to update the numbers.

It depends on role permissions: what each employee can access is set by their role in Roles & Permissions.

Billing & Subscriptions

No. The AI assistant runs on your own API key from OpenAI, Claude or Gemini, and you pay the usage cost to the provider directly, based on how much you use it. Your Qhub subscription covers the assistant's features, not the provider's usage. Note: To get a key and connect it, see “Enable the Smart Assistant and connect a provider” in the AI section.

Open Plans & billing to see your current plan and Subscription details.

  1. On the trial plan, a bar at the top of the page shows the days remaining and a Choose a plan button.
  2. Subscribe before the trial ends to keep your conversations and settings without interruption.

Open Plans & billing and click Change plan.

  1. Choose the billing cycle: monthly or annual.
  2. Move the conversations slider to match your needs.
  3. Compare the plans and their features, then choose a plan.
  4. Complete the payment steps.

Note: For the Enterprise plan, click Contact us.

Note: Your plan change request appears in the Orders tab.

The Plans & billing page has two tabs for tracking your payments.

  1. Invoices: invoice number, description, date, amount and status.
  2. Orders: subscription and plan change requests, with the status of each.
  3. Status filter: All, Paid, Awaiting payment.
  4. Period filter: show the invoices of a specific period.

Open Plans & billing → Payment settings.

  1. Review your Saved payment methods.
  2. Set the default card, or remove a card you no longer need.
  3. Auto-renewal is always on and stops when the subscription is cancelled.

Note: Renewal happens automatically as long as the subscription is active.

Settings & Security

Profile

  1. Change your photo, display name and phone number.
  2. Changing your email requires a verification code.
  3. You can also delete your account permanently from here.

Company

  1. Logo, company name, industry, company size and country.

Note: After any change, click Save changes.

Note: Deleting the account is permanent and cannot be undone.

Note: Employees do not have permission to change the email address.

Notifications: choose what you are alerted about: new conversation, new message, campaigns, browser notifications and sound.

  1. Appearance: light or dark mode, font size and compact sidebar.
  2. Language & region: interface language, time zone and date format.

In Settings → Security you control how your account is protected.

  1. Change password: change it regularly and use a strong one.
  2. Two-factor authentication (2FA): an extra confirmation step when signing in.
  3. Auto logout: set the period of inactivity after which you are signed out.
  4. Active sessions: the devices you are signed in from. Click End session for any session you do not recognise.

Note: If you see a session you do not recognise, end it and change your password immediately.

Send a complaint or suggestion

  1. Open Complaints & Suggestions and click New ticket.
  2. Choose the type: Complaint or Suggestion.
  3. Choose the priority: High, Medium or Low.
  4. Write the subject and a detailed description.
  5. Click Send, then follow the ticket status and the reply to your complaint on the same page.

Other ways to get help

  1. Knowledge base: from the help icon in the top bar.
  2. Support chat: from the chat icon at the bottom of the page.

Note: High-priority tickets are handled within 24 hours.

Yes. You can delete your account permanently from Profile. Deletion is permanent and cannot be undone.

Yes. Reach us in Arabic by opening a ticket in Complaints & Suggestions, or through the support chat from the chat icon at the bottom of the page. Help articles are in the Knowledge base from the help icon.

High-priority tickets are handled within 24 hours. You choose the priority (High, Medium or Low) when opening the ticket, and follow its status and the reply on the same page.

Setup takes under 10 minutes

Start the free Qhub trial

Try Qhub free for 14 days and watch how much faster you reply — and how much happier your customers are.

  • No credit card
  • Cancel any time
  • AI assistant 24/7