Campos personalizados, campos do sistema e entrada do usuário

Campos de usuário personalizados ou CUFs

1. O que são campos personalizados?

Na NexTags, os campos são cruciais para criar interações de chatbot personalizadas e eficazes. Os Campos de Usuário Personalizados (CUFs) podem ser considerados a memória permanente do seu chatbot, permitindo que ele armazene e recupere detalhes importantes do usuário em várias conversas. Isso é diferente do {{chat_history}}, que rastreia apenas mensagens em uma única sessão. Com os CUFs, seu chatbot pode lembrar as preferências do usuário, ações passadas ou informações importantes para interações futuras, tornando as conversas mais envolventes e uma experiência melhor.

Devido ao grande número de CUFs disponíveis na plataforma, nem todos estão listados em todos os menus suspensos. No entanto, todos os CUFs mencionados neste documento funcionarão perfeitamente onde quer que você os use em seus fluxos de chatbot.

A Nextags oferece três tipos principais de campos para gerenciar e armazenar dados:

• Os campos do sistema coletam automaticamente informações importantes do usuário, como nome, sobrenome e e-mail, permitindo fácil personalização.

• Os campos da conta são usados ​​para armazenar configurações e preferências específicas do bot, ajudando a garantir que o chatbot funcione sem problemas em diferentes cenários.

• Campos de usuário personalizados (CUFs) permitem que você armazene detalhes exclusivos do usuário, tornando as interações mais pessoais e relevantes.

Para determinados campos, como {{last_input}}, você pode precisar criar um novo Campo de Usuário Personalizado (CUF) e usar a ação "Definir Campo Personalizado"{{last_input}} para atribuir seu valor. Isso é necessário porque campos como rastreiam dados em tempo real, como a mensagem mais recente do usuário. Ao definir esse valor em um CUF, você pode salvá-lo e reutilizá-lo durante a conversa. Essa flexibilidade permite que você personalize como seu chatbot processa dados, resultando em interações mais personalizadas e envolventes para seus usuários.

Os tipos de CUFs incluem:

Texto : serve para armazenar mensagens de texto simples e sequências de texto.

Número : contém valores numéricos.

Data : armazena datas específicas.

Data e hora : combina dados de data e hora.

Verdadeiro/Falso : Para dados binários (sim ou não).

Texto longo : Geralmente, os campos personalizados têm um limite de 10.000 caracteres. No entanto, esses campos de conta de texto longo podem conter até 16 milhões de caracteres, ideal para armazenar conteúdo longo, como seu prompt.

Os CUFs também podem ser combinados com outros CUFs para criar interações dinâmicas e flexíveis dentro do seu chatbot. É assim que fica a estrutura do campo personalizado dentro da plataforma, {{nome_do_campo_personalizado}}

2. Criando campos personalizados

1 - Entre na sua conta 2 - Clique em Fluxo 3 - Agora selecione a opção de Campos Personalizados

4 - Clique em Adicionar

5. Defina o Nome do campo , Tipo e adicione uma Descrição que melhor se adapte à sua função de campo personalizado.

1. Clique em continuar para salvar o campo personalizado

Gerenciamento de contatos e contas

Campo	Descrição

{{first_name}}	O primeiro nome do usuário, útil para criar mensagens personalizadas e amigáveis.

{{last_name}}	O sobrenome do usuário, usado para criar uma experiência personalizada mais formal.

{{full_name}}	Combina o primeiro nome e o sobrenome do usuário para uso completo em comunicações.

{{email}}	O endereço de e-mail do usuário, geralmente usado para follow-ups e notificações por e-mail.

{{phone}}	O número de telefone do usuário, frequentemente usado para campanhas de SMS ou chamadas de suporte.

{{user_country}}	O país do usuário, útil para serviços baseados em localização, ofertas ou mensagens específicas por região.

{{user_state}}	O estado ou região do usuário, relevante para interações ou ofertas localizadas.

{{user_city}}	A cidade do usuário, útil para mensagens ou promoções ultralocais personalizadas.

