Mensagem

O bloco Mensagem exibe texto de forma básica ou com componentes especiais como botões ou carrosséis.

Adicione um bloco de Mensagem por arrastando e soltando-o no seu fluxo.

O bloco de Mensagem.

Limites de caracteres

O Chatlayer indica quantos caracteres ainda são permitidos no canto inferior direito de qualquer campo de texto.

A única exceção é para Carrosséis, que mostram a quantidade de caracteres que você já digitou e não o limite de caracteres.

Escreva o bloco de Mensagem respeitando os limites de caracteres indicados.

Observe que, no Facebook Messenger, o limite é rigoroso de 20 caracteres para um botão rótulo. Se o rótulo do seu botão for maior, ele será cortado e exibido com reticências. Saiba mais sobre nossas limitações dos canais.

Para todos os outros canais, o limite de caracteres é baseado em boas práticas. Recomendamos usar menos caracteres do que o limite, mas isso não é obrigatório.

Etapas de Mensagem

Mensagem de texto

As mensagens de texto são os componentes mais simples. A maioria dos canais as mostrará como balões de fala.

Etapa de mensagem de texto.

Botões

Botões são uma forma útil de conduzir a conversa, oferecendo ao usuário um conjunto limitado de opções. Você pode adicionar no máximo três botões a uma mensagem, com diferentes tipos de botão.

Etapa de botões.

Tipos de botão

Há 4 tipos diferentes de botões:

• Ir para: Quando este botão é clicado, a conversa vai para um novo bloco. Opcionalmente, você pode adicionar combinações de chave-valor a um botão. Elas definirão variáveis dependendo de qual botão o usuário clicou. Essas variáveis podem então ser usadas posteriormente para direcionar blocos, fazer uma chamada de API ou renderizar texto específico.

• URL: você pode vincular um botão a uma URL externa.

• Chamar: este botão iniciará uma chamada se o usuário estiver usando um dispositivo móvel.

• Webview: este botão abrirá uma webview (ou uma nova janela do navegador, dependendo do canal) com a URL configurada como destino. Os parâmetros que você configurar para este botão serão convertidos em JSON e anexados à URL como uma string codificada em Base64. É possível decodificar essa string usando a atob função JavaScript.

Mídia

Com a Mídia etapa, você pode permitir que o bot envie arquivos aos seus usuários.

Etapa de mídia.

Tipos de mídia

• Imagens: todos os tipos comuns de imagem, como jpg, png e gif, são compatíveis com nossa plataforma.

• Vídeo: vídeos estão disponíveis no Emulador, Web e no canal do Facebook. Confira este artigo para adicionar vídeos ao seu bot. Os seguintes formatos de vídeo são compatíveis:

  • mp4

  • ogv

  • webm

• Áudio: a mídia de áudio está disponível no Emulador, no Web canal e Facebook Messenger. Atualmente, suportamos apenas MP3 como formato de áudio.

• Arquivos: anexos de arquivo estão disponíveis em Facebook Messenger. Atualmente, apenas PDF é compatível. Se você enviar o arquivo diretamente na plataforma, há um limite de tamanho de arquivo de 10 MB. Se você usar uma URL direta para o arquivo, não há limite de tamanho de arquivo.

Está com dificuldade para adicionar um vídeo externo ao seu bot? Confira este artigo.

Certifique-se de remover espaços dos arquivos de mídia enviados; isso pode fazer com que eles não sejam exibidos corretamente.

Recomendamos que os arquivos de mídia compartilhados no Facebook Messenger tenham menos de 5 MB, pois o Facebook parece ter dificuldade em lidar com arquivos maiores com desempenho aceitável.

Respostas rápidas

Respostas rápidas funcionam de forma semelhante aos botões. Elas são exibidas horizontalmente, lado a lado, em um contêiner rolável. Isso significa que você pode adicionar quantas respostas rápidas achar necessário.

Configurações de respostas rápidas

• Ícone: opcionalmente, você pode adicionar um ícone a uma resposta rápida especificando sua URL.

• Ir para: para cada resposta rápida, você precisa definir um próximo bloco a ser visitado no fluxo. Em outras palavras, você criará uma Conexão de ir para.

