Como gerenciar variáveis de assinantes de chatbots
Com o uso de variáveis, você pode organizar e armazenar todas as informações necessárias sobre seus assinantes, incluindo pedidos e preferências. Isso permite personalizar as interações com cada assinante ou segmentar grupos com base em critérios específicos de filtragem.
Neste artigo, explicamos como criar e gerenciar variáveis do público.
Como criar uma variável
Você pode criar uma variável na audiência sem valor, adicionar uma variável já com valor ou atualizar o valor de uma variável existente para todos os contatos ou apenas um contato específico.
A funcionalidade de adição de variáveis é a mesma para todos os aplicativos de mensagem. As variáveis são criadas para todos os contatos da lista "Público".
| Manualmente, via Público | Acesse a aba Público e clique em Criar variável no lado direito. Insira o nome e o tipo da variável e clique em Criar. Saiba mais: Como criar uma variável no público de um chatbot. |
| Você também pode criar uma variável no modo de edição de fluxo, permitindo que o valor seja adicionado automaticamente para cada contato que passar por aquele elemento do fluxo. | |
| Manualmente, usando o elemento Mensagem: Entrada do usuário no fluxo. | Acesse o modo de edição de fluxo e adicione o elemento Mensagem. Ative a opção Aguardar resposta do assinante. Ao lado da opção Salvar resposta em uma variável, clique em Criar variável.
Observe que, neste elemento, só é possível criar variáveis do tipo |
| Manualmente, usando o elemento Ação: Definir variável no fluxo | Acesse o modo de edição de fluxo e adicione um elemento Ação. Selecione a ação Definir variável e clique em Criar variável. Insira o nome e o tipo da variável. |
| Manualmente, usando o elemento Solicitação de API no fluxo | Acesse o modo de edição de fluxo e adicione o elemento Solicitação de API. Insira os dados da solicitação e clique em Validar solicitação. Ao lado da opção Campo de resposta, clique em Criar variável e insira o nome e o tipo da variável. |
Como editar o nome da variável
Acesse a aba Público e encontre a variável que deseja editar. Clique no ícone Editar, apague o texto, digite o novo nome (com até 64 caracteres) e clique em Enter key para salvar.
O nome da variável não pode ter mais de 64 caracteres.
Essa alteração será aplicada a todos os assinantes do chatbot. Caso tenha usado essa variável em fluxos de chatbot ou campanhas programadas, será necessário atualizá-la manualmente nesses lugares.
Adicionar ou atualizar o valor de uma variável
Antes de definir um valor para sua variável, confira o tipo da variável, pois cada um tem um limite de caracteres diferente. Você pode definir os valores manualmente, via API ou configurá-los para serem adicionados automaticamente. O valor máximo permitido para uma variável é 1.024 caracteres.
| Manualmente, via Público (para um contato específico) | Acesse a aba Público, localize o contato desejado e clique no campo correspondente à variável. Insira o novo valor e clique em Enter para salvar. |
| Manualmente, via Público (para uma lista de contatos) | Na aba Público, selecione os contatos que deseja atualizar, clique em Definir variável, escolha a variável e insira o novo valor. |
| Manualmente, no chat com um assinante | Acesse a aba Conversas e clique no contato desejado. No painel à direita, ao lado da variável correspondente, insira o novo valor. |
| Coletar variáveis na inscrição via widget | Se quiser armazenar variáveis adicionais quando um usuário se inscrever via widget, você pode adicionar um script ao código-fonte do seu site.
Copie o código e cole-o ao lado do script do widget de inscrição. Os valores só podem ser adicionados a variáveis que já foram criadas. Caso tente enviar dados para uma variável inexistente, eles serão ignorados. |
| Definir valor de variável via API | Esse método é utilizado para criar integrações externas.
Envie uma solicitação POST para: No cabeçalho da solicitação, adicione o token de autorização. No corpo da solicitação, inclua o ID do contato, o nome ou ID da variável para a qual deseja adicionar um novo valor e o próprio valor. Para cada rede social, substitua o endpoint da solicitação por:
|
| No modo de edição de fluxo, você pode configurar a atualização automática de valores de variável para cada contato que passar por um determinado elemento do fluxo. | |
| Elemento Mensagem: Entrada do usuário | No modo de edição de fluxo, adicione o elemento Mensagem. Ative a opção Aguardar resposta do assinante e, ao lado de Salvar resposta em uma variável, selecione a variável onde deseja armazenar os dados fornecidos pelo usuário. |
| Elemento Ação: Definir variável | No modo de edição de fluxo, adicione o elemento Ação. Selecione a opção Adicionar variável e escolha a variável que deseja atualizar.
Observe que, diferentemente de outros elementos, a ação Definir variável sempre atribui o mesmo valor para todos os contatos. Também é possível definir valores dinâmicos para variáveis numéricas. Para somar ou subtrair um valor, insira +1 ou -1. Se a variável ainda não tiver um valor definido, o sistema iniciará a contagem a partir de zero ou da data atual. |
| Elemento Solicitação de API | No modo de edição de fluxo, adicione o elemento Solicitação de API. Insira os dados da solicitação e clique em Validar solicitação. Na seção Configuração de correspondência, ao lado da opção Campo de resposta, selecione a variável onde deseja armazenar o valor recebido do usuário. |
Excluir o valor de uma variável
Você pode excluir uma variável no público ou diretamente no chat com um assinante.
Acesse a aba Público e, ao lado do contato desejado, clique no valor da variável que deseja excluir. Selecione o conteúdo da célula, clique em Delete e depois em Enter.
Acesse a aba Conversas, clique no contato desejado e, no painel à direita, localize a variável correspondente. Selecione seu valor, clique em Delete e depois em Enter.
Remover uma variável
Se você excluir uma variável do público, o valor dela será apagado para todos os assinantes e não poderá ser recuperado.
Para remover uma variável, vá até a aba Público, passe o mouse sobre a coluna da variável que deseja excluir e clique no ícone Excluir.
Se não encontrar a variável que está procurando, pode ser que ela esteja oculta. Clique nos três pontos ao lado do nome da variável e selecione quais deseja exibir.
Última Atualização: 23.09.2025
ou