...
TIP - Before the detailed introduction of each step, let's take a look at what is field(variable) in NicoChat. It might take you a moment but this is essential to know more about the system.
Field, aka variable, is a container to hold a value.
...
Classification
...
Description
...
system field and custom field
...
system field is created by the system with pre-defined variable name and type, while custom field is defined by yourself
...
bot field and user field
...
bot field is shared in the whole bot, while each user has his/her own set of user fields
...
text field, number field, boolean field, date field, datetime field and JSON field
...
see variable type
User Field
User field belongs to users. For example, each user has their own name and email address. So "name" and "email" are user fields.
Bot Field
Bot field belongs to the bot. For example, a restaurant bot holds an address and contact number of the restaurant. So "restaurant_address" and "restaurant_contact" should be created as bot fields. Because you don't want to manage different addresses or contacts of your restaurant for every user.
System Field
System field is created by the system with pre-defined variable name and variable type. There are system bot field and system user field:
Some system fields only exist in the specific channel. Check the table below for how to edit system field:
...
Field Name
...
Field
Type
...
Variable
Type
...
Description
...
How to Edit
...
User Ns
...
user field
...
text
...
user identification in NicoChat
...
non-editable
...
User Id*
...
user field
...
text
...
user identification from the channel
...
non-editable
...
First Name
...
user field
...
text
...
profile info
...
in Question Step/Action Step
...
Last Name
...
user field
...
text
...
profile info
...
in Question Step/Action Step
...
User Name
...
user field
...
text
...
profile info
...
in Action Step
...
Gender
...
user field
...
text
...
profile info
...
in Action Step
...
...
user field
...
text
...
profile info
...
in Question Step/Action Step
...
Phone
...
user field
...
text
...
profile info
...
in Question Step/Action Step
...
Profile Image
...
user field
...
text
...
profile info
...
in Question Step
...
Locale
...
user field
...
text
...
profile info
...
non-editable
...
Timezone
...
user field
...
text
...
profile info
...
non-editable
...
Language
...
user field
...
text
...
profile info
...
in Action Step
...
Subscribed
...
user field
...
datetime
...
subscribed time
...
non-editable
...
Last Text Input
...
user field
...
text
...
user's last input
...
edited by system
...
Last Interaction
...
user field
...
datetime
...
last action time
...
edited by system
...
Last Button Title
...
user field
...
text
...
last button pressed
...
edited by system
...
Flow Ns
...
bot field
...
text
...
flow(bot) identification in NicoChat
...
non-editable
...
Sub Flow Ns
...
bot field
...
text
...
sub flow identification in NicoChat
...
non-editable
...
Page Name
...
bot field
...
text
...
connected Facebook page name
...
non-editable
...
Page Id
...
bot field
...
text
...
connected Facebook page id
...
non-editable
...
Page User Name
...
bot field
...
text
...
username of the page in Facebook
...
non-editable
...
Last FB Comment
...
user field
...
text
...
user's last comment text in the Facebook page
...
edit by system
...
Last FB Comment Post Id
...
user field
...
text
...
post id of where user put the last comment
...
edit by system
...
Last FB Comment total tagged users
...
user field
...
number
...
tagged users amount in last comment
...
edit by system
...
Last FB Comment total new tagged users
...
user field
...
number
...
tagged but haven't subscribed(to bot) users amount
...
edit by system
...
Last FB Comment is existing users
...
user field
...
number
...
before this comment, is he/she an existing user? yes=1,no=0
...
edit by system
...
Live Chat Url
...
user field
...
text
...
(for agent) visit to talk to user in live chat
...
edit by system
...
NOW
...
user field
...
datetime
...
current time in user's timezone*
...
edited by system
...
TODAY
...
user field
...
date
...
current date in user's timezone*
...
edited by system
...
BOT_CURRENT_TIME
...
bot field
...
datetime
...
current datetime in workspace's timezone
...
edited by system
...
ITEM
...
user field
...
array (JSON)
...
each item in a JSON
...
in "For Each" message
...
SELECT
...
user field
...
array (JSON)
...
selected item
...
in "Select" new step
...
SHOP
...
bot field
...
array (JSON)
...
store information
...
in Ecommerce Integration
...
CART
...
user field
...
array (JSON)
...
user shopping cart
...
in Action Step
...
ORDER
...
user field
...
array (JSON)
...
user's last order
...
edited by system
...
User
...
user field
...
array (JSON)
...
user's profile
...
edited by system according to other profile values
...
DialogFlow
...
user field
...
array (JSON)
...
DialogFlow response
...
edited by DialogFlow agent
| Info |
|---|
Note - If the channel doesn't support timezone in user's profile, or, the channel supports but the user don't have a timezone value, workspace timezone will be used instead. |
User Id in Different Channels:
...
Channel
...
Meaning
...
Example Value
...
...
Unique Id in your Facebook page
...
6288386817841812
...
...
Unique Id in your Instagram bot
...
6570462892993643
...
Telegram
...
Unique Id in your Telegram bot
...
1173717756
...
Slack
...
Unique Id in your Slack workspace
...
U017MKNENH
...
...
Unique Id in your WeChat account
...
oNzS3wpEjnA3tXmOcNxpqtAnBwWg
...
...
User's phone number without +
...
61412345678
...
SMS
...
User's phone number
...
+61412345678
...
Voice
...
User's phone number
...
+61412345678
...
...
| Table of Contents | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
| Info |
|---|
DICA - Antes da introdução detalhada de cada etapa, vamos dar uma olhada no que é campo (variável) no NicoChat. Pode demorar um pouco, mas é essencial saber mais sobre o sistema. |
Campo, também conhecido como variável, é um contêiner para armazenar um valor.
Classificação | Descrição |
|---|---|
campo do sistema e campo personalizado | o campo do sistema é criado pelo sistema com nome e tipo de variável predefinidos, enquanto o campo personalizado é definido por você |
campo bot e campo usuário | O campo bot é compartilhado por todo o bot, enquanto cada usuário tem seu próprio conjunto de campos de usuário |
campo de texto , campo numérico , campo booleano , campo data , campo datahora e campo JSON | veja tipo de variável |
Campo do usuário
O campo Usuário pertence aos usuários. Por exemplo, cada usuário tem seu próprio nome e endereço de e-mail. Portanto, “nome” e “e-mail” são campos de usuário.
Campo de bot
O campo bot pertence ao bot. Por exemplo, um bot de restaurante contém o endereço e o número de contato do restaurante. Portanto, "restaurant_address" e "restaurant_contact" devem ser criados como campos de bot. Porque você não quer gerenciar endereços ou contatos diferentes do seu restaurante para cada usuário.
Campo do sistema
O campo do sistema é criado pelo sistema com nome de variável e tipo de variável predefinidos. Existem campos de bot do sistema e campos de usuário do sistema:
Alguns campos do sistema existem apenas no canal específico. Confira na tabela abaixo como editar o campo do sistema:
Nome do campo | Tipo de campo | Tipo de variável | Descrição | Como editar |
|---|---|---|---|---|
Números de usuários | Campo do usuário | texto | identificação do usuário no NicoChat | não editável |
ID do usuário* | Campo do usuário | texto | identificação do usuário do canal | não editável |
Primeiro nome | Campo do usuário | texto | informações do perfil | na Etapa da Pergunta/Etapa da Ação |
Sobrenome | Campo do usuário | texto | informações do perfil | na Etapa da Pergunta/Etapa da Ação |
Nome de usuário | Campo do usuário | texto | informações do perfil | na etapa de ação |
Gênero | Campo do usuário | texto | informações do perfil | na etapa de ação |
Campo do usuário | texto | informações do perfil | na Etapa da Pergunta/Etapa da Ação | |
Telefone | Campo do usuário | texto | informações do perfil | na Etapa da Pergunta/Etapa da Ação |
Imagem de perfil | Campo do usuário | texto | informações do perfil | na etapa da pergunta |
Localidade | Campo do usuário | texto | informações do perfil | não editável |
Fuso horário | Campo do usuário | texto | informações do perfil | não editável |
Linguagem | Campo do usuário | texto | informações do perfil | na etapa de ação |
Subscrito | Campo do usuário | data hora | tempo de inscrição | não editável |
Última entrada de texto | Campo do usuário | texto | última entrada do usuário | editado pelo sistema |
Última interação | Campo do usuário | data hora | última hora de ação | editado pelo sistema |
Título do último botão | Campo do usuário | texto | último botão pressionado | editado pelo sistema |
Fluxo Ns | campo de bot | texto | identificação de fluxo (bot) no NicoChat | não editável |
Subfluxo Ns | campo de bot | texto | identificação de subfluxo no NicoChat | não editável |
Nome da página | campo de bot | texto | nome da página do Facebook conectada | não editável |
ID da página | campo de bot | texto | ID da página do Facebook conectada | não editável |
Nome de usuário da página | campo de bot | texto | nome de usuário da página no Facebook | não editável |
Último comentário do Facebook | Campo do usuário | texto | texto do último comentário do usuário na página do Facebook | editar por sistema |
ID da postagem do último comentário do FB | Campo do usuário | texto | post id de onde o usuário colocou o último comentário | editar por sistema |
Total de usuários marcados no último comentário do FB | Campo do usuário | número | quantidade de usuários marcados no último comentário | editar por sistema |
Total de novos usuários marcados no último comentário do FB | Campo do usuário | número | quantidade de usuários marcados, mas não inscritos (no bot) | editar por sistema |
O último comentário do FB é de usuários existentes | Campo do usuário | número | antes deste comentário, ele/ela é um usuário existente? sim = 1, não = 0 | editar por sistema |
URL do chat ao vivo | Campo do usuário | texto | (para agente) visita para falar com o usuário no chat ao vivo | editar por sistema |
AGORA | Campo do usuário | data hora | hora atual no fuso horário do usuário* | editado pelo sistema |
HOJE | Campo do usuário | data | data atual no fuso horário do usuário* | editado pelo sistema |
BOT_CURRENT_TIME | campo de bot | data hora | data e hora atual no fuso horário do espaço de trabalho | editado pelo sistema |
ITEM | Campo do usuário | matriz (JSON) | cada item em um JSON | na mensagem "Para cada" |
SELECIONAR | Campo do usuário | matriz (JSON) | item selecionado | em "Selecionar" nova etapa |
COMPRAR | campo de bot | matriz (JSON) | guardar informação | em integração de comércio eletrônico |
CARRINHO | Campo do usuário | matriz (JSON) | carrinho de compras do usuário | na etapa de ação |
ORDEM | Campo do usuário | matriz (JSON) | último pedido do usuário | editado pelo sistema |
Do utilizador | Campo do usuário | matriz (JSON) | perfil do usuário | editado pelo sistema de acordo com outros valores de perfil |
DialogFlow | Campo do usuário | matriz (JSON) | Resposta do DialogFlow | editado pelo agente DialogFlow |
| Info |
|---|
Nota - Se o canal não suportar fuso horário no perfil do usuário ou se o canal suportar, mas o usuário não tiver um valor de fuso horário, o fuso horário do espaço de trabalho será usado. |
ID do usuário em diferentes canais:
Canal | Significado | Valor de exemplo |
|---|---|---|
ID exclusivo em sua página do Facebook | 6288386817841812 | |
ID exclusivo em seu bot do Instagram | 6570462892993643 | |
Telegrama | ID exclusivo em seu bot do Telegram | 1173717756 |
Folga | ID exclusivo em seu espaço de trabalho do Slack | U017MKNENH |
ID exclusivo em sua conta WeChat | oNzS3wpEjnA3tXmOcNxpqtAnBwWg | |
Número de telefone do usuário sem + | 61412345678 | |
SMS | Número de telefone do usuário | +61412345678 |
Voz | Número de telefone do usuário | +61412345678 |
ID da conversa do Google | 8095938e-90cf-4347-ab94-9224308672b0 |
Line
Linha | ID exclusivo em seu bot Line | Ub02c77c69c59c5be5597d58ce2701ebe |
Viber |
ID exclusivo em seu bot Viber | mdY9hOWdeQC6J/Sl19Qh8A== |
Vk
Vc | ID exclusivo em seu bot Vk | 705862439 |
| Info |
|---|
Note - The unique id from the channel is only unique in your Facebook page, Telegram bot, Slack workspace or WeChat account, not the unique id in the whole Nota - O ID exclusivo do canal é exclusivo apenas em sua página do Facebook, bot do Telegram, espaço de trabalho do Slack ou conta WeChat, e não o ID exclusivo em todo o Facebook, Slack, etc. |
Variable Type
...
Tipo de variável
Existem 6 tipos de variáveis no NicoChat:
Tipo |
|---|
Armazenar |
|---|
Exemplo |
|---|
Operações suportadas |
|---|
Texto |
letras, |
palavras, |
frases... |
Olá, NicoChat. |
cortar, alterar maiúsculas e minúsculas, codificar, decodificar... |
Número |
números | 123 |
,45 | + - x ÷, mod, |
potência, log, |
raiz, |
redondo... |
boleano |
"1" |
ou "0", |
para verdadeiro ou falso | 1 |
atribuir |
Data |
data |
2021-03-30
format, add months/weeks/days
DateTime
30/03/2021 | formato, adicione meses/semanas/dias | |
Data hora | data e hora | 2022-01-01T12:00:00+10:00 |
formato, |
adicione meses/ |
semanas/ |
dias/ |
horas/ |
minutos |
JSON ( |
matriz) |
uma série de variáveis | {" |
nome":"Jack", " |
idade":"20"} |
carregar, |
obter, |
atualizar, |
remover, |
contar, |
somar, |
média, |
classificar, |
embaralhar, |
reverter... |
Boolean Value
When these values stored in the field, the boolean return false, otherwise it goes true:
...
empty
...
null
...
'false'
...
false
...
Valor booleano
Quando esses valores são armazenados no campo, o booleano retorna false , caso contrário torna-se true :
vazio
nulo
'falso'
falso
'não'
0
Create Custom Field
Wow, now you are a master 👨🎓 of field! Let's try it out! 😎😎
You can create variables in 2 ways:
...
Place
...
Type Supported
...
in Contents section
...
user field & bot field
...
anywhere you need to map result to variable, e.g. Question step, Integration, etc
...
user field only
Create Custom Field in Contents Section
...
go "Contents" from the left sidebar
select User Fields or Bot Fields
use folder to organize your fields if needed
...
Click the blue "+ New User/Bot Field" button on the right side to create a field. "Field Name" is a must. You can use any character to separate words like underline or space. We suggest you keep the field name as concise as possible, to avoid any possible display issue.
After that, pick a variable type. Add default value or description if needed. (default value is for bot fields only)
Folders can be used to organize variables. Trust me, you will need it when your flow goes big. 🧐
Create Custom Field in Question and Action Step
To create new fields in for example, the question step:
...
Type in a new variable name in the "Enter Field Name" box and click it in the drop-down list. Select correspond variable type and here you go.
...
Another example, create in an integration:
...
Criar campo personalizado
Uau, agora você é um mestre 👨🎓 da área! Vamos experimentar! 😎😎
Você pode criar variáveis de 2 maneiras:
Lugar | Tipo suportado |
|---|---|
na seção Conteúdo | campo de usuário e campo de bot |
em qualquer lugar que você precise mapear o resultado para a variável, por exemplo, etapa da pergunta, integração, etc. | somente campo de usuário |
Crie um campo personalizado na seção de conteúdo
...
vá em "Conteúdo" na barra lateral esquerda
selecione Campos de usuário ou Campos de bot
use a pasta para organizar seus campos, se necessário
...
Clique no botão azul "+ Novo campo de usuário/bot" no lado direito para criar um campo. "Nome do campo" é obrigatório. Você pode usar qualquer caractere para separar palavras, como sublinhado ou espaço. Sugerimos que você mantenha o nome do campo o mais conciso possível, para evitar possíveis problemas de exibição.
Depois disso, escolha um tipo de variável. Adicione um valor padrão ou uma descrição, se necessário. (o valor padrão é apenas para campos de bot)
Pastas podem ser usadas para organizar variáveis. Acredite em mim, você precisará disso quando seu fluxo aumentar. 🧐
Crie um campo personalizado na etapa de pergunta e ação
Para criar novos campos, por exemplo, na etapa da pergunta:
...
Digite um novo nome de variável na caixa “Inserir nome do campo” e clique nele na lista suspensa. Selecione o tipo de variável correspondente e aqui está.
...
Outro exemplo, crie em uma integração:
...