Integração do Odoo com o CRM

Introdução

A partir do 3CX Versão 20 Update 10, o 3CX oferece integração nativa com o Odoo CRM por meio da API CRM do 3CX

com as seguintes características:

  • Identificação de Chamada para Nome do Contato – as chamadas recebidas acionam uma pesquisa de contato no Odoo.
  • Pesquisa de Contato no Odoo com base no Nome, Número ou E-mail ao pesquisar um nome no 3CX Webclient
  • A integração do 3CX com o Odoo permite a pesquisa tanto de contatos comuns quanto de empresas.
  • Registro de Chamadas e Chats – as chamadas e os chats são registrados no Cartão de Contato do Odoo como registros de chamada e chat do CRM.
  • Crie um novo contato no Odoo a partir do cliente 3CX para chamadas provenientes de novos números.
  • Clique para Ligar – inicie chamadas diretamente do Odoo via 3CX, utilizando as extensões do Navegador 3CX Click2Call para Google Chrome e Microsoft Edge.

Etapa 1: Configurar o Odoo

Criar API Key no 3CX

  • Faça login no seu Odoo CRM
  • Clique na sua imagem de Perfil e selecione a opção Minhas Preferências
  • Selecione a guia Segurança
  • Clique no botão Adicionar Chave de API:
  • Dê um nome à sua nova chave de API e defina um prazo de validade para ela
  • Clique no botão Gerar chave
  • Copie sua chave de API com cuidado
  • Clique no botão Concluído
  • Observação: anote o nome do banco de dados da sua instância; geralmente, é o nome do host do FQDN do Odoo
  • Se você não tiver certeza do nome do banco de dados:
  • Clique na sua imagem de Perfil e selecione a opção Meus Bancos de Dados
  • Faça login novamente, se necessário
  • Fare uma observação sobre o nome do banco de dados da sua instância

Etapa 2: Configurar o 3CX

Configuração da integração OdooCRM no 3CX com domínio, banco de dados e Chave API

  • No Console de Admin 3CX, acesse Integrações → CRM
  • Selecione OdooCRM na lista suspensa
  • Insira as informações necessárias:
  • a URL do seu Domínio Odoo (por exemplo, https://3cx-example.odoo.com)
  • o Nome do banco de dados do seu Odoo
  • sua Chave de API do Odoo
  • Clique no botão Salvar

Etapa 3: Configurar Registro de Chamadas e Chat

Configuração de modelos de registro de chamadas 3CX: assunto, chamadas atendidas, perdidas e não atendidas

  • Para registrar chamadas externas, o número de telefone da pessoa do outro lado da linha deve corresponder ao número de telefone de um contato do Odoo. Dessa forma, o 3CX pode associar a chamada recebida ao contato do Odoo.
  • Marque a opção Ativar Registro de Chamadas para relatar chamadas externas ao CRM e configure estes parâmetros de Registro de Chamadas:
  • "Assunto da Chamada" — o assunto da chamada.
  • "Chamada Recebida Atendida" — descrição para chamadas recebidas atendidas.
  • "Chamada Perdida" — descrição para chamadas perdidas.
  • "Chamada Efetuada Atendida" — descrição para chamadas efetuadas atendidas.
  • "Chamada Efetuada Não Atendida" — descrição para chamadas efetuadas que não foram atendidas.
  • Observação: é possível usar variáveis nos parâmetros do Registro de Chamadas, indicadas como
    [nome_da_variável]
    ; por exemplo, o número externo é especificado como
    [Número]
    . As variáveis disponíveis para uso estão listadas     aqui.

Ativar Registro de Chat

  • Se você quiser registrar os chats no CRM, marque a caixa de seleção Ativar Registro de Chat.
  • Você pode personalizar o “Assunto do Chat”
  • Para reportar conversas externas ao Odoo, o endereço de e-mail (Web Chat) ou o número de telefone (SMS/WhatsApp) da pessoa com quem se está conversando deve corresponder ao campo relevante de um contato do Odoo. Dessa forma, o 3CX pode associar a conversa recebida ao contato do Odoo.
  • É possível usar variáveis no parâmetro “Assunto do Chat”, indicadas como
    [variable_name]
    ; por exemplo, o número externo é especificado como
    [Number]
    . As variáveis disponíveis para uso estão listadas     aqui.

Etapa 4: Configurar Correspondência de Contatos

Ordem de Correspondência de Contatos

Na página de configuração do 3CX no Odoo, você pode escolher se a correspondência de contatos deve ser realizada primeiro com os contatos normais ou com os registros do tipo “Empresa” no Odoo.

Além disso, dependendo das suas necessidades, você pode usar a correspondência exata ou parcial de contatos para as chamadas. Isso pode ser configurado em Sistema > Lista Telefônica > Opções.

Opções de Contato com correspondência de ID do chamador: corresponder exatamente

Use Corresponder exatamente se:

  • você tem suporte total ao E164:
  • todos os contatos são armazenados neste formato
  • e todas as chamadas são recebidas e realizadas nesse formato.
  • Isso garante que a correspondência de contatos seja 100% precisa.

Opções de Contato com correspondência de ID do chamador: corresponder pelo menos um número mínimo de caracteres

Use Corresponder a pelo menos X caracteres se:

  • Suas chamadas são feitas e recebidas por meio de uma combinação de:
  • Chamadas locais,
  • E164
  • Ou outros formatos de discagem internacional.
  • O número ideal de caracteres dependerá do seu esquema de numeração local.

Etapa 5: Configurar Criação de Contatos

Configurar criação de contatos no CRM

  • Se você quiser criar novos contatos no CRM ao receber uma chamada de um número desconhecido (que não consta nem no 3CX nem no CRM), marque a caixa de seleção Permitir a criação de contatos diretamente no seu CRM usando o Cliente Web 3CX.
  • Quando não for possível associar o número do chamador a um contato, o cliente 3CX permitirá que o usuário preencha os detalhes em uma caixa de diálogo.

Veja Também

Última Atualização

Este documento foi atualizado pela última vez em 30 de julho de 2026

https://www.3cx.com.br/docs/odoo-crm-integration/