{{inbox_link}}	O link para a caixa de entrada na NexTags, permitindo que agentes ou administradores acessem diretamente as interações do usuário.

{{gender}}	O gênero do usuário, usado para mensagens personalizadas que podem ser específicas de gênero.

{{locale}}	O local completo do usuário (ex.: en_US), indicando preferências de idioma e região para comunicação.

{{locale2}}	Uma versão abreviada do local (ex.: en) para determinar apenas o idioma preferido do usuário.

{{username}}	O nome de usuário do Instagram do usuário, usado para interações sociais ou referência.

{{profile_pic}}	URL da foto de perfil do usuário, permitindo personalização visual mais rica.

{{timezone}}	O fuso horário do usuário, permitindo que o bot envie mensagens específicas para o horário e realize ações com base na hora local do usuário.

{{user_id}}	Um identificador exclusivo para o usuário no sistema NexTags, usado para rastreamento interno e interações com API.

{{subscribed_date}}	A data em que o usuário se inscreveu ou foi adicionado ao sistema, útil para calcular a duração do usuário ou campanhas baseadas em assinaturas.

{{fb_chat_link}}	Um link direto para a caixa de entrada do Facebook Messenger do usuário, facilitando o acesso a conversas em andamento.

{{me}}	Um link que permite aos usuários visualizar ou excluir seus dados para cumprir os regulamentos de GDPR, garantindo transparência e controle do usuário.

{{webchat}}	Um link de chat na web que pode ser compartilhado com os usuários, permitindo rastreamento e recuperação. Compatível com payloads e oferece casos de uso flexíveis.

{{user_code}}	Um código único atribuído ao usuário, frequentemente usado para rastreamento ou identificação em sistemas internos.

{{last_btt_title}}	O título do último botão clicado pelo usuário, útil para rastrear interações e preferências do usuário.

{{last_interaction}}	O timestamp da última interação do usuário com o chatbot, útil para follow-ups ou estratégias de engajamento.

{{last_order}}	Os detalhes do último pedido feito pelo usuário, particularmente relevante para bots de comércio eletrônico e transacionais.

{{last_seen}}	A última vez que o usuário foi visto interagindo com o chatbot, fornecendo insights sobre o engajamento do usuário.

{{last_text_input}}	A última mensagem de texto enviada pelo usuário ao chatbot, útil para analisar a entrada do usuário e fornecer respostas contextuais.

{{last_input}}	A última entrada (texto, imagem, vídeo, áudio ou arquivo) enviada pelo usuário ao chatbot, oferecendo insights sobre a atividade do usuário.

{{last_input_type}}	Especifica o tipo da última entrada fornecida pelo usuário (ex.: texto, imagem, vídeo), ajudando a categorizar interações.

{{consecutive_failed_reply}}	O número de respostas consecutivas com falha do chatbot, usado para lidar com erros ou acionar mensagens de fallback.

{{last_ref}}	Refere-se ao último ponto de entrada ou link de referência clicado pelo usuário, ajudando a rastrear fontes de usuários.

{{last_ad}}	O ID do último anúncio do Facebook que levou o usuário ao chatbot, usado para atribuição e rastreamento de marketing.

{{user_channel}}	Indica o principal canal de comunicação usado pelo usuário (ex.: Messenger, Webchat), ajudando a adaptar respostas à plataforma.

{{user_hash}}	Um valor único hash do usuário, oferecendo rastreamento seguro e identificação em várias plataformas.

{{user_tags}}	Uma lista de tags aplicadas ao usuário para segmentação, categorização ou direcionamento em campanhas.

{{user_external_id}}	ID de usuário externo usado para plataformas de terceiros, como Messenger ou Instagram.

{{user_source}}	Indica a origem do usuário (ex.: Anúncios, comentário no Facebook), útil para análise de marketing.

{{assigned_admin_name}}	O nome do administrador atribuído ao usuário, permitindo rastreamento de agentes ou atribuição de tarefas.

{{assigned_admin_id}}	O ID do administrador atribuído ao usuário, útil para gerenciar interações da equipe e responsabilidade.

