Ir para a navegação

Odoo

Encontre pessoas que ligam entre seus contatos do Odoo e adicione novas pessoas que ligam como leads no CRM.

Sua recepcionista pode verificar se quem liga já é um dos seus contatos do Odoo e adicionar novos contatos ao Odoo CRM como leads, com as informações de que precisam, para que sua equipe de vendas possa fazer o acompanhamento. Há duas formas de conectar:

  • As ferramentas de webhook chamam a API JSON-2 do Odoo diretamente, sem precisar de uma conta do Zapier nem usar tarefas do Zapier. Elas exigem o Odoo 19 ou posterior, Community ou Enterprise, hospedado em odoo.com, no Odoo.sh ou no seu próprio servidor.
  • O Zapier também funciona com versões mais antigas do Odoo, mas cada ação usa tarefas do seu plano Zapier e não consegue pesquisar um banco de dados auto-hospedado.

Use ferramentas de webhook se seu banco de dados executar o Odoo 19 ou posterior. A API mais antiga do Odoo, JSON-RPC, recebe os argumentos de cada método como uma única lista mista de valores, que as ferramentas de webhook não conseguem criar. Por isso, em versões mais antigas, use o Zapier.

O Odoo só permite que apps externos acessem seus dados no plano Custom. Se o seu banco de dados for hospedado pelo Odoo no plano One App Free ou Standard, verifique seu plano antes de começar.

Opção 1: Ferramentas de webhook (recomendado)

1

Verifique sua versão do Odoo

Sua versão do Odoo aparece na parte inferior da página Configurações. As ferramentas de webhook exigem a versão 19 ou posterior. Para um banco de dados auto-hospedado, o servidor precisa estar acessível pela internet via HTTPS.

2

Crie um usuário para o Reception.ai

Em Configurações → Usuários e Empresas → Usuários, crie um usuário interno para o Reception.ai. Conceda a ele acesso Vendas: Usuário: Todos os documentos e nenhum acesso a outros apps, para que a chave de API só possa fazer o que as ferramentas precisam. Usuário: Todos os documentos permite atribuir novos leads ao vendedor que você escolher.

3

Crie uma chave de API

As chaves de API de usuários que não são administradores duram no máximo três meses. Para obter uma chave que dure um ano:

  1. Como administrador, ative o modo de desenvolvedor e acesse Configurações → Usuários e Empresas → Grupos.
  2. Crie um grupo chamado, por exemplo, Reception.ai API key, defina Duração máxima de chaves de API em dias como 365 e adicione o usuário do Reception.ai a ele.

Depois, entre como o usuário do Reception.ai, abra Preferências → Segurança da conta e selecione Nova chave de API. Dê a ela um nome, por exemplo Reception.ai, escolha a maior duração disponível e copie a chave imediatamente: o Odoo só a mostra uma vez. Anote a data de expiração e substitua a chave antes dela.

A chave de API pode fazer tudo o que o usuário do Reception.ai pode fazer. Não a inclua em documentos compartilhados e exclua-a no Odoo se ela vazar.

4

Encontre os IDs do vendedor e da equipe de vendas

Abra o usuário do vendedor em Configurações → Usuários e Empresas → Usuários. O número no final do endereço da página é o ID do usuário. Faça o mesmo para a equipe de vendas em CRM → Configuração → Equipes de vendas.

5

Crie as ferramentas de webhook

Para cada ferramenta abaixo, acesse Integrações, selecione Adicionar integração e escolha Ferramenta de webhook. Substitua YOUR_ODOO_ADDRESS pelo endereço do seu banco de dados, por exemplo, mycompany.odoo.com.

Todas as ferramentas enviam os mesmos cabeçalhos de solicitação:

  • Authorization (Segredo): Bearer seguido da sua chave de API
  • X-Odoo-Database (Valor): o nome do seu banco de dados. Necessário apenas se seu próprio servidor hospedar mais de um banco de dados.

Encontre quem está ligando

