Elementos de Conteúdo

O Botpress inclui seu próprio Sistema de Gerenciamento de Conteúdo (ou CMS) para gerenciar o conteúdo de um chatbot. Tudo o que seu chatbot diz vem do CMS.

Antes de começarmos a discutir como é possível criar e editar o conteúdo do seu chatbot, é necessário entender os diferentes conceitos do CMS no Botpress.

Um tipo de conteúdo define a estrutura do que o chatbot envia. Ele também determina como seu chatbot deve renderizar o conteúdo. Pode ser tão simples ou tão complexo quanto quiser.

Por exemplo, um tipo de conteúdo pode ser um texto simples, uma imagem ou um carrossel.

Os tipos de conteúdo são específicos dos chatbots aos quais estão associados.

Aqui estão alguns exemplos típicos:

Como é mostrado, os tipos de conteúdo no Botpress são muito mais específicos do que os "tipos de mensagem" generalizados nas plataformas tradicionais de criação de chatbots.

Os desenvolvedores definem os tipos de conteúdo em JavaScript. Cada tipo de conteúdo tem seu próprio .jsarquivo, e o Botpress encontra e registra automaticamente novos tipos de conteúdo com base no diretório e na convenção de nomenclatura do arquivo.

Um elemento de conteúdo contém os dados de um tipo de conteúdo. Vários elementos podem pertencer a um único tipo de conteúdo.

Por exemplo, o tipo de conteúdo "texto" incluirá um elemento para cada frase do seu Bot.

Todos os elementos de conteúdo do mesmo tipo de conteúdo são armazenados em um único .json arquivo no data/bots/{your-bot}/content-elements/ diretório.

É possível adicionar e editar conteúdo de duas maneiras:

É possível adicionar conteúdo ao criar um nó no Editor de fluxo.

Na Interface do Botpress Studio, é possível adicionar conteúdo ao seu chatbot.

A interface de conteúdo é útil para a separação de interesses.

Caso queira que um colaborador não técnico examine o conteúdo, edite-o quanto à gramática e crie o tom desejado para o seu chatbot.

Seus chatbots podem suportar vários idiomas. Se uma tradução específica não estiver disponível para o idioma atual, o chatbot usará o idioma padrão.

Quando um usuário conversa com seu chatbot, extraímos o idioma do navegador e o salvamos como um atributo de usuário (disponível no evento como user.language).

Depois que a user.languagepropriedade for definida, ela não será substituída. Portanto, é necessário perguntar ao usuário qual é seu idioma preferido ou usar o mecanismo NLU para detectá-lo.

Ao renderizar elementos de conteúdo, tentaremos renderizar o idioma configurado pelo usuário; caso contrário, ele usará o padrão do chatbot.

Este botão aciona uma ação, frequentemente usada em cartas. É possível adicionar dois parâmetros a este botão, a saber:

Permite fazer upload de um arquivo de áudio mp3. O arquivo poderá ser reproduzido no chat.

Um cartão é uma mensagem com um título e uma legenda opcional. Ele também contém uma imagem e botões de ação. Observe que no primeiro é necessário criar o botão de ação separadamente.

Um carrossel é um conjunto de cartas. Essa coleção de cartões pode ser apresentada como um slide de rolagem horizontal ou uma pilha de mensagens vertical, dependendo do canal.

Atualmente, o tipo de conteúdo do arquivo é suportado apenas pelo channel-vonage. Ele permite o upload de um arquivo .pdf que o usuário pode baixar do chat. Além disso, é possível adicionar um título opcional que aparecerá como uma mensagem no arquivo.

Ao carregar um arquivo de uma url variável, talvez seja necessário utilizar chaves triplas para liberar a url, ou seja, {{{temp.fileUrl}}}.

Para mostrar uma imagem com um título opcional na janela de bate-papo, é possível usar o elemento de conteúdo Imagem. Os formatos de imagem suportados são .tiff, .jpg, .png, .jpeg, .gif, .bmp, .tif.

Ao carregar uma imagem de uma url variável, talvez seja necessário usar chaves triplas para liberar a url, ou seja, {{{temp.imageUrl}}}.

Atualmente, o tipo de conteúdo de localização é suportado apenas por channel-vonage. Ele gera uma mensagem mostrando um local com um endereço e título opcionais.

Os parâmetros necessários para completar este elemento de conteúdo são longitude e latitude.

Este componente carrega uma mensagem, geralmente uma pergunta, e sugere escolhas ao usuário para cumprir a mensagem. O usuário pode escolher apenas uma opção e, ao selecionar a preferência, é possível instruir seu chatbot a obter um valor personalizado.

O tipo de conteúdo de texto denota uma mensagem de texto normal com indicadores de digitação opcionais e alternativas. É possível usar markdown em seu texto para adicionar formatação e estilo, mas certifique-se de que o canal de destino possa renderizar esse texto.

É possível escrever HTML no conteúdo de texto no canal da web e seu chatbot irá renderizá-lo corretamente. Isso abre a possibilidade de incluir iFrames e construir páginas da Web em miniatura (comumente conhecidas como visualizações da Web) em seu conteúdo sem criar componentes personalizados.

O tipo de conteúdo de vídeo apresenta uma mensagem mostrando um arquivo de vídeo com um título opcional. É possível enviar o vídeo ou vincular a um arquivo de vídeo que será obtido quando o elemento de conteúdo for invocado.

Ao carregar um vídeo de um URL variável, pode ser necessário usar chaves triplas para liberar o URL, ou seja, {{{temp.videoUrl}}}.

A lista suspensa exibe uma lista de opções para o usuário. Ele inclui uma mensagem para o usuário e é possível personalizar o texto do marcador de posição suspenso e o texto exibido no botão de seleção.