Odoo CRM Integration

Visão geral

A integração do Odoo CRM conecta seu Virtual-Call Cloud PABX perfeitamente ao sistema Odoo CRM. Este recurso permite que você gerencie dados do CRM diretamente de suas estações de trabalho de telefone e aumente a eficiência de sua comunicação.

Principais funcionalidades:

• Click-to-Call: Inicie chamadas diretas através de contatos do CRM
• Pop-up de chamada: Abertura automática de dados de contato do CRM durante chamadas recebidas
• Registro de chamadas: Registro automático de todas as atividades de chamada no Odoo CRM
• Sincronização de contatos: Sincronização periódica de contatos do CRM com a lista telefônica
• Criação de leads e contatos: Criação automática ou manual de novos contatos durante chamadas

Pré-requisitos

Requisitos do Odoo:

• Hospedagem: Odoo Online
• Edição: Odoo Enterprise
• Versão: Odoo 14.0 ou superior
• Conta de usuário: Conta de administrador do banco de dados Odoo com acesso às configurações da API

Virtual-Call Cloud PABX:

• Versão de firmware: 84.21.0.66 ou superior

Informações necessárias do Odoo:

• Nome do banco de dados (ex: "suaempresa")
• Domínio do Odoo (ex: "https://suaempresa.odoo.com")
• Endereço de e-mail da conta de administrador

Conectar Odoo CRM

Etapa 1 – Criar chave de API no Odoo

Primeiro, você precisa gerar uma chave de API no Odoo para autenticar a conexão com seu Virtual-Call Cloud PABX.

1. Faça login no Gerenciador de Banco de Dados do Odoo e clique no botão Connect ao lado de seu banco de dados.
2. Clique no ícone de conta no canto superior direito do painel do Odoo e selecione Preferences no menu suspenso.
3. Navegue até a aba Account Security.
4. Clique no botão NEW API KEY.
5. Digite uma descrição significativa, por exemplo, "Integração Virtual-Call", e clique em GENERATE KEY.
6. Anote a chave de API gerada e guarde-a com segurança. Você precisará desta chave em breve.

Etapa 2 – Conectar Odoo CRM ao PABX

Agora você conecta seu banco de dados Odoo ao Virtual-Call Cloud PABX.