CampoValor
Nomefind_odoo_contact
Descrição”Encontre quem está ligando entre nossos contatos pelo endereço de e-mail ou, se não tiver e-mail, pelo nome completo. Use antes de adicionar um lead.”
MétodoPOST
URLhttps://YOUR_ODOO_ADDRESS/json/2/res.partner/name_search
Cabeçalhos da solicitaçãoAuthorization (Segredo): Bearer seguido da sua chave de API
X-Odoo-Database (Valor): o nome do seu banco de dados, somente se necessário
Parâmetros do corponame (string, obrigatório): “O endereço de e-mail de quem liga ou o nome completo, conforme a pessoa soletrar.”
operator (string, valor fixo): =ilike
limit (integer, valor fixo): 5
Atribuir a agentesRecepcionista

O operador =ilike corresponde ao nome ou endereço de e-mail completo, sem diferenciar maiúsculas de minúsculas, portanto uma busca por “Jane” não lista todas as pessoas chamadas Jane. O Odoo retorna apenas o ID e o nome de cada correspondência. A busca de contatos do Odoo não abrange números de telefone, então sua recepcionista precisa pedir um endereço de e-mail ou nome.

Adicione quem está ligando como lead

CampoValor
Nomecreate_odoo_lead
Descrição”Adicione quem está ligando ao nosso CRM como lead quando quiser um orçamento ou uma ligação de retorno.”
MétodoPOST
URLhttps://YOUR_ODOO_ADDRESS/json/2/crm.lead/create
Cabeçalhos da solicitaçãoAuthorization (Segredo): Bearer seguido da sua chave de API
X-Odoo-Database (Valor): o nome do seu banco de dados, somente se necessário
Parâmetros do corpovals_list (object, obrigatório), com os campos abaixo
Atribuir a agentesRecepcionista

O Odoo espera os campos do novo lead dentro de um objeto vals_list. Selecione Adicionar campo em vals_list para cada um destes:

  • name (string, obrigatório, da conversa): “O título do lead, por exemplo: Orçamento de cozinha - Jane Doe.”
  • contact_name (string, obrigatório, da conversa): “O nome completo de quem liga.”
  • email_from (string, da conversa): “O endereço de e-mail de quem liga, se tiver informado.”
  • phone (string, obrigatório, da conversa): “O número de telefone de quem liga em formato internacional, por exemplo +14155550123.”
  • description (string, obrigatório, da conversa): “O que a pessoa precisa, em poucas frases.”
  • user_id (integer, valor fixo): o ID de usuário do vendedor
  • team_id (integer, valor fixo): o ID da equipe de vendas

O vendedor e a equipe são valores fixos, portanto todos os leads vão para eles mesmo que a IA envie outros IDs. Não inclua campos como receita esperada, para que sua recepcionista não estime valores.

Selecione Ativar em cada ferramenta e, depois, teste sua recepcionista como um contato existente que fornece o e-mail e como uma nova pessoa que liga pedindo um orçamento. O novo lead aparece no pipeline do seu Odoo CRM.

Opção 2: Zapier

1

Conecte o Zapier

Se ainda não fez isso, conecte o Zapier no Reception.ai.

2

Adicione as ações do Odoo

No seu servidor MCP do Zapier em mcp.zapier.com, adicione as ações abaixo do app Odoo CRM e entre no Odoo quando o Zapier solicitar. Para cada campo, defina um valor fixo ou deixe a IA preenchê-lo, conforme indicado.

O app Odoo CRM funciona com bancos de dados hospedados em odoo.com. Para um banco de dados auto-hospedado, consulte Limitações.

As ações podem fazer tudo o que o usuário do Odoo com que você entrar pode fazer. Considere usar um usuário dedicado com acesso apenas ao CRM e aos contatos.

3

Atribua as ferramentas

No Reception.ai, abra a aba Ferramentas da integração do Zapier, selecione Atualizar ferramentas e atribua cada ação ao Cliente (recepcionista).

4

Teste

Teste sua recepcionista como um contato existente que fornece o e-mail e como uma nova pessoa que liga pedindo um orçamento. O novo lead aparece no pipeline do seu Odoo CRM.

Ações do Zapier

Encontre quem está ligando

CampoValor
Ação do ZapierFind Contact
Definir no ZapierNada.
Deixar a IA preencherO endereço de e-mail de quem liga ou, se não tiver e-mail, o nome completo.
Atribuir aCliente

O app do Zapier para Odoo encontra contatos por nome ou endereço de e-mail, não por número de telefone. Portanto, sua recepcionista precisa pedir uma dessas informações.

Adicione quem está ligando como lead

CampoValor
Ação do ZapierCreate Lead
Definir no ZapierO vendedor e a equipe de vendas para os quais os novos leads vão, se sua conta mostrar esses campos.
Deixar a IA preencherO título do lead (por exemplo, “Orçamento de cozinha - Jane Doe”), o nome, e-mail e número de telefone do contato, além de uma descrição do que a pessoa precisa.
Atribuir aCliente

Deixe campos como receita esperada vazios, para que sua recepcionista não estime valores.

Independentemente da opção usada, adicione um procedimento para que sua recepcionista peça o endereço de e-mail de quem liga e procure a pessoa antes de criar um lead.

A busca pode retornar contatos que não são quem está ligando, e Find Contact no Zapier retorna tudo o que estiver salvo no contato. Adicione uma regra orientando sua recepcionista a nunca informar os dados de um contato a quem liga e a usá-los apenas para reconhecer a pessoa.

Limitações

  • Sua recepcionista não consegue buscar quem liga pelo número de telefone. Ela precisa do endereço de e-mail ou nome exato.
  • A descrição do lead contém o que a pessoa queria. O app Odoo CRM do Zapier não tem uma ação para adicionar uma nota ou registrar uma chamada.
  • Com ferramentas de webhook, a chave de API expira. Substitua-a antes da data de expiração, ou as ferramentas deixarão de funcionar.
  • Com o Zapier, um banco de dados Odoo auto-hospedado precisa usar o app Odoo ERP Self Hosted do Zapier. A ação Create Lead/Opportunity adiciona leads, mas não há ações de busca, então uma pessoa que liga novamente pode ser adicionada duas vezes. As ferramentas de webhook podem pesquisar um banco de dados auto-hospedado no Odoo 19 ou posterior.
  • Sua recepcionista não consegue verificar disponibilidade nem agendar reuniões no Odoo. Use o próprio agendamento do Reception com o Google Calendar.
  • Com o Zapier, cada ação executada pela sua recepcionista usa tarefas do seu plano Zapier. Atualmente, o Zapier conta duas tarefas por chamada bem-sucedida; chamadas com falha não são contadas. Quando o plano acabar, as ações param até que ele seja renovado.

Solução de problemas

ProblemaO que verificar
401 do OdooO cabeçalho deve ser Authorization com Bearer , um espaço e a chave. Verifique se a chave não expirou nem foi excluída.
404 do OdooVerifique o endereço e se a URL termina em /json/2/res.partner/name_search ou /json/2/crm.lead/create. Seu banco de dados deve executar o Odoo 19 ou posterior, e o CRM deve estar instalado.
O Odoo retorna um erro de acessoO usuário do Reception.ai precisa de acesso Vendas: Usuário: Todos os documentos.
O Odoo não encontra o banco de dadosAdicione o cabeçalho X-Odoo-Database com o nome do seu banco de dados.
Uma ação do Odoo não aparece no Reception.aiSelecione Atualizar ferramentas na integração do Zapier depois de adicionar ações no Zapier.
Uma ação mostra Changed e não é usadaVocê a editou no Zapier. Selecione Update na aba Ferramentas.
O Zapier não consegue conectar ao OdooVerifique se seu plano do Odoo permite apps externos e se você usa o app correto para o local onde seu banco de dados está hospedado.
Pessoas conhecidas não são encontradasConfirme a grafia do endereço de e-mail com quem liga. As buscas por nome exigem o nome como está salvo no Odoo, e um contato vinculado a uma empresa é salvo como nome da empresa, uma vírgula e o nome da pessoa.
Leads vão para o vendedor ou equipe erradosDefina o vendedor e a equipe de vendas como valores fixos, na ferramenta de webhook ou no Zapier.