Odoo, resolução de contacto
Procura quem liga no Odoo a partir do seu número e expõe seis variáveis. Este módulo nunca bloqueia a chamada, mesmo que o Odoo esteja inacessível.
Em resumo
| Saídas | Encontrado, Não encontrado e Erro |
| Campos | Instância Odoo, Número a procurar, e a caixa Mudar o nome de quem liga para o nome do contacto encontrado |
| Variáveis expostas | 6, sempre definidas, mesmo quando a procura falha |
| Número procurado por predefinição | {{caller}} |
| Mudança de nome | marcada por predefinição |
| Bloqueio da chamada | nunca, aconteça o que acontecer |
| Espera | não regulável aqui; limitada a 8 segundos |
A etiqueta da caixa colocada no plano é Odoo Contact. O texto de ajuda mostrado na janela é: «Procura o contacto Odoo correspondente ao número de quem liga (res.partner) e expõe {{odoo_found}}, {{odoo_partner_name}}, {{odoo_partner_id}}, {{odoo_user_id}}, {{odoo_user_name}}, {{odoo_user_extension}} (a extensão do comercial, vazia se não tiver nenhuma). Saídas: Encontrado / Não encontrado / Erro. Se o Odoo estiver inacessível, a chamada continua (fail-open).»
Como funciona
A procura
O módulo procura, entre os contactos do Odoo, aquele cujo número de telefone corresponde a quem liga. Tenta várias escritas do mesmo número, porque quem liga pode chegar em +32…, em 0032… ou em 0… consoante a operadora, e completa com uma comparação sobre os últimos nove algarismos significativos. O primeiro contacto correspondente é retido.
Lê então o seu nome e o seu comercial, depois vai buscar a extensão desse comercial à sua ficha Odoo. Um comercial sem extensão indicada deixa este último valor vazio.
As seis variáveis
| Variável | O que contém |
|---|---|
odoo_found | 1 se foi encontrado um contacto, 0 caso contrário |
odoo_partner_name | o nome do contacto |
odoo_partner_id | o seu identificador no Odoo |
odoo_user_id | o identificador do seu comercial |
odoo_user_name | o nome do seu comercial |
odoo_user_extension | a extensão desse comercial, vazia se não tiver nenhuma |
Estão sempre definidas, mesmo depois de uma falha: nesse caso odoo_found vale 0 e as restantes ficam vazias. Podem, portanto, ser testadas a jusante sem receio da ausência de valor.
{{odoo_user_extension}} liga-se diretamente a um módulo Chamar: quem liga cai no comercial que acompanha o seu processo, sem que seja preciso manter uma correspondência manual.
A mudança de nome
A caixa Mudar o nome de quem liga para o nome do contacto encontrado substitui o nome exibido de quem liga pelo do contacto. O colega lê o nome do cliente no ecrã do telefone, antes mesmo de atender. Está marcada por predefinição.
Este módulo nunca bloqueia a chamada
É o ponto mais importante, e o menos conhecido. Este módulo enriquece a chamada, não decide o seu destino. Aconteça o que acontecer, Odoo avariado, credenciais expiradas, instância suspensa, a chamada continua.
Para isso, o módulo segue pela primeira saída ligada, segundo uma ordem de preferência: primeiro o ramo certo, depois os outros como recurso. Três consequências, todas úteis:
- Ligar apenas a saída Encontrado basta para o plano funcionar. Todas as chamadas passarão por ali, encontradas ou não.
- Uma saída que não esteja ligada nunca corta a chamada, ao contrário da regra geral dos outros módulos.
- A saída Erro pode, portanto, nunca ser utilizada, se não estiver ligada.
O que preencher
| Campo | O que é esperado | Se o deixar vazio |
|---|---|---|
| Instância Odoo | o Odoo a consultar, entre os declarados em Integrações, Odoo | Instância predefinida, ou seja, a instância de resolução declarada para a instalação |
| Número a procurar | o número, em geral {{caller}}; outra variável é aceite | {{caller}} |
| Mudar o nome de quem liga para o nome do contacto encontrado | marcada, o nome do contacto é exibido no telefone chamado | desmarcada, o nome transmitido pela operadora é conservado |
Passo a passo
- Verifique primeiro que o Odoo está ligado, em Integrações, Odoo, e que a instância está ativa aí.
- Coloque o módulo Odoo, resolução de contacto e ligue o nó anterior à sua entrada.
- Abra-o e escolha a Instância Odoo, ou deixe a instância predefinida se houver apenas uma.
- Deixe
{{caller}}em Número a procurar, a menos que se pretenda procurar um número obtido de outra forma, por exemplo por uma Introdução DTMF. - Decida sobre a mudança de nome. Deixe a caixa marcada se as equipas atendem em extensões que exibem o nome.
- Clique em Guardar.
- Ligue, no mínimo, a saída Encontrado. Ligue também Não encontrado e Erro no dia em que quiser tratá-las de forma diferente.
- Coloque um módulo Depuração logo a seguir, com a mensagem
found={{odoo_found}} nome={{odoo_partner_name}} extensao={{odoo_user_extension}}. - Clique em Guardar, depois em Aplicar as alterações na faixa superior.
- Ligue a partir de um número que conste no Odoo, depois abra o Registo de depuração do plano e verifique o nome encontrado.
Se não funcionar
Todas as chamadas seguem para Não encontrado. O número de quem liga não corresponde a nenhum contacto. Abra a ficha do contacto no Odoo e verifique que o telefone está indicado, depois compare a sua escrita com o valor de {{caller}} lido no Registo de depuração. Um contacto sem número nunca será encontrado, seja qual for a qualidade da sua ficha.
O nome não aparece no telefone do colega. Verifique a caixa Mudar o nome de quem liga para o nome do contacto encontrado no módulo. Verifique depois que o contacto encontrado tem mesmo um nome, e que a extensão chamada exibe o nome e não só o número.
As chamadas continuam a ser encaminhadas mesmo com o Odoo avariado. É o comportamento esperado. Este módulo nunca é bloqueante: segue pela primeira saída ligada e a chamada continua. As seis variáveis ficam então vazias, e {{odoo_found}} vale 0.
A saída Erro nunca é utilizada. Pela mesma razão. Se Erro não estiver ligada, o módulo recorre a outra saída ligada em vez de cortar a chamada. Ligue Erro se quiser vê-la funcionar.
{{odoo_user_extension}} está sempre vazia. Dois casos. O contacto não tem comercial atribuído no Odoo, e {{odoo_user_name}} fica então vazia também. Ou então o comercial não tem extensão indicada na sua ficha Odoo, e é preciso completá-la lá.
Como se constrói o plano de chamadas, explicado em imagens
Ver a página Planos de numeração