No bot do CXM de Atendimento PipeRun é possível utilizar uma ação chamada "Guarda Variável". Esta ação é capaz de armazenar informações coletadas pelo bot ao longo da sua jornada.
As informações armazenadas na ação de guardar variável podem ser utilizadas em diversas ações subsequentes, como o envio de mensagens personalizadas.
Este artigo apresenta um caso prático para demonstrar a configuração e o uso da ação "Guarda Variável" em conjunto com outras funcionalidades.
TÓPICOS DO ARTIGO
- Caso de uso para a ação guarda variável
- Como adicionar a ação para perguntar o nome
- Como configurar a ação guarda variável
- Como adicionar uma pergunta para o telefone
- Como guardar telefone informado
- Como utilizar as variáveis armazenadas
- Perguntas frequentes
CASO DE USO PARA A AÇÃO GUARDA VARIÁVEL
Contexto: Será construído um fluxo de bot que pergunta o nome e o telefone do cliente. Ao final da jornada será enviada uma mensagem para o cliente confirmando as informações coletadas, e a seguir o atendimento será encaminhado para um atendente.
O diagrama deste fluxo ficará assim:

Acompanhe o processo de criação deste fluxo:
COMO ADICIONAR UMA AÇÃO PRA PERGUNTAR O NOME
1. No Painel administrativo, clique em "Cadastros" (1), a seguir clique em "Bot's" (2) e após, clique em "Cadastro" (3).

2. Na tela de Cadastro de bot clique em "Adicionar".

3. Configure as propriedades do novo bot que está sendo criado.

Para saber mais sobre como realizar estas configurações acesse este artigo.
4. Crie um contexto chamado "Pergunta nome" e o arraste para tela do construtor.

5. Conecte ao contexto uma ação de enviar pergunta.

6. Clique na ação enviar pergunta, configure o texto da mensagem e após, clique em "Gravar Alterações".

7. Conecte na ação "enviar pergunta" uma reação do tipo "entrada esperada". Após, configure as propriedades desta entrada esperada informando o tipo de resposta esperada "qualquer resposta".

Para saber mais sobre como configurar uma pergunta acesse este artigo.
COMO CONFIGURAR A AÇÃO GUARDA VARIÁVEL
Para que ao final do fluxo seja enviado uma mensagem para o cliente informando seu nome completo precisaremos utilizar uma ação chamada guarda variável.
Esta ação irá armazenar o nome do cliente para que, mais a frente do fluxo, possamos enviar uma mensagem com as informações coletadas durante a jornada de atendimento do bot.
A ação guarda variável é uma ação do tipo passiva que só pode ser conectada em contextos, deste modo, será necessário criar um novo contexto chamado "guardar nome".
Para saber mais sobre o que são as ações passivas acesse este artigo.
1. Crie um contexto chamado "guardar nome" e conecte à entrada esperada.

2. Localize na aba de ações a ação "guarda variável" e conecte ao contexto criado.

3. Clique na ação "guarda variável" para configurar as propriedades.

- Nome da variável (1): defina o nome da variável, sempre iniciando com um "@";
- Valor da variável (2): se este campo não estiver preenchido a variável vai armazenar a última mensagem recebida. No nosso caso de uso a ultima mensagem recebida foi a resposta para a pergunta "Nome completo".
Ao finalizar as configurações clique em "Gravar alterações (3)".
COMO ADICIONAR UMA PERGUNTA PARA O TELEFONE
Crie um novo contexto para realizar a ação enviar pergunta para solicitar ao cliente que informe seu número de telefone.
Como o contexto atual vai ser alterado, é necessário usar uma ação chamada Novo contexto, para conectarmos ao fluxo.
Dica: a ação novo contexto é uma ação do tipo passiva que apenas altera o contexto atual e sem executar nenhuma outra ação. Para saber mais sobre os tipos de ações acesse este artigo.
1. Conecte a ação "novo contexto" ao lado da ação "guarda variável" e a seguir crie o contexto "Pergunta telefone" e conecte com a ação "novo contexto".

2. Conecte ao contexto a ação "enviar pergunta" e faça as configurações clicando na ação.

3. Conecte e configure uma entrada esperada para a pergunta telefone. O tipo de resposta esperada será qualquer telefone válido com DDD.

Para saber mais sobre como configurar uma pergunta acesse este artigo.
4. Crie um contexto chamado "guardar telefone" e conecte com a entrada esperada.

COMO GUARDAR O TELEFONE INFORMADO
Para armazenar o telefone informado vamos utilizar novamente a ação "guarda variável".
1. Conecte a ação "guarda variável" ao contexto "guardar telefone".

2. Clique na ação "guarda variável" para fazer as configurações.

- Nome da variável (1): defina o nome da variável, sempre iniciando com um "@". No exemplo chamamos a variável de @telefone;
- Valor da variável (2): se este campo não estiver preenchido a variável vai armazenar a ultima mensagem recebida. No nosso caso de uso a última mensagem recebida foi a resposta para a pergunta "Informe seu telefone de contato".
Ao finalizar as configurações clique em "Gravar alterações (3)".
COMO UTILIAR AS VARIÁVEIS ARMAZENADAS
Depois de criarmos as duas variáveis @nomecompleto e @telefone, será enviada uma mensagem para o cliente contendo o valor das duas variáveis criadas.
1. Insira ao lado da ação "guarda variável" a ação "enviar mensagem".

2. Configure o texto da mensagem que será enviada.

Observe que ao compor a mensagem estamos usado as duas variáveis criadas @nomecompleto e @telefone.
Ao finalizar as configurações clique em "Gravar alterações".
3. Para finalizar o fluxo, vamos conectar ao lado da ação enviar mensagem a ação encaminhar para fila humana.

Pronto! Agora você já sabe como configurar a ação guarda variável e como utilizá-la no fluxo do bot.
PERGUNTAS FREQUENTES
"Para coletar o telefone do cliente é sempre necessário fazer uma pergunta para que ele digite o seu telefone?"
R: Se você estiver criando um bot para o canal de WhatsApp, o CXM de Atendimento PipeRun captura o telefone do cliente de forma automática e adiciona nas variáveis @cliente->whatsappPrincipal->ddd e @cliente->whatsappPrincipal->numero, não sendo necessário fazer a pergunta.
Caso esteja criando um bot para outros canais de atendimento, é necessário perguntar o telefone do cliente e utilizar a ação guarda variável.
Em caso de dúvidas, chame nossa equipe no chat. 😉