> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/en/topics/integrations/prospector.md).

# Prospector

The steps below are only for customers who do not have Consumption Mode active in their instances. Contact support to find out which group you fall into.

{% embed url="<https://youtu.be/blx90Q05RP4>" %}

***

1. Obtain the integration keys

The first step is to configure the external services for Prospector to work. Today, you need the Artificial Intelligence + Google Maps/Places + Serper + Search Companies services. The services are listed below:

* [OpenAI](https://platform.openai.com/settings/organization/api-keys)
* [Google Maps/Places](https://developers.google.com/maps/documentation/places/web-service/get-api-key?hl=pt-br)
* [Serper](https://serper.dev/dashboard)
* [CNPJá](https://cnpja.com/api)

2. Save in integrations

After obtaining the keys for each service, they must now be entered and configured within SprintHub. Go to System Settings > Integrations and then fill in the fields with the API keys and save.

<figure><img src="/files/d7fc60df7d9d1b6d427a0c082c5656beb5047b73" alt=""><figcaption></figcaption></figure>

***

### How to use

1. CRM

<figure><img src="/files/c67205d169d6730d41c60fbbed7ac474c78732e3" alt=""><figcaption></figcaption></figure>

To access Prospector, you must open the CRM module within SprintHub and then check whether the Funnel and Stages are already configured to start prospecting.

If the Funnel or the Stages have not been configured, follow the next steps, or see the specific documentation for each part.

2. Funnel

<figure><img src="/files/bca5a41f3cbde6928095506cf2b8957fa81966b7" alt=""><figcaption></figcaption></figure>

The Funnel is important so we can organize the opportunity flow. Basically, it is responsible for supporting the stages and the process chosen by the company.

Remember: the funnel is required to carry out prospecting, so create a new one or use one from your company.

3. Stages

The stages are established divisions for each funnel process. Therefore, it is important to have the stages well defined before moving on to the next step.

4. Prospector

<figure><img src="/files/4b631652ea8d79fa3a4e80e48819bd557ecf82c9" alt=""><figcaption></figcaption></figure>

Go to the Prospector option within the funnel, and you will then have access to the prospecting listing screen.

On this screen it is possible to filter prospecting already done by:

* Stage;
* Owner;
* Time interval;
* and Search;

More information is also shown in cards at the top, such as 'Total prospecting', 'Companies created', 'Contacts created' and 'Opportunities created'. This data sorts and shows the results obtained from the prospecting.

The table will show data such as Stage, name, description, businesses found, owner, created at, and the actions button. The button options are:

* Open on Map, option appears for all prospecting;
* Open result, option appears only for completed prospecting;
* View businesses, option appears for prospecting with businesses;
* Copy ID;
* Export Spreadsheet;
* Export PDF;
* Delete;

5. Prospecting

<figure><img src="/files/dbb74047a74e05d9677ac135140c8699f99ea426" alt=""><figcaption></figcaption></figure>

To be able to prospect, you need to fill in the name, state, and municipality. With these three fields filled in, you can already start:

When you click start, the businesses will be loaded and after a few minutes the map pins will appear so you can select, view data, and access advanced information about the companies found.

<figure><img src="/files/ba8de04dfe69d4aa78ce1802c0fb717b8d5372df" alt=""><figcaption></figcaption></figure>

To generate opportunities, you need to select which businesses will be used, as shown in the next step.

***

### Creating opportunities

<figure><img src="/files/acb1b89cc06d1da6db5719b6d5667dd7b39eea96" alt=""><figcaption></figcaption></figure>

To create opportunities, you must click the "Create Opportunities" button in the actions bar.

Note: the button will only be active if you select the businesses you want to turn into opportunities; this must be done manually by choosing one by one.

Then fill in the fields if you want to create contacts, companies, and opportunities.

After filling it in, just save and you will see the Prospector result.


---

# 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://docs.sprinthub.com/en/topics/integrations/prospector.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.