> ## 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 Pipedrive > Como conectar a sua conta do Pipedrive ao Morada OS com o seu token de API, o que a assistente consegue consultar e como desconectar quando quiser. O Pipedrive é o CRM de vendas onde o seu time acompanha negócios, contatos, empresas e atividades do funil. Ao conectar o Pipedrive ao Morada OS, você passa a perguntar sobre isso em linguagem natural ("quantos negócios estão em aberto no funil?") e recebe a resposta com o link para abrir cada negócio e cada contato direto no Pipedrive. *** ## Antes de começar Uma conta ativa em [os.morada.ai](https://os.morada.ai), com o login corporativo da sua empresa. O Pipedrive dá um **token de API** para cada pessoa, dentro da conta da empresa. Você o copia do próprio Pipedrive, e ele dá à assistente exatamente o que a sua conta lá dentro enxerga: nem mais, nem menos. **Você faz parte de mais de uma empresa no Pipedrive?** O token é por empresa: cada uma tem o seu. Se você conectar o token da empresa errada, a assistente consulta a base errada sem avisar. Para conferir, pergunte no chat "quem está conectado no Pipedrive?": a resposta diz sempre **qual empresa** o token abriu. *** ## Como conectar No Pipedrive, clique no nome da conta (canto superior direito), abra **Company settings > Personal preferences > API** (ou acesse [app.pipedrive.com/settings/api](https://app.pipedrive.com/settings/api)) e copie o **token** exibido. Se a opção **API** não aparecer para você, quem administra o Pipedrive da sua empresa precisa ligar a permissão "use API" no seu perfil (Manage users > Permission sets). **Cuidado:** o Pipedrive mostra **um único token ativo** por pessoa. Se você gerar um novo, o antigo para de funcionar na hora, inclusive para outras integrações que já o usem. No menu lateral do Morada OS, clique em **Conectores**. A página mostra as contas e sistemas disponíveis. Encontre o cartão do **Pipedrive** e clique em **Conectar**. Se a prateleira estiver cheia, use a busca no topo. Um formulário curto aparece no próprio cartão, com uma caixa só: * **Token de API**: cole o valor copiado do Pipedrive. Ao salvar, o Morada OS confere o token com o Pipedrive na hora. Para ver **qual empresa** ele abriu, pergunte no chat "quem está conectado no Pipedrive?". Token recusado significa token trocado, revogado ou copiado com um pedaço a mais: gere ou copie de novo no Pipedrive e repita. O token fica guardado de forma criptografada e o Morada OS nunca o mostra de volta, nem para você. A tela mostra apenas que existe uma conexão e quando foi feita. *** ## O que a assistente consegue fazer Nesta versão o conector é **só de consulta**: a assistente lê o Pipedrive e nunca grava nada nele. | Pergunte | O que volta | | - | - | | **Quantos**: "quantos negócios em aberto?", "quantos na etapa Proposta?" | O número exato em uma consulta. A lista de negócios só aparece quando você pede para ver. | | **Quantos por etapa**: "quantos negócios em cada etapa do funil?" | A contagem de cada etapa de uma vez, com o total do funil. | | **Negócios por dono, etapa ou contato**: "os negócios do João", "os negócios do contato Maria Souza", "os meus negócios" | Cada negócio vem com o **link da página dele no Pipedrive**, montado pela assistente. "Meus negócios" usa a sua própria conta, sem você precisar dizer quem é você. | | **Um negócio específico pelo número** | Os detalhes, o contato vinculado, as notas e as atividades do negócio. | | **Contatos (pessoas)** por nome, e-mail ou telefone | O total que casa com a busca e a lista, cada contato com o link da página dele. | | **Atividades**: "minhas atividades pendentes", "as atividades do negócio X" | O total e a lista, com assunto, data e quem tem a tarefa. | | **Quem está conectado** | O seu nome, o seu e-mail e **a empresa do Pipedrive** que o token abriu. É a conferência que evita a empresa errada. | Duas coisas o Pipedrive não permite filtrar pela API, e a assistente diz isso em vez de inventar: **atividades por data de vencimento** (para "as atividades da semana que vem", peça por negócio ou por responsável, ou salve um filtro no Pipedrive e peça por ele) e **negócios por data de criação ou fechamento** (só por data de atualização). As contagens de negócios por status, funil, etapa, dono ou filtro salvo são sempre exatas. Já as contagens de contatos e de atividades, e as de negócios filtrados por contato, empresa, período de atualização ou texto, param num mínimo em bases muito grandes, e a resposta diz quando isso aconteceu, em vez de inventar o número. *** ## Ajustar as permissões no seu cartão Abra **Conectores > Pipedrive** 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 Pipedrive. * **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 Pipedrive quando você pede, na conversa. *** ## Como usar no dia a dia E-mail e telefone são dados pessoais dos seus clientes. Use-os no chat só para localizar o registro no Pipedrive, 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 em aberto temos no funil? E quantos por etapa? ``` ```text wrap theme={null} Quais são os meus negócios? Me passa o link de cada um. ``` ```text wrap theme={null} Procure o negócio "nome do negócio" e me resume em que etapa ele está e o que ficou pendente. ``` ```text wrap theme={null} Quais atividades pendentes têm no negócio 222? De quem é cada uma? ``` 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 desconectar Abra **Conectores > Pipedrive** e use **Desvincular** no cartão. A assistente para de acessar o seu Pipedrive na hora. Desconectar no Morada OS **não revoga o token no Pipedrive**: enquanto ele continuar válido lá, quem o tiver na mão consegue usá-lo. Para revogar de verdade, gere um novo token em [app.pipedrive.com/settings/api](https://app.pipedrive.com/settings/api): o antigo deixa de funcionar em todo lugar, inclusive em outras integrações que o usem. *** ## Próximos passos O que mais o Morada OS conecta e onde encontrar cada guia. Três minutos que melhoram todos os seus pedidos à assistente. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.