Ação

Você pode usar o construtor JSON em combinação com o Canal Web para receber eventos de janela na sua página web. 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á que você envie dados para o local onde o widget está de forma estruturada.

Aqui está um exemplo:

1. Configure sua ação do construtor JSON para enviar uma chave de idioma , com uma variável recuperada da sessão.

2. Ative a opção Enviar configuração para a janela pai ligada.

Adicione um Ação bloco por arrastando e soltando-o no seu fluxo.

Ação os blocos permitem que você integre serviços de terceiros, implemente lógica personalizada em código ou execute 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. Tipicamente, o editor de código é usado para fazer requisiçõ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:

Também existem dois tutoriais nos quais mostramos como o editor de código pode ser usado:

API

O etapa de API é uma integração onde você integra o Chatlayer com seu back-end ou serviços de terceiros a fim de compartilhar dados coletados na conversa com o bot, ou enriquecer o bot com dados capturados.

construtor JSON

Se o seu bot estiver publicado no canal Webhook API , 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. Tipicamente, é 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 webwidget para receber eventos de janela na sua página web. 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 chave de idioma chave, com uma variável recuperada da sessão, e a opção "Enviar configuração para a janela pai" ativada.

Seu widget acionará um evento para essa configuração em 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 do 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 recebido pelo Chatlayer: ' + payload.language)
})

Etapas de pausa

Pausar bot

O Pausar bot a etapa irá pausar seu bot quando ele 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 uma etapa Fechar conversa .

Etapas de variáveis

ação Limpar sessão

Use uma ação Limpar sessão etapa para limpar variáveis que você não precisa mais.

Definir variáveis

O Definir variável a etapa facilita a criação, formatação e atribuição de valores a variáveis.

As operações permitem que você execute 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 o 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

O Enviar e-mail a etapa envia um e-mail com uma mensagem.

Relatório por e-mail

O Relatório por e-mail a 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 deixará de ser gravada.

Encaminhar chamada

Você pode encaminhe a chamada do seu voicebot para um número de telefone usando o Encaminhar chamada .

Após configurar o número de telefone para o qual deseja encaminhar sua chamada, o bot desligará automaticamente ao transferir. Para alcançar o bot novamente, desligue a chamada e ligue pela 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 web diferente na conversa do chat. Também pode ser usado para comunicar com a janela pai usando a API postMessage.

Veja este 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 este bloco de código for hospedado e incorporado dentro do nosso plugin iframe, ele enviará ao usuário uma mensagem de chat quando ele clicar no botão.

A API postMessage também pode tratar UPDATE_SESSION e GO_TO_DIALOGSTATE eventos.

Obter hora

O Obter hora de passo é 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 que são 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 de sessão são apagadas.

Operação de tabela

O Operação de tabela a etapa trata de usar suas Tabelas.

IA de base de conhecimento

O IA de base de conhecimento a etapa trata de usar sua IA de base de conhecimento.

Enviar para provedor de offload

Um usuário que alcançar esta ação será encaminhado para um agente humano de atendimento ao cliente.

Dependendo do provedor de offload selecionado, pode ser necessária configuração adicional.