Leitura de 4 minutos Atualizada: 28/01/2026 Criado pela: Equipe Botmaker

Principais variáveis

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



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




Lembre-se de visitar nossa Central de Ajuda para obter mais informações.