{{current_user_time}}	A hora local atual do usuário, com base no fuso horário, útil para enviar mensagens ou notificações sensíveis ao tempo.

{{chat_history}}	Retorna as últimas 50 mensagens trocadas entre o usuário e o negócio, útil para revisão ou contexto.

{{chat_history_large}}	Retorna as últimas 200 mensagens trocadas entre o usuário e o negócio para uma revisão mais longa de conversas anteriores.

{{chat_history_details}}	Retorna as últimas 50 mensagens trocadas com os detalhes do remetente, ajudando a identificar o fluxo da conversa.

{{chat_history_details_large}}	Retorna as últimas 200 mensagens trocadas com detalhes do remetente, fornecendo um histórico estendido para análise mais profunda.

{{last_points}}	Contém a pontuação mais recente do questionário do usuário. Recomenda-se armazenar em um CUF específico após cada conclusão.

{{user_notes}}	Retorna todas as notas adicionadas ao perfil do usuário, incluindo feedback, interações anteriores e comentários para referência do agente.

{{last_user_note}}	Recupera a nota ou comentário mais recente adicionado ao perfil do usuário, fornecendo uma referência rápida à atividade mais recente.

{{last_call_recorded}}	Contém o link URL da gravação da chamada mais recente associada ao usuário, útil para revisar interações telefônicas. *Nota: Apenas o Twilio suporta esse recurso atualmente.

{{last_step}}	Armazena o ID do PASSO da última etapa executada em um fluxo publicado, permitindo rastrear o progresso do usuário no fluxo.

{{current_step}}	Contém o ID do PASSO atualmente ativo em um fluxo publicado, mostrando o passo que o usuário está interagindo no momento.

{{account_name}}	O nome da conta associada ao chatbot, geralmente usado para branding ou identificação.

{{account_id}}	O identificador único da conta, usado para rastreamento interno e integrações de sistemas.

{{account_image}}	A imagem de perfil associada à conta, útil para branding ou exibição de visuais específicos da conta.

{{api_key}}	A chave API associada à conta, usada para integrações e acesso a serviços externos.

Instagram

Campo	Descrição

{{ig_user_name}}	O nome de usuário do Instagram do usuário.

{{ig_followers}}	O total de seguidores da conta do Instagram do usuário.

{{ig_verified}}	Indica se a conta do Instagram do usuário é verificada (verdadeiro/falso).

{{ig_follow_business}}	Indica se o usuário segue a conta comercial no Instagram (verdadeiro/falso).

{{ig_business_follow_user}}	Indica se a conta comercial segue o usuário no Instagram (verdadeiro/falso).

{{last_story_id}}	O ID da última história do Instagram respondida pelo usuário.

{{last_fb_comment}}	O texto do comentário mais recente do usuário no Instagram (cross-platform para Instagram/Facebook).

{{last_post_id}}	O ID da última postagem comentada pelo usuário (cross-platform para Instagram/Facebook).

{{last_comment_id}}	O ID do comentário mais recente do usuário (cross-platform para Instagram/Facebook).

{{total_new_tagged}}	Número de usuários que não estão na sua lista de contatos e foram marcados no comentário. Funciona apenas no Facebook.

{{total_tagged}}	Número de usuários que não foram marcados no comentário. Funciona apenas no Facebook.

Facebook Messenger

Campo	Descrição

{{last_fb_comment}}	O texto do comentário mais recente do usuário no Facebook.

{{last_post_id}}	O ID da última postagem comentada pelo usuário.

{{last_comment_id}}	O ID do comentário mais recente do usuário.

{{page_user_name}}	O nome de usuário do usuário que interage via Facebook Messenger.

{{fb_chat_link}}	Um link direto para a caixa de entrada do Facebook Messenger do usuário, facilitando o acesso a conversas em andamento.

{{last_ad}}	O ID do último anúncio do Facebook que levou o usuário ao chatbot, usado para atribuição e rastreamento de marketing.

{{total_new_tagged}}	Número de usuários que não estão na sua lista de contatos e foram marcados no comentário. Funciona apenas no Facebook.

