Ação
Blocos de Ação são onde lógica de terceiros, código ou operações especiais podem ser adicionados ao seu bot.
A partir de 1º de outubro de 2024, todos os clientes da Chatlayer serão migrados para o novo widget da web, Web V2. Para saber mais sobre as diferenças entre V1 e V2, confira esta página. Para um mergulho técnico mais profundo, confira esta página.
Você pode usar o construtor JSON em combinação com o Canal Web para receber eventos da janela na sua página. Esses eventos conterão os dados conforme configurado na sua ação do construtor JSON.
Para fazer isso, você precisará marcar a opção Enviar configuração para a janela pai Isso permitirá enviar dados para o local onde o widget está, de forma estruturada.
Aqui está um exemplo:
Configure sua ação do construtor JSON para enviar uma idioma chave, com uma variável recuperada da sessão.
Ative a chave Enviar configuração para a janela pai ligado.
Adicione um Ação bloco por arrastar e soltar no seu fluxo.
Ação blocos permitem integrar serviços de terceiros, implementar lógica de codificação personalizada ou realizar operações especializadas dentro do seu bot
Etapas de codificação
Código
O editor de código permite que desenvolvedores construam rapidamente lógica personalizada sobre o bot escrevendo seus próprios blocos de código Javascript. Normalmente, o editor de código é usado para fazer solicitações a sistemas externos ou para realizar operações com variáveis.
Você pode encontrar mais informações sobre o editor de código aqui:
Editor de códigoTambém há dois tutoriais nos quais mostramos como o editor de código pode ser usado:
[Exemplo] Recuperando dados do Airtable (GET)[Exemplo] Enviando dados para Airtable (POST)API
A etapa de API é uma integração onde você integra o Chatlayer com seu back-end ou serviços de terceiros para compartilhar dados coletados na conversa com o bot, ou enriquecer o bot com dados capturados.
Construtor JSON
Se o seu bot estiver publicado no Webhook API canal, você pode usar a ação Construtor JSON para enviar mensagens para a conversa que não precisam resultar em uma mensagem real para o usuário. Normalmente, é usado para enviar informações sobre o usuário ou a conversa do bot para o site onde o bot está publicado.
Eventos de janela do site
Você pode usar a ação do construtor JSON em combinação com o canal do webwidget para receber eventos de janela na sua página. Esses eventos conterão os dados conforme configurado na sua ação do construtor JSON.
Aqui está um exemplo: Configure sua ação do construtor JSON para enviar uma idioma chave, com uma variável recuperada da sessão, e com "Enviar configuração para a janela pai" ativado.
Seu widget acionará um evento para essa configuração à sua janela pai como um MessageEvent. O MessageEvent conterá um campo `data` que contém o resultado em string da configuração do construtor JSON. Aqui está um exemplo de como escutar esses eventos:
// Manipulador de Evento do Construtor JSON da Chatlayer
window.addEventListener('message', (event) => {
const data = event && event.data && JSON.parse(event.data) || {}
const { type, payload } = data
if (type !== 'CL_DISPATCH_EVENT') return;
console.log('Idioma do Chatlayer recebido: ' + payload.language)
})Etapas de pausa
Pausar bot
A Pausar bot etapa vai pausar seu bot quando alcançar este bloco.
Atraso
Às vezes você precisa de um pequeno atraso entre mensagens do bot, seja para criar uma pausa natural ou para fazer uma chamada de API sem que o bot fique em silêncio. Essas pausas podem melhorar significativamente a experiência do usuário.
Você pode por exemplo, usar Atraso antes de Fechar conversa etapa.
Etapas de variáveis
Limpar dados da sessão: variáveis e contexto
Use uma Limpar sessão etapa para limpar variáveis 
e/ou contexto 
que você não precisa mais.
Definir variáveis
A Definir variável etapa facilita a criação, formatação e atribuição de valores a variáveis.
Recentemente, introduzimos uma nova sintaxe de expressões. Para explorar toda a gama de expressões e funções disponíveis, confira a documentação abrangente fornecida aqui.
Operações permitem realizar cálculos como adição, subtração, multiplicação, divisão ou encontrar o resto de dois números.
Ir para diálogo de variável do bot
Use a Ir para diálogo de variável do bot etapa para navegar para um bloco que está contido dentro de uma variável.
Etapas de e-mail
Enviar e-mail
A Enviar e-mail etapa envia um e-mail com uma mensagem.
Relatório por e-mail
A Relatório por e-mail etapa envia 2 coisas:
um e-mail com uma mensagem
a conversa do bot no momento em que a mensagem foi enviada
Tudo o que você precisa fazer é definir o título do e-mail, destinatários e corpo. Aqui você também pode usar variáveis entre chaves, se precisar.
Etapas de voicebot
Iniciar gravação da chamada
A partir da Iniciar gravação da chamada etapa, a conversa com seu voicebot está sendo gravada.
Parar gravação da chamada
A partir da Parar gravação da chamada etapa, a conversa com seu voicebot parará de ser gravada.
Encaminhar chamada
Você pode encaminhe a chamada do seu voicebot para um número de telefone usando a Encaminhar chamada etapa.
Após configurar o número para o qual você deseja encaminhar sua chamada, o bot desligará automaticamente ao transferir. Para alcançar o bot novamente, desligue a chamada e ligue uma segunda vez.
Outras etapas
Rastrear evento
Uma Rastrear evento etapa pode ser usada para criar painéis e funis personalizados para melhorar a análise do desempenho do seu bot.
iFrame
Um iFrame é um elemento personalizado que pode ser usado para mostrar uma página da web diferente na conversa do chat. Ele também pode ser usado para se comunicar com a janela pai usando a postMessage API.
Dê uma olhada neste exemplo básico:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
</head>
<body>
<button onClick="window.parent.postMessage(JSON.stringify({target:'CL_API',type:'SEND_MESSAGE', payload:{text: 'You clicked the button'} }),'*')">
SEND_MESSAGE
</button>
</body>
</html>Se esse bloco de código estiver hospedado e incorporado em nosso plugin de iframe, ele enviará ao usuário uma mensagem de chat quando ele clicar no botão.
A postMessage API também pode lidar com UPDATE_SESSION e GO_TO_DIALOGSTATE eventos.
Obter hora
A Obter hora etapa é sobre orientar seu fluxo com base no momento atual. Você pode reutilizar essas variáveis de tempo dentro da sua conversa.
Quando você fornece um deslocamento de fuso horário, o resultado do plugin conterá propriedades de tempo iguais a UTC+deslocamento.
Fechar conversa
O bot fechará a conversa ativa quando a Fechar conversa etapa for alcançada.
Isso significa que as variáveis da sessão são apagadas.
Exemplo: Atraso antes de Fechar conversa
Você pode, por exemplo, usar a Fechar conversa etapa junto com uma Atraso etapa. Isso é útil em uma situação em que o usuário não responde por alguns minutos e você quer fechar a conversa a partir daí.
Fechar conversa está agora disponível no Web canal, Voz canal, e Sinch Conversation API canal.
Operação de tabela
A Operação de tabela etapa é sobre usar suas Tabelas.
Base de conhecimento IA
A Base de conhecimento IA etapa é sobre usar sua Base de conhecimento IA.
Enviar para provedor de offload
Um usuário que chegar a esta ação será encaminhado para um agente humano de suporte ao cliente.
Para conseguir ver esta etapa no seu bot, você precisará configurar um provedor de offload.
Dependendo do seu provedor de offload selecionado, pode ser necessária configuração adicional.
Atualizado
Isto foi útil?