> For the complete documentation index, see [llms.txt](https://huntingalice.gitbook.io/about/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://huntingalice.gitbook.io/about/troubleshooting-guide.md).

# Troubleshooting guide

Encountering issues? Use this guide to diagnose and resolve common problems with your Hunter Agents.

## Agent Issues

<details>

<summary><strong>My agent found 0 leads.</strong></summary>

This usually happens for one of two reasons:

Too SpecificYour signal phrases are so complex that no one is searching for them exactly.Fix: Broaden your search terms.\
Example: Instead of "Need enterprise ERP for mid-sized tire manufacturer", try "Enterprise ERP recommendations".Too NewYou just deployed the agent.Fix: Allow up to 24 hours for the initial deep scan to complete.

</details>

<details>

<summary><strong>Refining: "Irrelevant Results"</strong></summary>

If your agent is bringing back results that don't match your Alice:

Check ContextIs the AI picking up sellers instead of buyers?Fix: Add terms like "hiring", "selling", "offering" to your expected exclusions (if available) or refine your signal to use phrases like "looking for" or "recommendation".Ambiguous KeywordsWords like "Pitch", "Deck", or "Scale" are used in many contexts.Fix: Pair them with industry terms (e.g., "Sales Deck", "Cloud Scale").

</details>

## Billing & Credits

<details>

<summary><strong>Why did my scan pause?</strong></summary>

Scans automatically pause when you run out of credits to prevent overage charges.

**Fix:** Check your **Billing** tab. You can purchase a Credit Pack to resume immediately or wait for your monthly reset.

</details>

<details>

<summary><strong>I was charged for a lead I don't like.</strong></summary>

We only charge credits for enriched leads that match your intent score threshold.

**Fix:** If a lead is completely off-target (e.g., a bot), flag it using the "Report Lead" button on the lead detail card. We review these flags to improve our scoring algorithm.

</details>

## Account Access

<details>

<summary><strong>I cannot log in.</strong></summary>

* **Google Auth:** Ensure you are using the same Google account you signed up with.
* **Org Access:** If you are part of a team, check with your administrator that your seat is still active.

</details>

<details>

<summary><strong>Data isn't syncing to CRM.</strong></summary>

* **Check Connection:** Go to **Settings > Integrations** and verify your CRM is "Connected".
* **Field Mapping:** Ensure your CRM has fields for "LinkedIn URL" and "Job Title", or the sync may fail due to validation errors.

</details>

## Still need help?

Contact our dedicated support team at `support@huntingalice.com`. We typically respond within 12 hours.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://huntingalice.gitbook.io/about/troubleshooting-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.