Integração do Odoo com o CRM
Introdução
A partir da Versão 20 Update 10 do 3CX, o 3CX oferece integração nativa com o Odoo CRM por meio da API do 3CX CRM
com as seguintes características:
- Identificação de Chamadas para Nome do Contato – as chamadas recebidas acionam uma pesquisa de contato no Odoo.
- Pesquisa de Contatos no Odoo com base em Nome, Número ou E-mail ao procurar um nome no Cliente Web 3CX
- A integração do 3CX com o Odoo oferece suporte tanto a contatos comuns quanto a empresas para pesquisa.
- Registro de Chamadas e Chats – as chamadas e os chats são registrados no Cartão de Contato do Odoo como registros de chamadas e chats do CRM.
- Crie um novo contato no Odoo a partir do cliente 3CX para chamadas provenientes de novos números.
- Clique para Ligar – faça chamadas diretamente do Odoo via 3CX, usando as extensões de Navegador 3CX Click2Call para o Google Chrome e o Microsoft Edge.
Etapa 1: Configurar o Odoo
- 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 segurança
- 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 o 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
- Acesse Admin > Integrações > CRM.
- Selecione OdooCRM na lista suspensa
- Insira as informações necessárias:
- a URL do seu Domínio do 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 o Registro de Chamadas e Chats
- 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 enviar relatórios de 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.
- Observe que é possível usar variáveis nos parâmetros de Registro de Chamadas, indicadas como [variable_name]; por exemplo, o número externo é especificado como[Number]. As variáveis disponíveis para uso estão listadas aqui.
- Se você quiser registrar os chats no CRM, marque a caixa de seleção Ativar Registro de Chats.
- 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 remota 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 a 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 Admin > Sistema > Lista telefônica > Opções.
Use Corresponder exatamente se:
- você tem suporte completo ao E164:
- todos os contatos são armazenados neste formato
- e todas as chamadas são recebidas e feitas nesse formato.
- Isso garante que a correspondência de contatos seja 100% precisa.
Use Corresponder a pelo menos X número de 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 a Criação de Contatos
- 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 o número do chamador não puder ser associado a um contato, o cliente 3CX permitirá que o usuário preencha os detalhes em uma caixa de diálogo.
Veja Também
- Veja como integrar seu CRM à API do 3CX.
- Saiba como configurar a integração com o ConnectWise.
- Saiba como configurar a integração com o HubSpot.
- Saiba como configurar a integração com o Jetpack CRM.
- Saiba como configurar a Integração com o Microsoft 365.
- Saiba como configurar a integração com o Vtiger.
- Saiba como configurar integrações com bancos de dados Microsoft SQL Server, MySQL e PostgreSQL.
Última Atualização
Este documento foi atualizado pela última vez em 8 de setembro de 2026
