Usando funções no construtor de bot

Criada por Isabelle Lemes, Modificado em Tue, 28 Feb 2023 na (o) 11:00 AM por Isabelle Lemes

Disponível apenas no plano Enterprise Omnichannel. 


Configurar caixas de diálogo em seu construtor de bot para enviar respostas predefinidas aos clientes é bastante simples. Você também pode preencher valores dinamicamente em seus diálogos para ajudar seus clientes com respostas contextuais.


O construtor de bot fornece funções comumente usadas para suas operações diárias, como buscar a data atual, separar strings por um delimitador, manipular data e hora, etc. Essas Funções agem como espaços reservados e cuidam de preencher os valores para esses campos dinamicamente. Além do mais, você também pode definir como deseja que cada função se comporte ou colete informações declarando-as como Inputs . As entradas são predefinidas para cada função e você também pode usar espaços reservados de outras caixas de diálogo, API ou propriedades personalizadas/padrão para cada uma dessas funções.


Por exemplo, você pode perguntar ao seu cliente o nome dele e, ao salvá-lo, pode usar uma função para garantir que ele seja salvo no caso do título. Listadas abaixo estão as explicações para as funções oferecidas pelo construtor de bot. Você pode usar a função correspondente em sua caixa de diálogo para preencher dinamicamente os valores em seu bot.



Nome e descrição da função
Quais entradas você fornece?
Exemplos
Split
Divide uma string de texto no separador especificado e retorna o valor com base no índice especificado.
Texto de entrada:
O texto que precisa ser dividido

Separador:
O caractere no qual você precisa que o texto seja dividido

Índice:
A posição do texto que precisa ser retornado. A posição do índice da string antes do separador é zero e a posição do índice da string após o separador é um.
Texto de entrada:
support@freshchat.com

Separador:
@

Índice:
0

Saída:
suporte
Converter para maiúsculas e minúsculas do título
Converte a formatação de uma string de texto para que ela seja armazenada na capitalização do título, onde a primeira letra de cada palavra é maiúscula.
Texto de entrada:
O texto que precisa ser convertido para o caso do título

Texto de entrada:
atendimento ao cliente

Saída:
Atendimento ao cliente

Obter dias entre
Retorna a contagem do número de dias entre duas datas especificadas (incluindo a data final)
Data inicial:
A data a partir da qual a contagem deve começar (não incluída)

Data final:

A data até quando a contagem deve continuar (incluída na contagem)

Formato:

O formato no qual você está especificando as datas
Data de início:
01-01-21

Data de término:

01-01-22

Formato:

dd-MM-aa

Saída:
365

Adicionar minutos à data
Adiciona o número especificado de minutos à data especificada
Data de entrada:
A data à qual os minutos precisam ser adicionados

Minutos:

O número de minutos que precisam ser adicionados à data de entrada

Formato:

O formato no qual você está especificando a data e a hora

Data de entrada:
01-01-21 00:15:00

Minutos:

51

Formato:

dd-MM-aa HH:mm:ss

Saída:

01-01-21 01:07:00
Adicionar horas à data
Adiciona o número especificado de minutos à data especificada
Data de entrada:
A data à qual as horas precisam ser adicionadas

Horas :
O número de horas que precisam ser adicionadas à data de entrada

Formato :
O formato no qual você está especificando a data e a hora
Data de entrada :
01-01-21 07:04:00 AM

Horas :
12

Formato :
dd-MM-aa hh:mm:ss a

Saída :
01-01-21 19:04:00
Adicionar dias até a data
Adiciona o número especificado de dias à data especificada

Data de entrada:
A data à qual os dias precisam ser adicionados

Dias:
O número de dias que precisam ser adicionados à data de entrada

Formato:
O formato no qual você está especificando a data

Data de entrada:
01-01-21

Dias:
12

Formato:
dd-MM-aa

Saída:
13-01-21

Adicionar dias até a data com fuso horário
Adiciona o número especificado de dias à data especificada que é indicada junto com o fuso horário

Data de entrada:
A data à qual os dias precisam ser adicionados

Dias:
O número de dias que precisam ser adicionados à data de entrada

Formato:
O formato no qual você está especificando a data

Fuso horário :
O fuso horário que precisa ser indicado junto com a data
Data de entrada:
01-01-2021 04:15:00 AM IST

Dias:
7

Formato:
dd-MM-aaaa hh:mm:ss az

Fuso horário :
IST

Saída:
08-01-2021 04:15:00 AM IST
Adicionar dias úteis à data com fuso horário
Adiciona o número especificado de dias úteis à data especificada que é indicada junto com o fuso horário

