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

# Pipedrive

> Como conectar o Pipedrive a um agente do ChatNorris, pelo ChatNorris ou pelo Marketplace do Pipedrive, e o que o agente cria no seu CRM: pessoas, organizações, Leads, notas e atividades.

# Pipedrive

Com a integração do Pipedrive, cada contato que o seu agente do ChatNorris capta chega sozinho ao seu CRM. Quando um visitante deixa o email ou o telefone (no chat, no Lead Form ou ao agendar um horário), o agente:

* procura a pessoa no Pipedrive pelo email ou pelo telefone e a cria se ela não existir;
* associa a empresa dela como organização;
* cria um Lead na caixa de entrada de Leads, com uma etiqueta para identificá-lo;
* adiciona uma nota com o link para a conversa e, se você quiser, um resumo feito com IA;
* registra atividades de acompanhamento quando o agente transfere para uma pessoa da sua equipe ou quando o visitante agenda uma reunião.

Sua equipe de vendas trabalha o Lead no Pipedrive como qualquer outro, com todo o contexto da conversa a um clique.

## Requisitos

* Uma conta do ChatNorris com plano **Standard** ou **Premium**. Você pode ver os planos em [chatnorris.ai/pricing](https://chatnorris.ai/pricing).
* Pelo menos um agente criado no ChatNorris. Se você ainda não tem um, siga [Criar um agente](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md).
* Uma conta do Pipedrive com permissão para instalar apps.
* Função **Owner** ou **Admin** na sua organização do ChatNorris.

> [!NOTE]
>
> Por enquanto, as notas e atividades que o ChatNorris cria no Pipedrive estão em espanhol.

## Conectar o Pipedrive

Cada agente se conecta a uma conta do Pipedrive. Você pode começar pelo ChatNorris ou pelo Marketplace do Pipedrive; o resultado é o mesmo.

> [tab] Pelo ChatNorris
>
> **1. Abra o hub de Integrações do agente**
>
> No ChatNorris, acesse `Agentes → [seu agente] → Integrações` e escolha **Pipedrive** no catálogo.
>
> **2. Clique em Conectar com Pipedrive**
>
> O Pipedrive é aberto. Se você não estiver com a sessão iniciada, faça login com a sua conta.
>
> **3. Aceite as permissões**
>
> O Pipedrive mostra as permissões que o ChatNorris solicita (veja [Permissões](#permissões)). Aceite-as para continuar.
>
> **4. Volte ao ChatNorris**
>
> O Pipedrive leva você de volta à página da integração, que mostra a conexão ativa com o nome da sua empresa no Pipedrive. Continue em [Configurar a Ação](#configurar-a-ação).

> [tab] Pelo Marketplace do Pipedrive
>
> **1. Procure o ChatNorris no Marketplace**
>
> No Marketplace do Pipedrive, abra o app **ChatNorris** e clique em **Instalar agora**.
>
> **2. Faça login no ChatNorris**
>
> O Pipedrive leva você ao ChatNorris. Faça login com a sua conta ou, se ainda não tiver uma, clique em **Experimente grátis** para criá-la. Ao terminar, você volta à instalação.
>
> Se você confirmar sua conta por email, volte à aba da instalação e faça login nela. Se você ainda não tiver agentes, a tela oferece a criação de um: depois, conecte o Pipedrive pelo hub de Integrações do agente (aba **Pelo ChatNorris**).
>
> **3. Escolha o agente**
>
> Na tela **Conectar Pipedrive**, escolha o agente que vai enviar os contatos dele ao Pipedrive e clique em **Conectar**.
>
> **4. Aceite as permissões**
>
> O Pipedrive mostra as permissões que o ChatNorris solicita (veja [Permissões](#permissões)). Aceite-as para continuar. Você volta ao ChatNorris com a conexão ativa.

> [!TIP]
>
> Tem vários agentes? Repita a conexão em cada um. Eles podem usar a mesma conta do Pipedrive ou contas diferentes.

## Configurar a Ação

Conectar o Pipedrive ainda não envia nada. Para escolher o que o agente faz no seu CRM:

**1. Crie a Ação Pipedrive**

Acesse `Agentes → [seu agente] → Ações`, clique em **Nova ação** e escolha **Pipedrive**.

**2. Escolha os recursos**

Ative os que você quiser (veja a tabela abaixo). Alguns dependem de outros: por exemplo, para etiquetar o Lead, primeiro você precisa criá-lo.

**3. Ative a Ação e salve**

A partir desse momento, cada contato confirmado deste agente chega ao Pipedrive.

| Recurso | O que faz no Pipedrive |
| - | - |
| **Sincronizar pessoa** | Procura a pessoa pelo email ou pelo telefone e a cria se ela não existir. Se já existir, só completa o email ou o telefone que estiverem faltando: nunca sobrescreve seus dados. |
| **Sincronizar empresa** | Se o visitante informou a empresa (por exemplo, no campo **Empresa** do Lead Form), procura-a como organização pelo nome exato e a cria se ela não existir. Associa-a ao Lead e à pessoa, somente se a pessoa não tinha outra organização. |
| **Criar Lead** | Cria um Lead na caixa de entrada de Leads, associado à pessoa. Um para cada lead do ChatNorris. Você pode alterar o título; `{name}` é substituído pelo nome do visitante. |
| **Etiquetar o Lead** | Adiciona uma etiqueta ao Lead (por padrão, **ChatNorris**) para filtrá-lo. Se a etiqueta não existir, ela é criada. |
| **Nota com a conversa** | Adiciona ao Lead uma nota com o canal e o link para a conversa no ChatNorris. |
| **Resumo com IA** | Acrescenta à nota um resumo do que o visitante procura. Consome 1 crédito de IA por lead, só quando é preciso gerá-lo. |
| **Atribuir responsável** | Atribui cada Lead novo sempre ao mesmo vendedor ou em rodízio entre vários. Sem isso, o responsável é o usuário do Pipedrive que conectou a conta. |
| **Acompanhamento ao transferir para um humano** | Quando o agente transfere a conversa para uma pessoa da sua equipe, cria uma ligação ou uma tarefa no Lead, com o resumo do caso e o prazo que você escolher. |
| **Registrar reuniões agendadas** | Quando o visitante agenda um horário com Google Calendar, Encuadrado ou AgendaPro, registra-o no Lead como atividade **Reunião**, com data e hora. |

> [!NOTE]
>
> O ChatNorris só cria e completa dados: nunca exclui pessoas, organizações nem Leads, e não lê seus negócios, seus emails nem seus produtos. Se o mesmo visitante voltar a escrever, nada é duplicado: o agente reconhece a pessoa e o Lead que já criou.

## Permissões

Ao instalar, o Pipedrive pede que você aceite estas permissões para o ChatNorris:

| Permissão do Pipedrive | Para que o ChatNorris a usa |
| - | - |
| Contatos (`contacts:full`) | Criar e completar pessoas e organizações, e adicionar notas. |
| Leads (`leads:full`) | Criar Leads e etiquetas de Lead. |
| Busca (`search:read`) | Procurar pessoas pelo email ou pelo telefone e organizações pelo nome, para não duplicá-las. |
| Atividades (`activities:full`) | Criar as atividades de acompanhamento e as reuniões. |
| Usuários (`users:read`) | Listar os usuários da sua conta para escolher o responsável pelos Leads. |

## Desconectar ou desinstalar

Você pode cortar a conexão por qualquer um dos dois lados:

* **Pelo ChatNorris:** em `Agentes → [seu agente] → Integrações → Pipedrive`, clique em **Desconectar**. A Ação Pipedrive é desativada e mantém sua configuração.
* **Pelo Pipedrive:** nas configurações da sua conta, abra a lista de apps instalados e desinstale o ChatNorris. O ChatNorris recebe o aviso e marca a conexão como expirada em todos os agentes que a usavam.

O que já foi criado no Pipedrive (pessoas, organizações, Leads, notas e atividades) continua na sua conta. Para voltar a enviar contatos, conecte o Pipedrive de novo e ative a Ação.

## Perguntas frequentes

> [accordion] Por que dois leads ficaram na mesma pessoa?
>
> O agente identifica a pessoa pelo email ou pelo telefone, não pelo nome. Se duas conversas deixarem o mesmo email ou telefone, os dois Leads são associados à mesma pessoa, mesmo que o nome escrito seja diferente. Assim evitamos pessoas duplicadas no seu CRM.

> [accordion] O Lead não tem organização
>
> Verifique se o recurso **Sincronizar empresa** está ativo e se o visitante informou a empresa, por exemplo em um campo **Empresa** do Lead Form. Sem empresa, o Lead é criado do mesmo jeito, só com a pessoa.

> [accordion] A reunião agendada não aparece no Lead
>
> Verifique se **Registrar reuniões agendadas** está ativo. Só são registrados os agendamentos do Google Calendar, Encuadrado e AgendaPro; Cal.com e Calendly não avisam o ChatNorris sobre a reserva.

> [accordion] A integração aparece como Requer atenção
>
> O Pipedrive deixou de aceitar o acesso: por exemplo, porque o app foi desinstalado ou porque a conexão ficou mais de 60 dias sem uso. Conecte o Pipedrive novamente pelo hub de Integrações.

> [accordion] Conectar o Pipedrive consome créditos?
>
> Não. Só o **Resumo com IA** consome 1 crédito de IA por lead, e só quando o resumo ainda não existia no ChatNorris.

## Suporte

Precisa de ajuda com a instalação? Escreva para [hola@chatnorris.ai](mailto:hola@chatnorris.ai).


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