Variável
Memoriza um valor sob um nome, para o reutilizar mais adiante no plano escrevendo esse nome entre chavetas duplas. É a base dos módulos avançados.
Em resumo
| Saídas | uma única, sem rótulo |
| Campos | Nome, Tipo, depois Valor ou Elementos (um por linha) |
| Tipos propostos | Texto e Tabela, Texto por predefinição |
| Variáveis disponíveis de origem | 8, sem nada a configurar |
| Tempo de vida | a chamada em curso, e só ela |
| Maiúsculas no nome | sem importância: {{DATETIME}} e {{datetime}} designam a mesma coisa |
O texto de ajuda mostrado na janela é: «Define uma variável, reutilizável via {{nome}} nos outros módulos.»
Como funciona
O que é uma variável
Uma variável é uma etiqueta colada num valor. Dá-se-lhe um nome, por exemplo idioma, e um valor, por exemplo pt. Em qualquer outro lugar do plano, escrever {{idioma}} equivale a escrever pt.
O interesse não está em poupar escrita: está em o valor poder mudar de uma chamada para outra. O número de quem liga, o que marcou no teclado, o nome encontrado no Odoo são variáveis. Constrói-se um plano único que se comporta de forma diferente consoante o que descobre pelo caminho.
Uma variável vive o tempo de uma chamada. Duas chamadas simultâneas têm cada uma as suas, sem se atrapalharem, e nada é conservado de uma chamada para a seguinte.
Onde a escrever
Em qualquer lugar onde um campo aceite texto: o URL e o corpo de um Pedido de API, os Args de um Pedido Odoo, o destinatário e o texto de uma Notificação, o texto de um Caller ID, os operandos de uma Condição (Se), a expressão de um Switch / Case, a mensagem de uma Depuração, o destino de um Chamar. O campo Valor deste módulo também a aceita: uma variável pode construir-se a partir de outra.
Um nome desconhecido não é assinalado: é substituído por vazio, sem o menor aviso. É a explicação mais frequente para uma mensagem que chega a meio.
As variáveis disponíveis sem nada configurar
| Nome | O que contém |
|---|---|
caller | o número de quem liga, tal como é transmitido |
caller_name | o nome de quem liga, quando a operadora o transmite |
callee | o número marcado dentro da instalação |
did | o número de chamada que recebeu a ligação |
tenant | o nome curto da instalação |
domain | o domínio SIP da instalação |
datetime | a data e a hora, no fuso horário da instalação |
datetime_utc | a mesma data e hora, em tempo universal |
Somam-se a estas, ao longo do plano: as que se definem com este módulo, a de uma Introdução DTMF, as seis de Odoo, resolução de contacto, e as extrações de um Pedido de API ou de um Pedido Odoo.
Uma nona variável, caller_e164, contém as escritas possíveis do número de quem liga. Serve o filtro de um Pedido Odoo e não tem grande utilidade noutro lugar.
O que preencher
| Campo | O que é esperado | Se o deixar vazio |
|---|---|---|
| Nome | um nome curto, em letras sem acento, algarismos e travessão baixo | a variável não é criada, o módulo não faz nada e a chamada segue o seu caminho |
| Tipo | Texto para um valor único, Tabela para uma lista | Texto |
| Valor | o conteúdo, que pode ele próprio conter {{outra}} | a variável existe, com um valor vazio |
| Elementos (um por linha) | um valor por linha, em Tabela | a lista fica vazia; as linhas em branco são ignoradas |
Passo a passo
- Coloque o módulo Variável e ligue o nó anterior à sua entrada.
- Abra-o e indique o Nome, por exemplo
idioma. Guarde-o tal como está, será útil noutro lugar. - Escolha o Tipo. Texto na grande maioria dos casos; Tabela se quiser uma lista a testar mais adiante com o operador «está em (tabela)» de uma Condição (Se).
- Preencha o Valor, ou os Elementos um por linha.
- Clique em Guardar.
- Ligue a saída do módulo à continuação do plano: uma saída que não leva a lado nenhum desliga a chamada.
- Mais adiante no plano, insira
{{idioma}}onde for necessário, de preferência copiando-o do painel Variáveis disponíveis. - Coloque um módulo Depuração logo a seguir, com a mensagem
idioma={{idioma}}. Vai ler-se o valor real em vez de o supor. - Clique em Guardar, depois em Aplicar as alterações na faixa superior.
- Ligue para o número, depois abra o Registo de depuração do plano e verifique o valor escrito.
Se não funcionar
A minha variável aparece vazia mais adiante no plano. Duas causas, por esta ordem. A chamada não passou pelo módulo que a define, porque seguiu outro ramo. Ou o nome escrito entre chavetas não corresponde ao do módulo, por uma letra. Um nome desconhecido é substituído por vazio, sem erro.
Pus um acento ou um hífen no nome, e nada sai. Só letras sem acento, algarismos e travessão baixo são reconhecidos. Mude o nome da variável, depois corrija todos os lugares que a utilizam.
A minha lista aparece numa única linha, separada por vírgulas. É o comportamento esperado: uma Tabela inserida num texto é apresentada com vírgulas. Uma tabela serve para ser testada, com o operador «está em (tabela)» de uma Condição (Se), mais do que para ser exibida.
A chamada é cortada logo depois do módulo. A sua saída única não está ligada a nada. Um módulo cuja saída acionada não leva a lado nenhum termina a chamada.
O valor está correto no ecrã mas não ao telefone. O plano guardado ainda não está em serviço. Clique em Aplicar as alterações na faixa superior, depois ligue de novo.
Como se constrói o plano de chamadas, explicado em imagens
Ver a página Planos de numeração