• Variáveis: opcionalmente, variáveis podem ser definidas dependendo de qual botão o usuário clicou. Essas variáveis podem então ser usadas posteriormente para direcionar blocos, fazer uma chamada de API ou renderizar texto específico.

Observe que Respostas rápidas apenas vincula a outro bloco. Para vincular seu botão a qualquer outra coisa, use Botões.

Carrossel

Carrosséis são uma forma de visualizar opções, com ou sem imagens e botões.

Os botões em Carrosséis são os mesmos que os botões normais Botões e usam as mesmas propriedades, como payloads e URL, com a adição de um botão extra de compartilhamento.

Etapa de carrossel.

Você está usando Carrosséis no seu canal RCS? Veja como você pode aproveitá-los ao máximo.

Botão de compartilhar

O botão de compartilhar abre um bloco de compartilhamento no Facebook Messenger, permitindo que as pessoas compartilhem balões de mensagem (também conhecidos como cards de carrossel) com seus amigos.

Quando um novo usuário recebe um balão de mensagem, ele pode compartilhá-lo com seus amigos tocando no mesmo botão de compartilhar. Ao tocar no botão de postback, o usuário é levado para a página inicial do bot.

Você só pode usar o botão de compartilhar em itens de modelos genéricos (anteriormente chamados de carrosséis) e apenas itens com no máximo uma URL podem ser compartilhados pelo Facebook. Não é possível alterar o título do botão: o Facebook Messenger traduzirá o botão de acordo com a configuração de idioma preferida do perfil do usuário.

Lista

A etapa de Lista é uma etapa que permite apresentar uma lista de itens, exibida verticalmente.

Cada item pode mostrar um botão que pode ser usado como uma chamada para ação (postback). Você também pode fornecer uma URL que se abre quando um item é tocado.

Cada mensagem de modelo de lista também pode ter até um botão global que será exibido abaixo da lista de itens.

Estilos de lista

As listas podem ser exibidas em 2 estilos diferentes:

• Grande listas mostram o primeiro item com uma imagem de capa e sobreposição de texto. Isso é útil se você quiser destacar o primeiro item em relação aos outros.

• Compacta listas mostram cada item da mesma forma. Isso é útil para apresentar uma lista de itens em que nenhum item é exibido com mais destaque.

Envio de arquivo

Use o modelo de envio de arquivo para permitir que os usuários enviem um arquivo diretamente do dispositivo deles para o seu bot.

Este modelo só funciona no canal do widget da web V1. Para qualquer outro canal, você pode usar o tipo de formato 'image' na Coletar entrada bloco.

etapa de mensagem de envio de arquivo.

Configurar o envio de arquivo como mostrado acima exibirá um botão de upload na conversa:

Observações sobre envio de arquivo

• Se o envio falhar porque houve um problema com a conexão ou porque o arquivo escolhido pelo usuário era maior que 10 MB, o bot irá para o bloco "falha no envio".

• A URL onde o arquivo enviado é armazenado pode ser encontrada na {uploadedFileUrl} variável na sessão do usuário. Você pode reutilizar essa variável para mostrar o arquivo que o usuário enviou usando a Mídia etapa. Como alternativa, você pode recuperar a URL com um plugin de API para armazenar os arquivos em seus servidores.

• Os arquivos enviados são mantidos nos servidores do Chatlayer por 30 dias, após os quais ficarão automaticamente inacessíveis.

Texto rico

Rich text permite ir além das mensagens de texto e estilizar seu texto da maneira que quiser. Você também pode adicionar links da web usando o editor de rich text.

Rich text só é visível no Web canal. Os outros canais não suportam esse tipo de texto.

Etapa de mensagem rich text.

Estilos de rich text

O editor rich text permite usar os seguintes estilos:

• Parágrafo

• Título 1

• Título 2

• Título 3

• Título 4

• Lista com marcadores

• Lista ordenada (= lista numerada)

E formatar o texto das seguintes maneiras:

• Negrito

• Itálico

• Sublinhado

Você também pode adicionar hiperlinks (links da web) que levam a uma página externa ou a um local específico na sua conversa.

Para criar um hiperlink em uma palavra ou frase, selecione-a e depois clique no ícone de corrente à direita abaixo. Uma janela pop-up aparecerá onde você pode inserir o endereço do link. Depois, clique em 'salvar'.