> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morada.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar o Capys

> O que o Morada OS consulta no funil de vendas do Capys, onde encontrar o ID da organização, como conectar e os cuidados de uso.

O Capys é o CRM onde muitas incorporadoras acompanham os leads e o funil de vendas. Ao conectar o Capys, você pergunta em linguagem natural ("quantos leads estão na etapa Visita?") e o Morada OS consulta o Capys com o **seu** login e responde no chat.

O Morada OS **só lê** o Capys. Nenhuma consulta altera nada no sistema.

***

## O que dá para perguntar

<CardGroup cols={3}>
  <Card title="Quantos e quais" icon="filter">
    Quantos leads estão numa etapa, quais são os seus leads, quantos entraram num período. Filtre por etapa, corretor, equipe, origem, situação ou vencimento. O total vem primeiro.
  </Card>

  <Card title="Um lead específico" icon="user">
    Encontre pelo número do lead, e-mail, CPF ou telefone e abra o cadastro ou o histórico de interações, da mais recente para a mais antiga.
  </Card>

  <Card title="Os nomes do seu Capys" icon="list">
    As etapas do funil, os corretores, as equipes, as origens de lead e os empreendimentos.
  </Card>
</CardGroup>

Exemplos para começar:

```text wrap theme={null}
Quantos leads estão na etapa Visita agora?
```

```text wrap theme={null}
Quais são os meus leads em Atendimento? Traga o nome e a última interação de cada um.
```

```text wrap theme={null}
Quantos leads entraram entre 1 e 20 de setembro? Separe por origem.
```

```text wrap theme={null}
Abra o histórico do lead de e-mail [e-mail do lead].
```

<Tip>
  Quer resultados melhores? Leia [Como pedir bem](/morada-os/casos-de-uso/como-pedir-bem): três minutos de leitura que melhoram todos os seus pedidos.
</Tip>

***

## Antes de conectar

Cada pessoa conecta com o **próprio login do Capys**. A conexão pede três dados:

* **E-mail** e **Senha**: os mesmos com que você entra no Capys.
* **ID da organização**: o identificador da sua empresa no Capys. O login não funciona sem ele.

<Note>
  O login certo é o do **Capys CRMV2**, o que entra com e-mail em `crmv2.capys.com.br`. O login do **CRM Vendas** antigo (usuário sem e-mail) não serve para conectar.
</Note>

### Onde encontrar o ID da organização

<Steps>
  <Step title="Abrir a lista de organizações">
    Abra a [lista de organizações do Capys](https://crmvendas.capys.com.br/ListadeOrganizacoes.html) e escolha a sua empresa.
  </Step>

  <Step title="Copiar o código do endereço">
    Na página que abrir, copie o código que vem depois de `id=` no endereço. São 36 caracteres, no formato `3f2504e0-4f89-41d3-9a0c-0305e82c3301`.
  </Step>
</Steps>

Se não encontrar, peça o ID ao administrador do Capys da sua empresa.

### O módulo de Vendas

As consultas de leads e do funil dependem do módulo de **Vendas** do Capys. Se a sua conta não tem acesso a ele, o Morada OS avisa e diz a quem pedir. Para conferir, pergunte "quais módulos do Capys eu tenho?".

***

## Como conectar

<Steps>
  <Step title="Abrir o Capys em Conectores">
    No menu lateral do Morada OS, clique em **Conectores**, procure **Capys** e clique em **Conectar**.
  </Step>

  <Step title="Preencher os três campos">
    Preencha **E-mail**, **Senha** e **ID da organização** e clique em **Conectar**. O Morada OS confere os dados com o Capys na hora.
  </Step>

  <Step title="Pronto para perguntar">
    O Capys passa para **Conectados por você**. Abra um chat e pergunte.
  </Step>
</Steps>

***

## Cuidados de uso

<AccordionGroup>
  <Accordion title="Toda lista precisa de um recorte">
    O Capys não responde a uma consulta sobre a base inteira. Antes de buscar, o Morada OS pede uma etapa, um corretor, um período de cadastro ou um lead. A data da última interação e o nome do lead só servem para refinar uma busca que já tem um desses recortes.
  </Accordion>

  <Accordion title="Uma etapa por vez">
    Uma consulta muito larga pode demorar demais, e o Capys a cancela. Nesse caso, peça uma etapa por vez ou estreite por corretor.
  </Accordion>

  <Accordion title="Telefone, e-mail e CPF são dados pessoais">
    Use os dados dos seus leads no chat só para localizar o registro no Capys. O CPF serve para encontrar o lead e não volta na resposta. Não copie telefone e e-mail para fora do Morada OS nem para conversas com quem não precisa deles.
  </Accordion>
</AccordionGroup>

***

## Limitações

* **Sem link para o Capys.** O Capys não oferece link para abrir um registro, então o Morada OS informa o número do lead para você procurar no Capys.
* **Empreendimento e dias sem interação** aparecem nos resultados, mas ainda não servem de filtro.
* **Listas em páginas.** O Morada OS traz 30 leads por vez e até 50 interações do histórico de um lead.
* **Só leitura.** O Morada OS não cria leads, não move etapas e não registra interações no Capys.

***

## Problemas comuns

<AccordionGroup>
  <Accordion title="&#x22;O Capys recusou o acesso&#x22;">
    O Capys dá a mesma resposta para um e-mail, uma senha ou um ID da organização errados.

    1. Confira o e-mail e a senha entrando no Capys pela tela de login.
    2. Confira o ID da organização, como mostra [Onde encontrar o ID da organização](#onde-encontrar-o-id-da-organizacao).

    Depois, em **Conectores → Capys**, conecte de novo.
  </Accordion>

  <Accordion title="&#x22;O Capys negou permissão para esta consulta&#x22;">
    A sua conta do Capys não tem acesso àquele módulo, em geral o de **Vendas**. Peça ao administrador do Capys para liberar o módulo na sua conta.
  </Accordion>

  <Accordion title="&#x22;O Capys cancelou esta consulta por tempo&#x22;">
    O recorte ficou largo demais. Peça uma etapa por vez, ou estreite por corretor ou por um lead.
  </Accordion>

  <Accordion title="&#x22;O Capys limitou as consultas&#x22;">
    O Capys aceita um número limitado de consultas por vez. Espere um minuto e pergunte de novo.
  </Accordion>

  <Accordion title="Canais de suporte">
    * **Central de atendimento**: [support.morada.ai](https://support.morada.ai)
    * **E-mail**: `suporte@morada.ai`
    * **Status da plataforma**: [status.morada.ai](https://status.morada.ai)
  </Accordion>
</AccordionGroup>

***

## Como desconectar

Em **Conectores**, abra o **Capys** e clique em **Desvincular**. O Morada OS apaga o e-mail, a senha e o ID guardados e deixa de consultar o Capys na hora.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.