Observe que, a partir de hoje, esta função contabilizará apenas cinco dias úteis por semana - e não levará em conta outros feriados ou horários de dias úteis.
Data de entrada:
A data à qual os dias úteis precisam ser adicionados

Dias úteis:
O número de dias úteis que precisam ser adicionados à data de entrada

Formato:
O formato no qual você está especificando a data

Fuso horário :
O fuso horário que precisa ser indicado junto com a data

Data de entrada:
01-01-2021 04:15:00 AM IST

Dias:
7

Formato:
dd-MM-aaaa hh:mm:ss az

Fuso horário :
IST

Saída:
12-01-2021 04:15:00 AM IST

Adicionar dias úteis à data
Adiciona o número especificado de dias úteis à data especificada.

Observe que, a partir de hoje, esta função contará apenas cinco dias úteis por semana - e não levará em consideração outros feriados ou horários de dias úteis.

Data de entrada:
A data à qual os dias úteis precisam ser adicionados

Dias úteis:
O número de dias úteis que precisam ser adicionados à data de entrada

Formato:
O formato no qual você está especificando a data
Data de entrada:
2021-31-01

Dias:
7

Formato:
aaaa-dd-MM

Saída:

2021-09-02
Data do formato:
Altera o formato da data atual, para um formato diferente e especificado
Data de entrada:
A data cujo formato precisa ser alterado

Formato:
O formato existente da data especificada

Formato:
O formato para o qual a data precisa ser atualizada
Data de entrada:
2021-31-01

Formato:
aaaa-dd-MM

Formato:
dd-MM-aaaa

Saída:
31-01-2021
Extrair de elementos da lista:
divide cada elemento em uma lista especificada com base no delimitador especificado e retorna um valor para cada elemento, com base no valor do índice especificado

Lista de entrada:
A lista de elementos da qual um valor precisa ser extraído para cada elemento da lista

Delimitador:

O caractere ou sequência presente em cada elemento da lista. A função dividirá cada elemento da lista neste caractere.

Índice:

A posição do texto que precisa ser retornado. A posição de índice da string antes do delimitador é zero e a posição de índice da string após o delimitador é um.
Lista de entrada:
Room#101, Room#102, Room#103, Room#104

Delimitador:

#

Índice:

1

Saída:
[101, 102, 103, 104]
Anexar conteúdo:
pega o conteúdo anexado especificado e o anexa ao conteúdo principal especificado 
Conteúdo principal:
O conteúdo ao qual o texto precisa ser anexado

Conteúdo anexado:
O conteúdo que precisa ser anexado
Conteúdo principal:
Hello

Conteúdo anexado:
 World

Saída:
Hello World
Dividido em lista:
divide a string especificada em uma lista com base no delimitador especificado
Conteúdo principal:
O conteúdo que precisa ser dividido em uma lista. Delimitador: O caractere/string que precisa ser usado para dividir o conteúdo principal em uma lista.


Conteúdo principal:
Opção 1 e Opção 2 e Opção 3 e Opção 4

Delimitador:
e

Saída:

[Opção 1, Opção 2, Opção 3, Opção 4]

Extract from list:
Obtém qualquer elemento de uma lista com base na posição especificada (índice) do elemento
Lista de entrada:
A lista de elementos da qual o elemento precisa ser extraído

Índice:
A posição do texto que precisa ser retornado. O valor do índice começa em zero para o primeiro elemento.
Conteúdo principal:
Opção 1, Opção 2, Opção 3, Opção 4

Índice:
2

Saída:
Opção 3
Contar dias úteis:
conta o número de dias úteis entre os dois dias especificados.

Observe que, a partir de hoje, esta função contará apenas cinco dias úteis por semana - e não levará em consideração outros feriados ou horários de dias úteis.
Data 1:
A data a partir da qual a contagem deve começar

Data 2:
A data até quando a contagem deve continuar (incluída na contagem)

Formato:
O formato no qual você está especificando as datas
Data 1:
24-12-2021

Data 2:
06-01-2021

Formato:
dd-MM-aaaa

Saída:
11
Adicionar inteiros
Adiciona quaisquer dois inteiros especificados
Número inteiro de entrada 1:
O primeiro número inteiro ao qual o segundo número inteiro precisa ser adicionado.

Número inteiro de entrada 2:
O segundo inteiro que será adicionado ao primeiro inteiro.
Inteiro inteiro 1:
123

Inteiro inteiro 2:
4

Saída:

127
Obter comprimento
Retorna o comprimento da string especificada
Entidade:
A string cujo comprimento é necessário
Entidade:
Atendimento ao Cliente

Saída:
16
Obter data atual:
retorna a data atual no formato especificado
Formato:
Especifique o formato no qual você precisa do da atual
Formato:
dd-MMM-aaaa hh:mm:ss az

Saída:

