> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Odoo 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](#option-1-webhook-tools-recommended)** 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](#option-2-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. > **Note** > > 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) ### 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. ### 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. ### 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. > **Warning** > > 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. ### 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**. ### Crie as ferramentas de webhook Para cada [ferramenta abaixo](#find-the-caller), 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 | Campo | Valor | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Nome** | `find_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étodo** | POST | | **URL** | `https://YOUR_ODOO_ADDRESS/json/2/res.partner/name_search` | | **Cabeçalhos da solicitação** | `Authorization` (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 corpo** | `name` (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 agentes** | **Recepcionista** | 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 | Campo | Valor | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | **Nome** | `create_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étodo** | POST | | **URL** | `https://YOUR_ODOO_ADDRESS/json/2/crm.lead/create` | | **Cabeçalhos da solicitação** | `Authorization` (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 corpo** | `vals_list` (object, obrigatório), com os campos abaixo | | **Atribuir a agentes** | **Recepcionista** | 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](/docs/pt/reception-ai/receptionist/testing) 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 ### Conecte o Zapier Se ainda não fez isso, conecte o [Zapier](/docs/pt/reception-ai/integrations/zapier) no Reception.ai. ### Adicione as ações do Odoo No seu servidor MCP do Zapier em [mcp.zapier.com](https://mcp.zapier.com), adicione as [ações abaixo](#zapier-actions) 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](#limitations). 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. ### 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). ### Teste [Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) 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 | Campo | Valor | | ------------------------- | --------------------------------------------------------------------------- | | **Ação do Zapier** | **Find Contact** | | **Definir no Zapier** | Nada. | | **Deixar a IA preencher** | O endereço de e-mail de quem liga ou, se não tiver e-mail, o nome completo. | | **Atribuir a** | **Cliente** | 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 | Campo | Valor | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Ação do Zapier** | **Create Lead** | | **Definir no Zapier** | O vendedor e a equipe de vendas para os quais os novos leads vão, se sua conta mostrar esses campos. | | **Deixar a IA preencher** | O 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 a** | **Cliente** | Deixe campos como receita esperada vazios, para que sua recepcionista não estime valores. > **Tip** > > Independentemente da opção usada, adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) > para que sua recepcionista peça o endereço de e-mail de quem liga e procure a pessoa antes de criar um > lead. > **Warning** > > 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](/docs/pt/reception-ai/receptionist/rules-and-procedures) 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](/docs/pt/reception-ai/integrations/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 | Problema | O que verificar | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 do Odoo | O 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 Odoo | Verifique 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 acesso | O usuário do Reception.ai precisa de acesso **Vendas**: **Usuário: Todos os documentos**. | | O Odoo não encontra o banco de dados | Adicione o cabeçalho `X-Odoo-Database` com o nome do seu banco de dados. | | Uma ação do Odoo não aparece no Reception.ai | Selecione **Atualizar ferramentas** na integração do Zapier depois de adicionar ações no Zapier. | | Uma ação mostra **Changed** e não é usada | Você a editou no Zapier. Selecione **Update** na aba **Ferramentas**. | | O Zapier não consegue conectar ao Odoo | Verifique 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 encontradas | Confirme 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 errados | Defina o vendedor e a equipe de vendas como valores fixos, na ferramenta de webhook ou no Zapier. |