Atualizada: 28/10/2024

Principais variáveis

Neste artigo, apresentamos as variáveis que utilizamos na plataforma com uma breve explicação de cada uma.


Neste artigo, apresentamos as variáveis que utilizamos na plataforma com uma breve explicação de cada uma.

Estimativa de leitura: 08 minutos


Principais variáveis:


Acesse a lista das variáveis principais, complementares e as disponíveis na plataforma para serem utilizadas conforme suas necessidades.


Principais Variáveis


  • chatPlatform: a plataforma na qual a conversa está ocorrendo. Pode ser "messenger", "webchat", "skype", etc.
  • isOpenNow: com valores verdadeiro ou falso, indica se o bot responderá durante o horário de atendimento ou não.
  • isSubscribed: com valores verdadeiro ou falso, indica se o usuário está inscrito para receber notificações.
  • isWebChatMobile: indica se o usuário está conversando pelo WebChat através de um celular.
  • lastBotSentence: última mensagem do bot.
  • lastSeen: última vez que o usuário foi visto.
  • lastUserSentence: última mensagem do usuário.
  • operatorConnectedQty: quantidade de agentes conectados.
  • ruleCountInSession: quantidade de intenções executadas na sessão.
  • thisWasLastIntentToRun: indica a última intenção que foi executada.


Outras variáveis pré-definidas:


  • agentSpoke: o agente falou.
  • agentSpokeLast: o último a falar foi o agente.
  • audioURL: URL de um áudio.
  • channelDisplayName: nome do canal.
  • chatChannelId: ID do canal.
  • country: país do usuário.
  • currentDay: dia atual.
  • currentHourMinutes: hora e minutos atuais.
  • currentMonth: mês atual.
  • currentYear: ano atual.
  • customerId: ID do usuário. Varia de acordo com o canal.
  • dayForBusiness: dia da semana para o projeto.
  • dayForUser: dia da semana para o usuário (se estiver escrevendo de um lugar com outro fuso horário).
  • fileURL: URL de um arquivo.
  • firstName: nome do usuário.
  • fullName: nome completo do usuário.
  • gender: gênero do usuário (valores: masculino ou feminino).
  • queueID: ID da fila de atendimento.
  • imageURL: URL de uma imagem.
  • ipAddress: endereço IP atual.
  • lastAgentToSpeak: quando o operador foi o último a falar.
  • lastIntentID: ID da última intenção que foi ativada durante a conversa.
  • lastName: sobrenome do usuário.
  • lastUserMessageID: ID da última mensagem do usuário.
  • messengerReferral: referência do messenger.
  • operatorID: ID do agente.
  • operatorName: nome do agente.
  • operatorQueueQty: quantidade de agentes na fila de atendimento.
  • platformContactId: ID do usuário no canal. Conjunto alfanumérico que representa o cliente exclusivamente, no contexto de um único bot. Exceto pelo WhatsApp, onde é a linha do WhatsApp do cliente.
  • queuePriority: prioridade na fila de atendimento.
  • random: número aleatório entre 0 e 1.
  • videoURL: URL de um vídeo.
  • webChatHostPageTittle: título da página web atual onde está ocorrendo o webchat (basicamente o nome da aba do navegador).


Outras variáveis da plataforma


  • EUPrivacyAffected: Afetado pela Política de Privacidade da União Europeia
  • actionCallerOperatorId: Agente que acionou a intenção
  • appleSessionStartGroup: Grupo referido pela Apple
  • appleSessionStartIntent: Intenção referida pela Apple
  • attachments: URLs de arquivos anexados
  • botId: ID do agente virtual
  • botmakerEnvironment: Ambiente de intenções
  • botmakerNotes: Notas
  • businessAddress: Endereço do usuário
  • businessId: ID do projeto
  • businessName: Nome do projeto
  • businessPhone: Telefone
  • channelWebId: ID do webchat
  • countryState: Estado ou Província do usuário
  • currentBotId: ID do bot atual
  • currentCodeAction: Ação de código atual
  • currentTopicName: Nome atual
  • dau: Usuário ativo hoje
  • encryptionConfig: ID da criptografia
  • facebookPSID: ID do escopo da página do FB
  • firstTimeUser: Primeira sessão do usuário
  • isSendingPush: Resposta disparada por um push
  • lang: Idioma do projeto
  • lastIntentName: Nome da última intenção em execução
  • lastLockTime: Data da última atribuição
  • lastMessageISOTime: Data da mensagem anterior
  • lastOperatorMessageISOTime: Data da última mensagem do operador
  • lastRuleBuilder: ID da última intenção
  • lastRuleItemId: ID da última ação da intenção
  • lastRuleQuestionIdFailed: ID da última pergunta que falhou
  • lastUserImageSentUrl: URL da última imagem enviada pelo usuário
  • lastUserMessageISOTime: Data da última mensagem do usuário
  • locale: Idioma do usuário
  • mau: Usuário ativo no mês
  • messageDate: Data da mensagem
  • messageTimeBusiness: Horário da mensagem para o projeto
  • messageTimeUser: Horário da mensagem para o usuário
  • messagesToUserAreBlocked: Usuário não deseja receber mensagens
  • messengerAdId: ID de publicidade do messenger
  • messengerLastCommentId: ID do último comentário
  • messengerSource: Fonte de referência do messenger
  • messengerType: Tipo de referência do messenger
  • mostRecentOperatorID: ID do agente mais recente
  • nps: NPS (pesquisa de satisfação)
  • operatorAlias: Alias do agente atribuído
  • operatorDefinedValue: Informações adicionais do agente
  • operatorEmail: Email do agente
  • operatorGroups: Grupos do agente
  • operatorId: ID do agente
  • originalSubject: Assunto original do e-mail
  • paymentOrderId: ID do pedido de pagamento
  • phoneCity: Cidade do telefone
  • previousUserSentence: Mensagem anterior do usuário
  • queueID: ID da fila de atendimento
  • realWhatsAppId: ID do usuário no WhatsApp
  • respondingToUserMessage: Disparado por uma mensagem do usuário
  • ruleRunInSession: A intenção foi executada na sessão
  • scheduledRule: ID da intenção programada
  • scheduledRuleTime: Data da intenção programada
  • timesOnlineToday Vezes online hoje
  • title: Título do e-mail
  • todayOpenHours: Horário de atendimento hoje
  • typification: Tipos
  • userHasTalked: O usuário falou
  • userIdOnBusiness: ID do usuário personalizado
  • wau: Usuário ativo na semana
  • webChatCountry: País de acordo com o IP atual
  • webChatHostDomain: Domínio da página atual
  • webChatHostHREF: HREF atual
  • webChatHostReferrer: Referência atual
  • webChatHostURI: URI atual
  • webChatHostURL: URL atual
  • webId: ID do webchat
  • zip: CEP do usuário
  • beforeLastIntentId: ID da penúltima intenção

Visite nosso Centro de Suporte para mais informações.


Escrito por Suporte Botmaker

Atualizado: 22/03/2024