Nó de IVR: Definir variável

O nó Definir variável (SetVariable) salva um texto — literal ou com partes dinâmicas — no contexto de execução da chamada, para que um nó posterior (Bifurcar, Condição, ou outro) tome uma decisão com base nesse valor. Ele não reproduz áudio nem pausa a chamada.

Requisitos

• Nenhum especial; está disponível no Editor de IVR de qualquer canal de chamadas.

Configuração

• Nome da variável: o identificador pelo qual outros nós vão ler o valor (por exemplo caller_segment).
• Valor (literal ou ${...}): texto fixo, ou um modelo com variáveis dinâmicas. Este nó resolve um conjunto limitado de acessores: ${contact.id}, ${contact.name}, ${contact.phone}, ${contact.email}, ${caller.number}, ${locale}, ${wacid}, ou qualquer variável salva antes com outro nó Definir variável. Ele não compartilha o resolvedor estendido (${channel.*}, ${now.*}, etc.) usado por outros nós, como Solicitação HTTP, Notificar agente ou Evento analítico.

Exemplo

Um nó Definir variável chamado caller_email com valor ${contact.email} salva o e-mail do contato para uso posterior — por exemplo, no corpo de uma Solicitação HTTP ou de uma notificação. Um nó Condição mais adiante pode avaliar caller_email != '' para decidir se o chamador tem dados de contato completos antes de encaminhá-lo para um fluxo ou outro.

Dicas

• Use para "pré-calcular" um valor uma única vez e reaproveitá-lo em várias condições depois, em vez de repetir a mesma expressão longa em cada nó.
• Tokens que não correspondem a nenhuma variável conhecida ficam como texto literal (por exemplo, ${variavel_com_erro} é salvo assim mesmo), o que ajuda a detectar erros de digitação no rastreamento de execução. Isso também vale para acessores que este nó específico não suporta, como ${contact.tags[0]}: mesmo que "tags" exista como conceito de contato em outras partes do Omnifox, este nó não o resolve, e o token fica literal.

Solução de problemas

Se um nó posterior não encontra o valor esperado, verifique se o nome da variável coincide exatamente (sensível a maiúsculas/minúsculas) entre o nó Definir variável e o nó que a lê. Se o valor sair vazio ou aparecer como o texto literal ${...}, confirme se você está usando um dos acessores suportados (contact.id, contact.name, contact.phone, contact.email, caller.number, locale, wacid) e se o contato realmente tem esse dado carregado para aquele chamador.