No Criador de fluxos, uma variável é um contêiner de dados relacionados com uma conversa, como o nome do cliente ou a ID de pedido de uma loja. Durante uma conversa, um bot de mensagens pode usar variáveis para enviar mensagens personalizadas, exibir informações dinâmicas ou alterar o fluxo da conversa.
Sobre nomes e valores de uma variável
No Criador de fluxos, cada variável possui um nome e um valor. Ao configurar uma etapa em um fluxo de resposta, o nome atua como placeholder para o valor. Ao executar o fluxo, o bot substitui o nome pelo valor da variável. Por exemplo, você pode usar uma variável com o nome E-mail para o endereço de e-mail do cliente.
Tratamento de variáveis vazias
Uma variável fica vazia se não tiver um valor. Os bots de mensagens ignoram variáveis vazias durante uma conversa.
Por exemplo, uma etapa Enviar mensagem inclui uma mensagem do bot “O status de envio do seu pacote é shipping_status”. Se a variável shipping_status estiver vazia durante uma conversa, o bot enviará “O status de envio do seu pacote é “.
Mensagem do bot | Visualização do cliente |
---|---|
Sobre tipos de variáveis
Variáveis do cliente
As variáveis do cliente armazenam informações fornecidas por um cliente em uma etapa Peça detalhes. Por exemplo, a etapa pode pedir a um cliente que forneça o nome e o endereço de e-mail.
Ao inserir uma variável em uma etapa usando o ícone Adicionar variável (), as variáveis do cliente são exibidas em Respostas do cliente.
Variáveis de serviço externo
As variáveis de serviço externo armazenam dados recebidos de um sistema externo durante uma etapa Fazer chamada de API. Por exemplo, a etapa pode fazer uma solicitação REST API para que uma transportadora saiba o status atual de um pacote.
Os administradores criam variáveis de serviço externo quando a etapa Fazer chamada de API é configurada. Como parte da configuração, o administrador pode definir um nome personalizado para cada variável.
Ao inserir uma variável em uma etapa usando o ícone Adicionar variável (), as variáveis de serviço externo são exibidas em Respostas do serviço externo.
Variáveis de metadados de mensagens
Variáveis de metadados de mensagens contêm informações sobre a identidade e o status de autenticação do cliente. As variáveis de metadados de mensagens obtêm seus valores de Tokens da web JSON (JWTs) usados para a autenticação de mensagens.
As variáveis de metadados de mensagens não são ativadas por padrão e estão disponíveis somente para canais do Web Widget e do SDK para dispositivos móveis. Para obter mais informações sobre como ativar e usar variáveis de metadados de mensagens, consulte Uso de metadados de autenticação na resposta de um bot.
Se forem ativadas, as variáveis de metadados de mensagens serão exibidas em Metadados de mensagens quando uma variável é inserida em uma etapa usando o ícone Adicionar variável ().
Uso de variáveis em uma etapa de fluxo de resposta
Personalização de mensagens do bot
Envio de dados para sistemas externos
Ao fazer uma chamada REST API para um sistema externo usando a etapa Fazer chamada de API, os administradores podem inserir variáveis no caminho e na cadeia de caracteres de consulta do campo da URL do ponto de extremidade da etapa. Para obter mais informações, consulte Uso da etapa Fazer chamada de API no Criador de fluxos.
Ramificação de um fluxo de resposta
A etapa Ramificar por condição permite que um administrador ramifique o fluxo de uma conversa com base no valor de pelo menos uma variável. Para obter mais informações, consulte Noções básicas sobre condições de ramificação.