1. Faça login em seu Virtual-Call Cloud PABX.
2. Navegue até Integrações CRM e selecione Odoo.
3. Digite suas credenciais de autenticação:
   • Seu endereço Odoo: O domínio de seu banco de dados Odoo (ex: https://suaempresa.odoo.com)
   • Nome do banco de dados: O nome de seu banco de dados Odoo (ex: suaempresa)
   • Nome de login do administrador: O endereço de e-mail da conta de administrador do Odoo
   • Chave de API: A chave de API que você criou na Etapa 1
4. Clique em Salvar.
5. Na janela de confirmação, clique em OK.
6. O status agora deve exibir Conectado. A integração foi configurada com sucesso.

Etapa 3 – Vincular usuários do Odoo com Ramais

Para aproveitar plenamente a integração do CRM, seus usuários do Odoo devem ser vinculados aos ramais do Virtual-Call Cloud PABX. Isso pode ser feito automaticamente ou manualmente.

Atribuição automática:

O sistema compara automaticamente os endereços de e-mail dos usuários do Odoo com os endereços de e-mail dos usuários dos ramais no Virtual-Call Cloud PABX.

1. Clique no botão Atribuir automaticamente na integração Odoo.
2. Confirme a atribuição na janela pop-up clicando em OK.
3. Clique em Salvar para aplicar as alterações.

Atribuição manual:

Se a atribuição automática não funcionar ou você deseja fazer atribuições específicas, pode atribuir usuários manualmente.

1. Clique no ícone de edição ao lado do usuário do Odoo que deseja atribuir.
2. Selecione da lista os ramais que devem ser atribuídos a este usuário.
3. Clique em Confirm (ou no botão de confirmação apropriado).
4. Clique em Save para salvar as alterações.

Configurar recursos de integração

Sincronização de contatos

A sincronização de contatos copia contatos de seu Odoo CRM para a lista telefônica do Virtual-Call, para que você possa chamá-los diretamente de seu software de telefone.

1. Navegue até Integrações CRM Odoo.
2. Ative a caixa de seleção Sincronizar contatos automaticamente.

3. Configure as seguintes configurações:

   

   • Sincronizar contatos de: Selecione no menu suspenso quais registros do Odoo devem ser sincronizados:
     • Pessoa – Sincroniza contatos do gerenciamento de contatos
     • Leads – Sincroniza leads do gerenciamento de leads
     • Empresa – Sincroniza contatos de empresa
   • Sincronizar em lista telefônica: Selecione uma lista telefônica existente ou crie uma nova onde os contatos devem ser armazenados.
   • Sempre consultar CRM: Esta opção ativa a consulta de CRM em tempo real para chamadas recebidas e ao pesquisar no UC Client.
     • Ativado: O sistema executa uma consulta de CRM em tempo real quando você pesquisa um contato no UC Client (também por discagem rápida). Isso fornece os resultados mais atualizados, mas requer mais recursos.
     • Desativado: O sistema usa primeiro a lista telefônica local. O CRM é consultado apenas se nenhuma correspondência local for encontrada.
4. Clique em Salvar.

Resultado: A lista telefônica sincronizada é marcada com um rótulo CRM e está disponível no UC Client.

Criação de leads e contatos

Com este recurso, novos contatos ou leads podem ser criados automaticamente no Odoo CRM quando você liga para um número desconhecido durante uma chamada.

1. Navegue até Integrações CRM Odoo.
2. Ative a caixa de seleção Criar novo contato.
3. Configure as configurações:
   • Criar contato ou lead: Escolha se deseja criar contatos (pessoa) ou leads.
   • Método de criação:
     • Automático: O sistema cria contatos/leads automaticamente durante uma chamada. Você pode escolher para quais tipos de chamada isso deve ocorrer:
       • Apenas chamadas recebidas
       • Apenas chamadas realizadas
       • Chamadas recebidas e realizadas
     • Manual: Durante uma chamada, os usuários podem criar manualmente um novo contato/lead (através de um menu de contexto na janela de chamada).
4. Clique em Salvar.

Pop-up de chamada

O pop-up de chamada exibe automaticamente as informações de contato do CRM quando você recebe ou realiza uma chamada. Isso melhora a eficiência, pois você tem informações de contexto imediatamente.

1. Navegue até Ramais e Tronco Ramal.
2. Clique no ramal para o qual deseja ativar o pop-up e selecione a aba UC Clients (Virtual-Call UC Client).
3. Ative a caixa de seleção Abrir URL de contato via CRM integrado no sistema.
4. Selecione o método de pop-up:
   • Automático (apenas chamadas recebidas): O pop-up abre automaticamente em chamadas recebidas. Selecione quando o pop-up deve disparar:
     • Toque: Pop-up abre assim que o telefone toca
     • Aceito: Pop-up abre quando a chamada é aceita
     • Chamador: Pop-up abre quando o chamador é identificado
   • Manual: O pop-up abre apenas quando você clica no rótulo CRM ou em um botão correspondente na janela de chamada durante uma chamada.
5. Clique em Salvar.

Resultado: Quando uma chamada é recebida e um contato é encontrado no CRM, uma janela do navegador abre automaticamente (ou manualmente) com os detalhes do contato do Odoo.

Registro de chamadas

O registro de chamadas (Journal de Chamadas) documenta automaticamente cada chamada como uma atividade no Odoo CRM. Isso cria um histórico de comunicação completo para cada contato ou lead.

1. Navegue até Integrações CRM Odoo.
2. Ative a caixa de seleção Registro de chamadas.
3. Configure as configurações:
   • Assunto: Digite um formato de assunto para as entradas de registro, ex: "Chamada de {Call_From} para {Call_To}". O assunto é exibido como título da atividade.

   • Descrição: Defina o conteúdo da entrada do registro. Você pode usar as seguintes variáveis:

     • {Time} – Data e hora da chamada
     • {Call_Log_Status} – Status da chamada (aceita, rejeitada, perdida, etc.)
     • {Call_From} – Número ou nome do chamador
     • {Call_To} – Número ou nome do destinatário
     • {Talk_Duration} – Duração da conversa em segundos

     Exemplo: "Chamada com {Call_From} em {Time}. Status: {Call_Log_Status}. Duração: {Talk_Duration}s"

   • Ocultar chamadas perdidas de agentes não atribuídos: Se ativado, as chamadas perdidas de agentes não atribuídos não serão registradas. Isso reduz a desordem no histórico do CRM.
4. Clique em Salvar.

Resultado: Todas as atividades de chamada são automaticamente documentadas como entradas na seção de atividades do contato ou lead correspondente do Odoo CRM. Assim você tem um histórico de comunicação completo.

Solução de problemas

A sincronização de contatos falha:

• Verifique se cada contato a ser sincronizado possui primeiro e último nome (ou nome completo) e pelo menos um número de telefone.
• Certifique-se de que a conexão do banco de dados Odoo está ativa (Status: "Conectado").
• Tente reiniciar a sincronização manualmente salvando as configurações.

O pop-up de chamada não abre:

• Verifique as configurações de bloqueador de pop-up do seu navegador e adicione o domínio do Odoo à lista de exceções.
• Certifique-se de que o contato existe no CRM e está corretamente atribuído.
• Verifique que a opção "Abrir URL de contato via CRM integrado no sistema" está ativada no ramal.

Chave de API perdida ou expirada:

• Faça login no Odoo e navegue até Account Security.
• Exclua a chave de API antiga.
• Crie uma nova chave de API e substitua-a nas configurações do Virtual-Call Cloud PABX.

Os usuários não são atribuídos automaticamente:

• Verifique se os endereços de e-mail do usuário do Odoo e do ramal Virtual-Call correspondem exatamente (incluindo maiúsculas/minúsculas e domínios).
• Neste caso, use a atribuição manual para os usuários afetados.

Desativar ou desconectar integração

Você pode desativar ou desconectar completamente a integração Odoo a qualquer momento.

Desativar integração:

• Navegue até Integrações CRM Odoo.
• Clique no botão Desativar (ou rotulado similarmente).
• A configuração permanece salva; você pode reativar a integração posteriormente.

Desconectar integração:

• Navegue até Integrações CRM Odoo.
• Clique no botão Desconectar ou Remover.
• Aviso: Esta ação exclui todas as configurações e desconecta completamente. Você deve reconfigurar todas as configurações se deseja reativar a integração posteriormente.

New Authentication Method from Version 84.23.0.24

OAuth2 PKCE Support

Custom CRM/Helpdesk integration templates now support the authentication method Authorization Code Flow with Proof Key for Code Exchange (PKCE). This method uses a challenge-verifier pair instead of a client secret, thereby improving the security of OAuth 2.0 authentication.