Ação

Blocos de Ação são onde lógica de terceiros, código ou operações especiais podem ser adicionadas 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.

Etapa do construtor JSON.

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:

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

2. Ative a chave Enviar configuração para a janela pai ligado.

Construtor JSON com um campo de idioma.

Adicione um Ação bloco por arrastar e soltar no seu fluxo.

Aba Ação.

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

Exemplo de um bloco de Ação.

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ódigo

També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.

Etapa de API.

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.

Ação do construtor JSON com um campo de idioma

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.

Etapa Pausar bot.

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.

Etapa de Atraso.

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.

Adicione uma operação dentro do valor da sua variável.

Operações permitem realizar cálculos como adição, subtração, multiplicação, divisão ou encontrar o resto de dois números.

Para uma lista abrangente de operações disponíveis, como adição (+), multiplicação (*), divisão (/), e mais, consulte a documentação detalhada fornecida aqui.

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.

Etapa Ir para diálogo de variável do bot.

Etapas de e-mail

Enviar e-mail

A Enviar e-mail etapa envia um e-mail com uma mensagem.

Etapa Enviar e-mail.

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.

Etapa Relatório por e-mail.

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.

Etapa Iniciar gravação da chamada.

Parar gravação da chamada

A partir da Parar gravação da chamada etapa, a conversa com seu voicebot parará de ser gravada.

Etapa Parar gravação da chamada.

Encaminhar chamada

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

Etapa Encaminhar chamada.

O número de telefone deve conter um código do país, mas sem zeros à esquerda, apenas o sinal '+'. Por exemplo: 0800 55 800 torna-se [phone]

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.

Etapa Rastrear evento.

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.

Obter variáveis de hora

Se você não fornecer um deslocamento de fuso horário, o momento atual será salvo no Variável de destino campo. No nosso exemplo, essa variável será chamada time. Nesse caso, seu Variável de destino ficará acessível com as seguintes variáveis:

• (target).utc.year

• (target).utc.month

• (target).utc.dayOfMonth

• (target).utc.dayOfWeek

• (target).utc.hours

• (target).utc.minutes

• (target).utc.seconds

• (target).utc.ISO

Por padrão, o resultado do plugin conterá propriedades relacionadas ao horário UTC.

Quando você fornece um deslocamento de fuso horário, o resultado também conterá propriedades de tempo iguais a UTC+<OFFSET>.

• (target).offset.year

• (target).offset.month

• (target).offset.dayOfMonth

• (target).offset.dayOfWeek

• (target).offset.hours

• (target).offset.minutes

• (target).offset.seconds

• (target).offset.ISO

Dentro de uma mensagem, você pode usar essas variáveis, por exemplo, assim:

Hoje é {time.offset.dayOfMonth}/{time.offset.month}/{time.offset.year}

Etapa Obter hora.

Direcione seu fluxo dependendo do horário

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.

Etapa Fechar conversas.

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.

Etapa Operação de tabela

Base de conhecimento IA

A Base de conhecimento IA etapa é sobre usar sua Base de conhecimento IA.

Etapa 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.