> ## 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 Facilita CRM > Como a sua empresa guarda a chave do Facilita e libera as pessoas uma a uma no Morada OS, o que cada pessoa liberada consegue perguntar e como o acesso é retirado. O Facilita é o CRM onde a equipe comercial da incorporadora acompanha negócios, clientes, empreendimentos, unidades e tarefas. Ao conectar o Facilita ao Morada OS, você passa a perguntar sobre isso em linguagem natural ("quantos negócios estão em Proposta?") e recebe a resposta com o link para abrir cada registro direto no Facilita. *** ## Antes de começar Uma conta ativa em [os.morada.ai](https://os.morada.ai), com o login corporativo da sua empresa. O Facilita vende uma chave por empresa, com ativação e mensalidade. Ela não fica numa tela do Facilita e ninguém da equipe tem a sua própria: quem administra a conta da empresa recebe a chave do próprio Facilita. Ela é guardada **uma vez só**, pela sua empresa. Quem usa o conector, porém, é decidido pessoa a pessoa. **Se a Morada já integra o seu Facilita**, a chave foi pedida ao Facilita em nome da sua empresa e a Morada configura tudo para você. A chave já está guardada. **Se a sua empresa comprou a chave direto do Facilita**, quem administra o Morada OS a guarda uma vez, no passo abaixo. Nos dois casos, quem administra ainda precisa **liberar** cada pessoa que vai usar o Facilita. *** ## Para o administrador: guardar a chave e liberar as pessoas São dois passos, e o segundo é o que dá acesso. Guardar a chave **não libera ninguém**, nem você. No menu lateral, clique em **Conectores**, abra o cartão do **Facilita** e vá na aba **Administração**. Preencha: * **Instância**: só o nome da conta da sua empresa, sem o resto do endereço. Se vocês entram em `suaincorporadora.facilitavendas.com`, digite `suaincorporadora`. * **API Key**: a chave que a sua empresa recebeu do Facilita. * **Token do usuário**: o token que veio junto com ela. Ao salvar, o Morada OS confere os três dados com o Facilita na hora. Quando a chave é recusada, a tela diz isso e pede para você conferir a instância, a API Key e o token do usuário: a recusa vem de um jeito só, então não dá para dizer qual dos três está errado. Comece pela instância, que é onde mais se erra: só o nome da conta, sem `.facilitavendas.com` e sem `https://`. Você corrige sem digitar tudo de novo. **Trocar ou remover a chave não mexe em quem você liberou.** Com a chave fora, ninguém usa o Facilita; quando você guardar uma chave de novo, as mesmas pessoas voltam, com os mesmos vínculos e as mesmas ferramentas, sem você precisar liberar tudo outra vez. Para tirar o acesso de alguém de verdade, use **Remover acesso** na linha da pessoa: só isso tira. Com a chave guardada, aparece a lista **Quem pode usar o Facilita**, com as pessoas da sua empresa no Morada OS. Ninguém entra sozinho nessa lista, **nem você**: clique em **Liberar** na linha de cada pessoa que deve ter acesso. A pessoa liberada passa a ver o Facilita no chat na hora, sem preencher nada. Quem não foi liberado não vê o conector. Para tirar o acesso depois, use **Remover acesso** na linha da pessoa. Você pode liberar qualquer pessoa da empresa, **tenha ela conta no Facilita ou não**. A chave é da empresa, então as consultas funcionam para todo mundo que você liberar. O vínculo só é necessário para o que depende de *quem a pessoa é* no Facilita. Hoje isso é uma coisa só: a pergunta "quem sou eu no Facilita". Amanhã serão as ações que registram algo em nome dela. Quando o e-mail de login da pessoa também existe no Facilita, o Morada OS sugere o vínculo e ele é feito sozinho ao liberar. Quando não existe, a linha mostra **Sem vínculo no Facilita: consultas funcionam, ações em nome dela não**, e você pode usar **Vincular** para escolher o usuário do Facilita correspondente. **Desvincular** desfaz o vínculo sem tirar o acesso. Cada linha liberada mostra **Ferramentas · todas**. Abra e desligue o que aquela pessoa não deve usar; a mudança vale só para ela. Uma diferença que vale saber: quem está com **todas** ganha automaticamente as ferramentas novas que o Facilita receber no Morada OS. Quem está com uma lista escolhida por você continua só com o que você marcou, mesmo depois de uma novidade. A chave fica guardada de forma criptografada e o Morada OS nunca a mostra de volta, nem para quem a guardou. A tela mostra apenas que existe uma chave, quem a guardou e quando. Ninguém da equipe digita chave nenhuma. *** ## Como fica para cada pessoa da equipe Não há nada a preencher e não existe botão **Conectar** para o Facilita. Quando o administrador libera você, o cartão do **Facilita** aparece em **Conectores** já pronto, dizendo quem liberou. A partir daí é só perguntar no chat. **Por que você não digita o seu e-mail?** Porque um e-mail digitado pode ser o de um colega, e a assistente passaria a agir como se você fosse essa pessoa. Quem diz quem é você no Facilita é o próprio Facilita: o Morada OS procura o seu e-mail de login na lista de usuários da sua empresa, ou o administrador aponta o seu cadastro. ### Se o cartão do Facilita não aparece Ou a sua empresa ainda não guardou a chave, ou você ainda não foi liberado. Nos dois casos quem resolve é quem administra o Morada OS na sua empresa (ou a Morada, se a integração foi feita por ela). Não há nada que você possa preencher para resolver sozinho. ### Se o cartão diz que você está sem vínculo no Facilita Você foi liberado, mas o Morada OS não sabe qual é o seu cadastro lá dentro. **As consultas funcionam normalmente**: negócios, clientes, empreendimentos, tarefas, tudo. Só a pergunta "quem sou eu no Facilita" fica de fora, e a assistente diz isso em vez de chutar. Peça o vínculo a quem administra. ### Se o cartão diz que o acesso precisa de atenção O Facilita recusou a chave da empresa, em geral porque ela foi trocada ou cancelada do lado do Facilita. Enquanto isso, a assistente não consulta o Facilita e avisa no chat em vez de responder por cima. Quem resolve é quem administra a conta (ou a Morada, se a integração foi feita por ela), guardando a chave nova. Assim que ela entra, todo mundo que já estava liberado volta sozinho. *** ## O que a assistente consegue fazer Nesta versão o conector é **só de consulta**: a assistente lê o Facilita e nunca grava nada nele. | Pergunte | O que volta | | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Quantos**: "quantos negócios em Venda Perdida?", "quantos por etapa?", "quantos no status Aguardando Contato?" | O número, e a distribuição por etapa quando você pede. A lista de negócios só aparece quando você pede para ver. | | **Negócios de uma etapa**, com o cliente, o status e o valor, ou um negócio específico pelo número | Cada negócio vem com o **link da página dele no Facilita**, montado pela assistente. Nos detalhes: cliente, responsável, empreendimento, unidade, campos personalizados. | | **Clientes** por nome, e-mail, CPF, CNPJ ou celular | O total de clientes que casam com a busca e os primeiros 15, cada um com os seus negócios. | | **Empreendimentos** e a disponibilidade de cada um | Unidades disponíveis, reservadas, vendidas e indisponíveis, sem precisar listar as unidades. Dá para abrir as unidades de um empreendimento por situação. | | **Tarefas** abertas ou concluídas, por tipo (ligação, visita, WhatsApp) e por período | O total e a lista, cada tarefa com o link do negócio a que pertence. | | **O que está parado**: as regras de ociosidade do seu Facilita e os negócios dentro de cada janela neste instante | O número de negócios parados naquela regra e, se pedir, quais são. | | **Quem sou eu no Facilita** | O seu grupo (corretor, gerente, supervisor, administrador) e a sua equipe. | Três coisas o Facilita não permite filtrar pela API, e a assistente diz isso em vez de inventar: **"meus negócios"** (o Facilita não filtra negócios por responsável; peça a contagem por etapa ou um negócio pelo cliente), **"minhas tarefas"** (peça por período ou por status) e a busca de clientes além dos **15 primeiros** (refine o termo com o nome completo, o e-mail ou os dígitos do celular). *** ## Ajustar as permissões no seu cartão Dentre as ferramentas que o administrador liberou para você, abra **Conectores > Facilita** e você vê a lista **O que Morada OS pode ler**, com uma etiqueta em cada ferramenta: * **Sempre permitir**: a ferramenta roda direto quando o seu pedido precisar dela. É o padrão, porque nenhuma delas altera o Facilita. * **Perguntar antes**: a assistente pede a sua confirmação no chat antes de consultar. Nada roda sozinho fora dessa lista: não existe rotina automática, agendamento ou sincronização em segundo plano. A assistente só toca no seu Facilita quando você pede, na conversa. *** ## Como usar no dia a dia Telefone e CPF são dados pessoais dos seus clientes. Use-os no chat só para localizar o registro no Facilita, dentro da conta da sua empresa, e não os copie para fora do Morada OS nem para conversas compartilhadas com quem não precisa deles. ```text wrap theme={null} Quantos negócios temos em cada etapa do funil? Onde está a maior parte? ``` ```text wrap theme={null} Liste os negócios em Proposta com o cliente, o valor e o link de cada um. ``` ```text wrap theme={null} Quantas unidades disponíveis tem o Nova Passos 4? E quantas reservadas? ``` ```text wrap theme={null} Quais tarefas de ligação estão abertas para esta semana? ``` ```text wrap theme={null} Quantos negócios estão parados há mais de 72 horas em Visita? ``` 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. *** ## Como o acesso é retirado Quem retira é quem administra: em **Conectores > Facilita > Administração**, **Remover acesso** na linha da pessoa. O acesso ao Facilita no chat cai na hora, e o administrador pode liberar de novo depois. Você não precisa (e não consegue) desvincular a sua própria conta, porque não existe conta sua guardada aqui: a chave é uma só, da empresa. Se quiser parar de usar o Facilita, peça a remoção do seu acesso.