Troubleshooting and FAQ
Quick fixes for the questions admins ask us most, how to send us diagnostics, and how to reach Gambit support.
Email isn't showing up in Jira
Work through these in order; most answers are in the first three.
- Is Gambit Mail Sync connected? Settings › Mail should show Mail Sync connected with a recent sync. If it asks you to pair again, open Mail Sync's admin page so it shows its Connect code, then press Connect in Settings › Mail, or press Use a pairing string instead.
- Is the mailbox connected? Open Jira settings › Apps › Gambit Mail Sync and check the mailbox is listed and active. If it shows "needs reconnect", reconnect it; this happens when a password changes or an admin withdraws consent.
- Is your site on a paid plan? Background capture needs a paid plan or a trial: Standard on a site of 11 or more users, or Advanced at any size once Advanced is available. On the free tier, capture doesn't run.
- Did your team write to them, or are they already in Gambit? Gambit captures a thread as soon as someone on your team starts it with, or replies to, a person outside your company. It also captures email where at least one person outside your company is a Contact or open Lead in Gambit, or writes from the web domain on one of your accounts. Addresses at gmail.com, outlook.com and other free mail services match only when they belong to a Contact or open Lead. Open Leads match by email only, never by company domain; their captured threads offer Open lead. The team member's own sent copy is what counts. A first email from someone new waits until someone on your team replies. When someone on the team replies, up to 6 earlier messages from the 30 days before come with it. To capture more:
- add the company's domain to its account, or add the person as a contact;
- or ask an admin to turn on Capture all external email in Settings › Mail › Capture rules (it is off unless an admin turns it on) to capture every external conversation. New threads with no known customer land in Inbox → Unlinked threads, where you can link them to a record. Choose Create account and contact, Create contact at <Account> when the domain's Account exists, or Open lead when the person is an open Lead.
- Was the email left out on purpose? Mail with more than 100 outside recipients is skipped unless a known party (a Contact, an Account's domain or an open Lead) is on the thread, or the thread is already being followed. Exactly 100 outside recipients is within the limit. Mailing-list headers still mark mail as bulk unless the sender is an exact Contact or open Lead. Gambit also skips internal-only mail, spam, trash and drafts, anyone on a never-log or blocked list, and threads labelled "Gambit/Don't log" in Gmail.
- Has it had time? Mail Sync checks a busy mailbox every 5 minutes and a quiet one every 15, so most email reaches Jira within about 10 minutes. Very large sites check less often; Mail Sync's admin page shows the current interval.
- Did a capture fail? Settings › Mail › Failed messages lists messages Mail Sync couldn't save in the last 30 days and why. Choose Try again in Mail Sync.
- Was it captured, but you can't see it? A new thread is private to its owner for a moment, then opens up to everyone who can see its account or deal, usually within two minutes and always within five. If it stays hidden, see the next question.
Someone can't see a deal or an email
Gambit shows each person what Jira lets them open. Check:
- Is the deal private? Its header reads "Private · N people". The deal's owner or a Gambit admin who can open it can choose Edit people to add someone.
- Is the thread kept private? A Private lozenge on the thread means only its owner and the people its Private security level allows see it: by default, the owner and members of rainbook-admins. The owner, or an admin who can open it, can switch the Private toggle off.
- Who sees customers on your site? If your site limits Gambit to a group and its access answer is Only CRM users, people outside that group can't open accounts, deals or email, though they still see customer names and revenue on their own work. Add them to the group, or switch to Everyone in Jira: in Jira settings › Apps › Gambit, choose Run setup again.
- Is the account limited to its account team? Add the person to the account's Account team field.
- Is the email linked to the right record? Email follows the record it's linked to. Use Change link on the thread to move it.
- Did you just change a setting? Gambit re-shares records straight away.
Totals stay honest when someone can't open every record: they show a note such as "Excludes 1 deal you can't open" rather than a smaller number with no explanation.
Someone reached their AI limit
Ask and the other AI a person starts count against that person's daily and monthly fair-use limits. When someone reaches one:
- For them: Gambit says which limit they reached and when it refills. Reports, search and everything else keep working. They can choose Build this report yourself to get the same chart from the report builder, Ask in Rovo where your site has Rovo, or Ask an admin for more.
- For you as an admin: you get an admin notification in the bell when someone reaches their monthly fair-use limit, so you can give them more. Settings › AI budget shows who is using the most, with Give more for each person.
- If the whole site uses its month's AI actions, Ask and drafts keep working, and Settings › AI budget shows the reset date. If summaries have paused, Gambit support can add AI actions for the month with a free top-up code: ask through support.
- "Gambit is still working on your last few requests. Try again in a minute." Someone sent many requests in a short time. Wait a minute and try again.
- "This thread has reached 20 follow-ups." Start a new question. Advanced allows 40.
- On the free tier, Ask for a report runs within a monthly AI allowance, then the report builder takes over until the next month.
Everyone on the site can see everything
That's how Jira Free works. On Jira Free, everyone on the site sees every record; private deals and private threads need Jira Standard or above. See Jira plan limit.
Jira Free also gives your site 2 GB of file storage, shared with everything else on the site. Settings › Privacy and data shows how much Gambit's files use and warns you at 80%. When you upgrade to Jira Standard, Gambit notices within a day, offers to add its security levels, and then gives every record the right level for you.
Change who uses Gambit
Open Settings › Access › Who uses Gambit and choose everyone in Jira or a group. The confirmation names who gains or loses access. On Jira Free, use Run setup again in Jira settings › Apps › Gambit.
The Gmail sidebar is coming soon
The Gmail sidebar is coming soon with Gambit Mail Sync. Until Google lists the add-on on Google Workspace Marketplace there is nothing to install or pair, so Settings › Inbox sidebars in Gambit lists no paired sidebar. Customer email doesn't wait for it: Gambit Mail Sync captures it onto the right account and deal on paid plans. See Sidebars and Mail Sync.
An import stopped or shows errors
- Not allowed to import? Imports run from Settings › Import, for members of rainbook-admins only. Being a Jira admin isn't enough: ask a member, or a Jira admin, to add you to the group in Jira's groups.
- A file is refused. Gambit checks size and format before reading anything, and the message names the limit. Save very large spreadsheets as CSV, which handles far bigger files than XLSX.
- You closed the tab. Reopen Settings › Import: the run resumes where it stopped, with no duplicates. If your browser's storage was cleared, select the same files again and Gambit checks they match.
- "Import running in another window." Another tab or admin holds the run. It frees up two minutes after that window closes.
- The import paused by itself. Jira asked Gambit to slow down. The run resumes on its own once Jira's limit resets.
- A required field blocks the import. The dry run lists fields your Jira setup requires that Gambit doesn't fill. Settings › Overview offers Repair under Configuration checks.
- Some rows failed. The validation report lists every skipped and failed row with the reason, and you can download it as CSV. Fix the source rows and import again: a second run updates the records it already created instead of duplicating them.
- Attachments switched off on Jira Free. When email attachments would take your site past Jira Free's 2 GB, Gambit switches them off and tells you how much space they need. Turn them back on, or skip older threads.
- Want to start over? Undo import is available for 14 days after a run finishes.
See Import for the full guide.
Copy diagnostics and share them with support
Settings › Overview has a Support section with Diagnostics for support. It gives us what we need to help you quickly, without anyone needing access to your site:
- Show diagnostics shows you the whole diagnostics bundle first: Gambit's version and build, your license, edition and packs, your settings, Gambit's queues and Jira usage this hour, the last configuration check, the last 50 items Gambit couldn't process, the last 50 job errors, and your Mail Sync connection.
- Tick Include the record I'm asking about and enter its work item key, the code Jira shows beside its title, to add that record's details and AI outputs, so we can see what Gambit holds for it. Gambit adds them only when you can open that record in Jira yourself.
- Copy diagnostics copies the bundle, ready to paste into your support request.
- Share diagnostics with Gambit support saves the bundle as a file and opens a new Get help request on our support portal in a new tab, ready for you to attach it.
The bundle leaves your site only through your browser, when you attach it to a request. Gambit itself sends it nowhere. Message bodies are left out unless you tick Include the record I'm asking about, and even then the bundle holds that record's details and AI outputs, not the emails themselves. Each copy and each share is recorded in activity history with your name and the time.
Give Gambit support hands-on access
Sometimes it's quicker for us to look at your setup with you. You can invite Gambit support as a Jira user for a set time:
- In Atlassian Administration, go to your users and choose Invite users.
- Invite support@gambit.humanr.ai and give it access to Jira only.
- If your site limits Gambit to a group, add it to that group. Add it to rainbook-admins only if we've asked to look at Gambit's admin pages.
- Tell us in your support request, and agree how long we need, for example until Friday.
- When we're done, remove the user, or remove its Jira access, in Atlassian Administration.
While the user has access, everything we do appears in Jira's history and Gambit's activity history under that name. Atlassian counts it as a Jira user while it has access, so if your site has exactly 10 users, adding it takes your site past the free tier's 10-user limit; ask us for a screen-share session instead.
Contact Gambit support
- Support portal: gambit.humanr.ai/support. Choose Get help, Report a bug, Request a feature, or Billing and licensing.
- Email: support@gambit.humanr.ai reaches the same team.
- Hours: Monday to Friday, 09:00 to 17:00 New York time. We reply within one business day, and within 2 hours, around the clock, for critical issues. See our service levels.
- Service status: gambit.humanr.ai/status.
- Security issues: report them through security or security@gambit.humanr.ai.