{{total_tagged}}	Número de usuários que não foram marcados no comentário. Funciona apenas no Facebook.

Localização

Campo	Descrição
{{last_latitude}}	A última latitude conhecida do usuário, disponível apenas se o usuário tiver compartilhado sua localização.
{{last_longitude}}	A última longitude conhecida do usuário, disponível apenas se o usuário tiver compartilhado sua localização.

Agendamentos

Campo	Descrição

{{booking_date}}	A data do agendamento marcado pelo usuário.

{{booking_link}}	O link para a confirmação ou detalhes do agendamento.

{{booking_id}}	O identificador único do agendamento do usuário.

{{booking_calendar}}	O calendário associado ao agendamento, frequentemente usado para visualizar ou gerenciar o agendamento.

Ecommerce (Catálogo META)

Campo	Descrição

{{cart_checkout_link}}	Link para a página de checkout do usuário para concluir a compra.

{{cart_last_item_name}}	Nome do último item adicionado ao carrinho do usuário.

{{cart_last_item_quantity}}	Quantidade do último item adicionado ao carrinho do usuário.

{{cart_num_items}}	Número total de itens no carrinho do usuário.

{{cart_other_fees}}	Taxas adicionais associadas ao carrinho do usuário (ex.: taxas de serviço).

{{cart_shipping_cost}}	Custo de envio dos itens no carrinho do usuário.

{{cart_subtotal}}	Subtotal do carrinho do usuário antes de impostos e taxas adicionais.

{{cart_total}}	Custo total do carrinho do usuário, incluindo todas as taxas e impostos.

{{shop_link}}	Link para a loja ou página de e-commerce.

{{money_symbol}}	Símbolo da moeda usada na transação (ex.: $, €, £).

{{order_coupon_code}}	Código do cupom aplicado ao pedido, se houver.

{{order_coupon_discount}}	Desconto aplicado ao pedido pelo código do cupom.

{{order_date_account_timezone}}	A data do pedido no fuso horário da conta do usuário.

{{order_date_timestamp}}	O timestamp exato de quando o pedido foi realizado.

{{order_date_utc}}	O horário UTC de quando o pedido foi realizado.

{{order_discount}}	Total de desconto aplicado ao pedido.

{{order_email}}	O endereço de e-mail associado ao pedido.

{{order_id}}	Identificador único para o pedido.

{{order_name}}	Nome completo da pessoa que realizou o pedido.

{{order_payment_method}}	Método de pagamento usado para o pedido (ex.: cartão de crédito, PayPal).

{{order_phone}}	Número de telefone associado ao pedido.

{{order_products}}	Lista de produtos incluídos no pedido.

{{order_shipping_type}}	Tipo de envio escolhido para o pedido (ex.: padrão, expresso).

{{order_shipping_address1}}	Primeira linha do endereço de envio do pedido.

{{order_shipping_address2}}	Segunda linha do endereço de envio (ex.: número do apartamento).

{{order_shipping_city}}	Cidade do endereço de envio do pedido.

{{order_shipping_cost}}	Custo de envio para o pedido.

{{order_shipping_state}}	Estado do endereço de envio do pedido.

{{order_shipping_zip}}	Código postal do endereço de envio do pedido.

{{order_shipping_country}}	País do endereço de envio do pedido.

{{order_shipping}}	Informações completas de envio do pedido.

{{order_status}}	Status atual do pedido (ex.: pendente, enviado, entregue).

{{order_subtotal}}	Subtotal do pedido antes de impostos e envio.

{{order_taxes}}	Total de impostos aplicados ao pedido.

{{order_total}}	Valor total do pedido, incluindo todas as taxas, impostos e envio.

{{product_name}}	Nome do produto, usado com gatilhos como “Produto Pedido” ou “Produto adicionado ao carrinho”.

{{product_quantity}}	Quantidade do produto, usada com gatilhos como “Produto Pedido” ou “Produto adicionado ao carrinho”.

{{product_id}}	Identificador único para o produto, usado com gatilhos como “Produto Pedido”, “Produto adicionado ao carrinho” ou “Produto removido do carrinho”.