Como gerenciar assinantes do chatbot e seus dados

Com o uso de variáveis e tags, 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 e tags do público.

Como gerenciar variáveis

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.

Como criar uma variável

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 String.

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: https://api.sendpulse.com/messenger/contacts/setVariable.

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:

messenger, telegram, instagram.

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.

Como gerenciar tags

As tags permitem segmentar e organizar seus assinantes. Cada tag pode ter um valor de até 32 caracteres e é usada para filtrar contatos e personalizar suas interações. Saiba mais em: Como atribuir tags a assinantes de chatbots.

Como atribuir uma tag

Manualmente, via Público (para um único contato) Acesse a aba Público, vá até a coluna Tags, clique no campo ao lado do contato desejado e insira a tag.
Manualmente, via Público (para uma lista de contatos) Acesse a aba Público, selecione os contatos que deseja atualizar, clique em Adicionar tag e insira o valor da tag.
Manualmente, no chat com um assinante Acesse Conversas, clique no contato desejado e, no painel direito, no campo Especificar tag, insira o valor da tag.
Automaticamente, usando o elemento Ação: Adicionar Tag É possível configurar uma tag para ser atribuída automaticamente a cada contato que passar por um determinado elemento do fluxo.

Acesse o modo de edição de fluxo, adicione o elemento Ação, selecione Adicionar tag e insira o valor da tag.

Método de API: Adicionar tag a um contato Usado para criar integrações externas.

Envie uma solicitação POST para: https://api.sendpulse.com/messenger/contacts/setTag.

No cabeçalho da solicitação, adicione o token de autorização. No corpo da solicitação, inclua o ID do contato e a tag.

Substitua o endpoint da solicitação conforme a rede social desejada:

messenger, telegram, instagram, whatsapp, livechat.

Editar uma tag

Para editar o nome de uma tag, acesse Configurações do bot > Tags, clique no ícone de lápis e altere o nome.

Essas mudanças serão aplicadas a todos os assinantes do chatbot. Se você usou essa tag em fluxos de chatbot ou campanhas programadas, será necessário atualizá-la manualmente.

Excluir uma tag

Você pode excluir uma tag no público, em um chat com um assinante ou via API de exclusão de tag de contato.

Acesse a aba Público, passe o mouse sobre a tag que deseja remover ao lado do contato e clique no ícone de exclusão.

Vá até a aba Conversas, clique no contato desejado e, no campo de tags, passe o mouse sobre a tag que quer remover e clique no ícone de exclusão.

Se quiser excluir uma tag de todos os assinantes, vá até Configurações do bot > Tags e clique no ícone da lixeira ao lado da tag.

    Rate this article about "Como gerenciar assinantes do chatbot e seus dados"

    User Rating: 5 / 5 (5)

    Anterior

    Como gerenciar conversas de chatbot

    Próximo

    Como atribuir tags a assinantes do chatbot

    Popular em nosso blog

    Crie seu chatbot hoje mesmo