> 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/topicos/integracoes/prospector.md).

# Prospector

Os passos abaixo será apenas para clientes que não possuem o modo consumo ativo em suas instâncias. Consulte o suporte para saber qual quadro você se encaixa.

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

***

1. Obter as chaves das integrações

O primeiro passo é configurar os serviços externos para o funcionamento do Prospector. Hoje é preciso ter os serviços de Inteligência Artificial + Google Maps/Places + Serper + Procurar Empresas. Os serviços são o anotado abaixo:

* [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. Salvar em integrações

Ao obter as chaves de cada serviço, agora deve ser colocado e configurado dentro do SprintHub. Vá em Configurações do Sistema > Integrações e em seguida preencha os campos com a API Keys e salve.

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

***

### Como usar

1. CRM

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

Para chegar no Prospector você deve abrir o módulo de CRM dentro do SprintHub e em seguida conferir se existe o Funil e Etapas já configuradas para dar inicio a prospecção.

Caso não tenha configurado o Funil ou as Etapas, siga os próximos passos, ou veja as documentação especifica de cada parte.

2. Funil

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

O Funil é importante para conseguimos organizar o fluxo de oportunidades. Basicamente, o responsável por sustentar as etapas e os processo escolhido pela empresa.

Lembrando: O funil é necessário para realizar a prospecção, portanto crie um novo ou utilize algum da sua empresa.

3. Etapas

As etapas são divisões estabelecidas para cada processo do funil. Portanto, é importante ter bem estabelecido as etapas antes de passar para o próximo passo.

4. Prospector

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

Vá até a opção de Prospector dentro do funil, assim terá acesso a tela de listagem de prospecções.

Nessa tela é possivel filtrar as prospecções já feitas em:

* Estágio;
* Responsável;
* Intervalo de tempo;
* e, Pesquisa;

Também é mostrado mais informações em cards no topo como o 'Total de prospecções', 'Empresas criadas', 'Contatos criados' e 'Oportunidades criadas'. Esses dados ordenam e mostram os resultados tido a partir das prospecções.

Na tabela será mostrado os dados como Estágio, nome, descrição, estabelecimentos encontrados, responsável, criado em e o botão de ações. Sendo as opções do botão:

* Abrir no Mapa, opção aparece para todas prospecções;
* Abrir resultado, opção aparece apenas prospecções completada;
* Ver estabeleimentos, opção aparece para prospecções com estabelecimentos;
* Copiar ID;
* Exportar Planilha;
* Exportar PDF;
* Deletar;

5. Prospectando

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

Para poder prospectar é preciso preencher o nome, estado e municipio. Com esses tres campos preenchido você ja pode iniciar:

Ao clicar em iniciar será carregado os estabelecimentos e apos alguns minutos aparecera em um mapa os pin para selecionar, visualizar dados e informações avançada das empresas encontradas.

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

Para gerar oportunidade é preciso selecionar quais estabelecimentos serão usados, como mostrar o proximo passo.

***

### Criando oportunidades

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

Para criar oportunidade você deve clicar no botão "Criar Oportunidades" barra de ações.

Observação: o botão só ficará ativo se selecionas os estebelecimentos que deseja tornar oportunidade, isso deve ser feito manualmente escolhendo um por um.

Em seguida preencher os campos caso queira criar contatos, empresas e criar oportunidades.

depois de preenchido só salvar e verá o resultado do prospector.


---

# 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/topicos/integracoes/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.