Ação

Os 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 web, Web V2. Para saber mais sobre as diferenças entre V1 e V2, confira esta página. Para um aprofundamento técnico, confira esta página.

Etapa do JSON Builder.

Você pode usar o JSON Builder em combinação com o canal Web para receber eventos da janela na sua página da web. Esses eventos conterão os dados conforme configurados na sua ação do JSON Builder.

Para fazer isso, você precisará marcar a Enviar configuração para a janela pai opção. Ela permitirá enviar dados para o local onde o widget está de forma estruturada.

Aqui está um exemplo:

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

2. Ative o alternador Enviar configuração para a janela pai ativado.

JSON Builder com um campo de idioma.

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

aba Ação.

Ação blocos permitem integrar serviços de terceiros, implementar lógica de programação personalizada ou realizar operações especializadas dentro do seu bot

Exemplo de um bloco de Ação.

Etapas de programação

Código

O editor de código permite que desenvolvedores criem rapidamente lógica personalizada sobre o bot escrevendo seus próprios blocos de código em 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 da API é uma integração em que você integra a Chatlayer com o 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 da API.

JSON Builder

Se o seu bot estiver publicado no Webhook API canal, você pode usar a ação JSON Builder para enviar mensagens para a conversa que não precisam resultar em uma mensagem real para o usuário. Normalmente, ela é usada para enviar informações sobre o usuário ou a conversa do bot ao site no qual o bot está publicado.

Eventos da janela do site

Você pode usar a ação do JSON Builder em combinação com o canal webwidget para receber eventos da janela na sua página da web. Esses eventos conterão os dados conforme configurados na sua ação do JSON Builder.

Aqui está um exemplo: Configure sua ação do JSON Builder para enviar uma idioma chave, com uma variável recuperada da sessão, e "Enviar configuração para a janela pai" ativado.

ação do JSON Builder com um campo de idioma

Seu widget disparará um evento para essa configuração na janela pai como um MessageEvent. O MessageEvent conterá um campo `data`, que contém o resultado em string da configuração do JSON Builder. Aqui está um exemplo de como ouvir esses eventos:

// Manipulador de eventos do JSON Builder 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 da Chatlayer recebido: ' + payload.language)
})

Etapas de pausa

Pausar bot

A Pausar bot a etapa pausará seu bot quando ele chegar a este bloco.

Etapa de pausar bot.

Atraso

Às vezes, você precisa de uma pequena pausa entre as 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 uma etapa 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 a etapa facilita a criação, formatação e atribuição de valores a variáveis.

Introduzimos recentemente 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.

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

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

Ir para o diálogo do bot da variável

Use o Ir para o diálogo do bot da variável etapa para navegar até um bloco contido dentro de uma variável.

Etapa Ir para o diálogo do bot da variável.

Etapas de e-mail

Enviar e-mail

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

Etapa Enviar e-mail.

Relatório por e-mail

A 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, os destinatários e o corpo. Aqui você também pode usar variáveis entre chaves, se precisar.

Etapa de relatório por e-mail.

Etapas do voicebot

Iniciar gravação da chamada

Da Iniciar gravação da chamada etapa, a conversa com o seu voicebot está sendo gravada.

Etapa Iniciar gravação da chamada.

Parar gravação da chamada

Da Parar gravação da chamada etapa, a conversa com o seu voicebot deixará de ser gravada.

Etapa Parar gravação da chamada.

Encaminhar chamada

Você pode encaminhar 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 de país, mas sem zeros à esquerda, apenas o sinal '+'. Por exemplo: 0800 55 800 se torna [phone]

Depois de configurar o número de telefone para o qual você deseja encaminhar a chamada, o bot desligará automaticamente ao fazer a transferência. Para falar com 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 de chat. Ele também pode ser usado para se 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: 'Você clicou no botão'} }),'*')">
         SEND_MESSAGE
        </button>
		</body>
</html>

Se este 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 API postMessage também pode lidar com UPDATE_SESSION e GO_TO_DIALOGSTATE eventos.

Obter horário

A Obter horário etapa consiste em 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 equivalentes a UTC+deslocamento.

Obter variáveis de tempo

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 se chamará time. Nesse caso, seu Variável de destino estará 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 equivalentes 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 horário.

Direcione seu fluxo de acordo com a hora

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 encerrar a conversa a partir daí.

Fechar conversa agora está disponível no Web canal, Voice canal e Sinch Conversation API canal.

Operação de tabela

A Operação de tabela a etapa trata do uso do recurso nativo da Chatlayer Tabelas.

Etapa de operação de tabela

IA da base de conhecimento

A IA da base de conhecimento a etapa trata do uso do seu IA da base de conhecimento.

etapa da IA da base de conhecimento.

Enviar para provedor de offload

Um usuário que chegar a esta ação será transferido 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 provedor de offload selecionado, pode ser necessária configuração adicional.