12 de fevereiro de 2021 14:11:23 UTC

Compare datas:
A função irá comparar a data primária com a data secundária e então retornará:

1, se a data primária for maior que a data secundária.

0, se ambas as datas forem iguais

-1, se a data principal for menor que a data secundária 
Data 1:
A data principal

Data 2:

A data secundária

Formato:

O formato no qual as datas foram inseridas
Data 1:
11-02-2021

Data 2:

03-02-2021

Formato:
dd-MM-aaaa Saída: 1


Compute:
A função calcula o valor da expressão especificada e retorna a saída com até duas casas decimais
Expressão de entrada:
a expressão que precisa ser computada
Expressão de entrada:
8/(2*4) + ( 8/2)*4

Saída:
17,00
Obter JWT:
a função receberá as respectivas entradas e fornecerá um token JWT como saída
Declarações:
uma expressão JSON válida que precisa ser codificada. Essas declarações incluem, mas não estão limitadas ao emissor, assunto, público, etc.


Chave secreta do JWT:
use uma string para assinar o cabeçalho e o conteúdo da carga útil que está sendo codificado. 


Expiry (seconds):
Defina o período de tempo (em segundos) para o qual o JWT será válido.


Identificador de algoritmo:
escolha entre HS256, HS384 ou HS512 como o algoritmo (assinatura ou criptografia) a ser usado para processar os dados contidos no JWT.

Reivindicações:
{

  "sub": "1234567890",

  "nome": "John Doe",

  "iat": 1516239022

}


Chave secreta JWT:
seu segredo de 256 bits


Expiração (segundos):
120


Identificador de algoritmo:
HS256

Obter JWE:
A função receberá as respectivas entradas e fornecerá um token JWE como saída

Declarações:
uma expressão JSON válida que precisa ser codificada. Essas declarações incluem, mas não estão limitadas ao emissor, assunto, público, etc.


Chave secreta do JWT:
use uma string para assinar o cabeçalho e o conteúdo da carga útil que está sendo codificado. 


Expiry (seconds):
Defina o período de tempo (em segundos) para o qual o JWT será válido.


Identificador de algoritmo:
escolha entre HS256, HS384 ou HS512 como o algoritmo (assinatura ou criptografia) a ser usado para processar os dados.


Chave secreta JWE:
use uma string para assinar o cabeçalho e o conteúdo da carga útil que está sendo codificado.


Cabeçalho de origem:
use uma string para especificar o cabeçalho de origem

Reivindicações:

 

 "sub": "1234567890",

  "nome": "John Doe",

  "iat": 1516239022

}


Chave secreta JWT:
your-256-bit-secret


Expiração (segundos):
120


Identificador de algoritmo:
HS256


Chave secreta JWE:
your-256-bit-secret-part-two

Cabeçalho de origem:

"alg": "HS256",

  "tipo": "JWT"


Codificar para base64:
a função codificará o nome de usuário e a senha com codificação base64.

Nome de usuário:
O nome de usuário que precisa ser codificado

Senha
A senha que precisa ser codificada
Nome de usuário:
John.doe@saulsstore.com

Senha
AlwaysUseStrongLongPasswords
Operador Ternário:
Esta função se comporta exatamente como o operador ternário, usando três valores. Ele compara os dois primeiros valores e atribui um valor se verdadeiro e outro valor se falso. 

LHS  &  RHS:

LHS e RHS podem ser quaisquer entradas, e esta função irá compará-los.


Operador:

Defina qual deve ser a comparação entre o LHS e o RHS usando um dos seguintes operadores: Igual, Diferente, Maior que, Menor que, Maior ou igual, Menor que ou igual.


Se for verdade

Defina o valor que precisa ser gerado se a comparação for verdadeira


Outro

Defina o valor que precisa ser gerado se a comparação não for verdadeira

LHS:

Status do pedido


RH:

Entregue


Operador:

É igual a


Se for verdade

Seu pedido foi entregue


Outro

Sua entrega ainda está pendente.



Usamos apenas alguns formatos em nossos exemplos. Você pode usar qualquer um dos formatos padronizados de data e hora. 

Todos os campos de entrada podem receber entradas de espaços reservados existentes, como caixas de diálogo, APIs e parâmetros. Da mesma forma, você pode usar a saída de qualquer função como um espaço reservado em outro lugar.




Recentemente, atualizamos nossa marca em nossas ofertas e alteramos os nomes de nossos planos de preços. Se você se inscreveu antes de 9 de agosto de 2021, clique em Planos anteriores para visualizar seus planos aplicáveis. 
Garantimos que essa alteração não afetará sua experiência com o produto e nenhuma ação é necessária de sua parte.

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos
A verificação do CAPTCHA é obrigatória.

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo