Ligar a partir de um registo Odoo

Um clique num número dentro de um registo Odoo leva o registo com a chamada. Uma regra pode então escrever a nota da chamada, com a gravação e a transcrição, nesse registo preciso em vez de no contacto.

Em resumo

Como funciona

Um comercial abre uma oportunidade no Odoo e clica no número de telefone, como já faz. A chamada parte do softphone integrado no Odoo, sem sair da página. Quando desliga, chega uma nota à oportunidade: quem ligou, quando, durante quanto tempo, o ficheiro áudio e a transcrição da conversa. Ninguém escreveu nem arquivou nada.

O número por si só não diz sobre o que era a chamada: o mesmo contacto pode estar ligado a três oportunidades. No momento do clique, o módulo lê por isso o endereço da página apresentada, e mais nada do seu Odoo. Tira dele até três variáveis, que a chamada transporta até ao fim:

Desde o Odoo 18, o endereço de um registo nomeia o menu pelo qual foi aberto, como crm ou sales, e não o modelo. O módulo nunca traduz essa palavra num modelo: para isso teria de consultar o seu Odoo, e não lê nenhum dos seus dados. É a sua regra que faz a ligação, testando a palavra, o modelo ou ambos.

Uma regra da página Eventos de chamada reconhece estas chamadas graças ao critério Variáveis da chamada. A sua ação Odoo encontra o registo pelo identificador, {{odoo_source_id}}: não procura um registo que tenha o mesmo número de telefone, aponta exatamente para aquele de onde a chamada partiu.

Configuração

1. Verificar o módulo

A versão do módulo lê-se na sua ficha, entre as aplicações do seu Odoo. Tem de terminar em 1.0.18 ou superior, por exemplo 19.0.1.0.18. Abaixo disso, a chamada parte normalmente mas não transporta nenhuma variável, e nada é arquivado. Para o atualizar, siga o procedimento de instalação da sua versão do Odoo, na página Procedimentos.

2. Criar a ação Odoo

1. Abra Integrações, Odoo e clique no ícone "Ações no Odoo" da sua instância.
2. Clique em Adicionar uma ação e dê um Nome à ação.
3. Em Modelo Odoo, escolha o modelo dos seus registos, por exemplo crm.lead para as oportunidades.
4. Em O que se faz, escolha Adicionar uma nota a um registo existente.
5. Em Encontrar o registo cujo, escolha o campo ID (id) e escreva o valor {{odoo_source_id}}. Não aparece na lista de valores propostos: escreva-o à mão, com as chavetas duplas.
6. Em Se nenhum registo corresponder, escolha Não escrever nada. Assim, uma chamada que não vem de um registo não cria nada e não suja nada.
7. Em Definições, ative Anexar a gravação da chamada e Ativar esta ação e clique em Guardar.

3. Criar a regra

1. Abra Integrações, Eventos de chamada e clique em Adicionar uma regra no cartão Chamada terminada.
2. Dê um Nome à regra.
3. Em Quando, assinale Variáveis da chamada. Escreva odoo_source_path, escolha é igual a e escreva crm.
4. Clique em Adicionar uma condição. Escreva odoo_source_model, escolha é igual a e escreva crm.lead.
5. Por baixo das condições, escolha pelo menos uma condição e clique em Guardar.
6. Em Fazer, escolha o tipo Escrever no Odoo, a sua instância e a ação criada no passo anterior, e clique em Adicionar uma ação.

As duas condições cobrem todas as versões do Odoo: a primeira reconhece o endereço do Odoo 18 e posteriores, a segunda o das versões mais antigas, e com pelo menos uma condição basta que uma das duas corresponda. A palavra a testar é a que a barra de endereço do seu Odoo mostra quando um registo está aberto: verifique-a uma vez, pode ser diferente se os seus menus tiverem sido personalizados.

Para outro tipo de registo, crie mais uma ação e mais uma regra. Para os orçamentos, por exemplo: o modelo sale.order na ação, e na regra odoo_source_path é igual a sales ou odoo_source_model é igual a sale.order.

4. Experimentar

Abra uma oportunidade no Odoo, clique no seu número de telefone e desligue após alguns segundos de conversa. A nota chega normalmente à oportunidade em menos de um minuto, ou após alguns minutos quando a ação espera pela gravação.

Na Lista de chamadas, a coluna Variáveis da chamada mostra quantas variáveis a chamada transporta. Um clique nesse número mostra-as: odoo_source_path vale crm e odoo_source_id o número da oportunidade. Veja a página Lista de chamadas.

O que convém saber

• Só as chamadas lançadas com um clique levam o registo. Um número marcado no teclado do softphone não transporta nada, porque nenhum registo esteve envolvido.
• Conta o registo apresentado no momento do clique. Se o utilizador mudar de registo antes de ligar, recebe a nota aquele que estava a ver quando clicou.
• As chamadas recebidas não têm registo de origem. São tratadas pela procura do contacto, veja a página Odoo.
• Nada é recuperado. Só as chamadas feitas depois da configuração são arquivadas.
• A gravação e a transcrição têm de estar ativadas na sua conta. Sem elas, a nota chega na mesma, sem o ficheiro áudio nem o texto.
• O módulo não lê nenhum dado do seu Odoo. Não acrescenta nenhum campo nem nenhuma tabela, e só olha para o endereço da página.

Se não funcionar

A nota não chega ao registo. Abra a Lista de chamadas e veja a coluna Variáveis da chamada da chamada. Vazia: o módulo é anterior à 1.0.18, ou a chamada não partiu de um clique num registo. Presentes: compare odoo_source_path ou odoo_source_model com as condições da regra, basta uma única letra diferente para a excluir.

As variáveis estão lá, mas nada é escrito. Verifique se a ação está ativada, se a instância está ativa e se o modelo da ação é mesmo o do registo: um identificador de oportunidade procurado entre os contactos não encontra nada, e aplica-se Não escrever nada. O ícone "Ver o estado da integração" da lista de instâncias mostra também o que está a bloquear.

A nota chega sem a gravação. Anexar a gravação da chamada tem de estar ativado na ação, e a chamada tem de ter sido gravada.