Links

Mensagem de bot

Para projetar seu fluxo de conversação, você pode usar vários componentes, como mensagens de texto, botões e carrosséis. Dependendo do canal em que você publica o bot (Facebook Messenger, web, Slack, Telegram, ...), eles serão exibidos de forma um pouco diferente.
Limites de caracteres
Quando você está construindo seus fluxos, nossa plataforma lhe dá conselhos sobre quantos caracteres você pode usar em botões, mensagens de texto etc.
Para o Facebook Messenger, esses são limites rígidos, o que significa que se você adicionar um rótulo de botão com mais de 20 caracteres, ele será cortado e mostrado com "..." Por exemplo: o rótulo "olá, sou um botão, clique em mim" será mostrado como "olá, sou um botão ..."
Para todos os outros canais, o limite de caracteres é baseado nas práticas recomendadas. Recomendamos usar menos caracteres do que o limite, mas não é obrigatório.

Mensagens de Texto

As mensagens de texto são os componentes mais simples. A maioria dos canais os mostra como 'bolhas de texto'.

Botões

Os botões são uma forma útil de orientar a conversa, fornecendo ao usuário um conjunto limitado de opções. Você pode adicionar no máximo três botões a uma mensagem.

Tipos de botão

Próximo diálogo do bot
Para cada botão, você precisa definir um próximo estado de diálogo. Opcionalmente, você pode adicionar combinações de valores-chave a um botão. Isso definirá variáveis dependendo de qual botão o usuário clicou. Essas variáveis podem ser usadas posteriormente para rotear estados de diálogo, fazer uma chamada de API ou renderizar um texto específico.
URL
Você pode vincular um botão a um URL externo.
Chamada
Este botão iniciará uma chamada se o usuário estiver usando um dispositivo móvel.

Mídia

Com o modelo de Mídia, você pode habilitar o bot para enviar arquivos aos seus usuários.
Se você carregar o arquivo diretamente na plataforma, há um limite de tamanho de arquivo de 10 MB. Se você usar um URL direto para o arquivo, não haverá limite de tamanho de arquivo.
Imagens
Todos os tipos de imagem típicos, como jpg, png e gif são suportados em nossa plataforma.
Vídeo
Os vídeos estão disponíveis no Emulador, widget da web e canal do Facebook. Os seguintes formatos de vídeo são suportados:
  • mp4
  • ogv
  • webm
Um recurso interessante do Facebook Messenger é que as pessoas podem compartilhar um vídeo com seus amigos clicando no botão à direita do vídeo:
Você está tendo problemas para adicionar um vídeo externo ao seu bot? Confira este artigo.
Áudio
O widget de áudio está disponível no Emulador, no widget da web e no Facebook Messenger. Atualmente, só oferecemos suporte a MP3 como formato de áudio.
Arquivos
Os anexos de arquivo estão disponíveis no Facebook Messenger. Atualmente, apenas PDF é compatível.
Recomendamos que os arquivos de mídia compartilhados no Facebook Messenger tenham menos de 5 MB, pois o Facebook parece ter problemas para lidar com arquivos grandes com desempenho aceitável.

Respostas rápidas

As respostas rápidas se comportam de maneira semelhante aos botões. Eles são mostrados horizontalmente um ao lado do outro em um contêiner rolável. Isso significa que você pode adicionar quantas respostas rápidas achar necessário.
Cargas
Para cada resposta rápida, você precisa definir um próximo estado de diálogo. Opcionalmente, você pode adicionar combinações de valores-chave. Isso definirá variáveis dependendo de qual botão o usuário clicou. Essas variáveis podem ser usadas posteriormente para rotear estados de diálogo, fazer uma chamada de API ou renderizar um texto específico.
URL
As respostas rápidas suportam apenas os próximos estados de diálogo, sem links para sites externos. Você pode usar um botão para isso.
Ícone
Opcionalmente, você pode adicionar um ícone a uma resposta rápida especificando seu URL.
Localização
Este botão salvará sua localização em uma variável definida. Certifique-se de definir o idioma para todos os dados relacionados à localização.

Carrossel

Carrosséis são uma forma de visualizar as opções por meio de imagens. Cada opção pode ter até três botões com ações separadas, mas isso não é obrigatório. Esses botões são os mesmos botões do modelo de botão e usam as mesmas propriedades, como cargas úteis e URL, com a adição de um botão de compartilhamento extra.
O Facebook renomeou o modelo 'Carrossel' para 'Modelo Genérico'. Você pode ler mais sobre suas diretrizes para Modelos Genéricos aqui.
Botão de compartilhamento
O botão de compartilhamento abre uma caixa de diálogo de compartilhamento no Facebook Messenger, permitindo que as pessoas compartilhem bolhas de mensagens (também conhecidas como cartões 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 compartilhamento. Ao tocar no botão de postback, o usuário é enviado para a página inicial do bot.
Você só pode usar o botão de compartilhamento em itens de modelos genéricos (anteriormente chamados de carrosséis) e apenas itens com no máximo um url podem ser compartilhados pelo Facebook. Não é possível alterar o título do botão: O Facebook Messenger irá traduzir o botão para a configuração do perfil de idioma preferido do usuário.

Lista

O Modelo de Lista é um modelo que permite apresentar uma lista de itens, exibida verticalmente.
Cada item pode mostrar um botão que pode ser usado como uma frase de chamariz (postback). Você também pode fornecer um URL que abre quando um item é tocado.
Cada mensagem de modelo de lista também pode ter até um botão global que aparecerá abaixo da lista de itens.

Estilos de lista

As listas podem ser mostradas de duas maneiras diferentes: Grande e Compacto.
Grande
Listas grandes mostram o primeiro item com uma imagem de capa e sobreposição de texto. Isso é útil se você quiser fazer o primeiro item se destacar sobre os outros itens.
Compacto
Listas compactas mostram cada item da mesma maneira. Isso é útil para apresentar uma lista de itens onde nenhum item é mostrado com mais destaque.

Upload de arquivo

Use o modelo de upload de arquivo para permitir que os usuários carreguem um arquivo diretamente de seus dispositivos para o seu bot.
Configurar o upload do arquivo conforme mostrado acima mostrará um botão Upload na conversa:
Se o upload falhou porque houve um problema com a conexão, ou o arquivo que o usuário escolheu era maior que 10 MB, o bot irá para a caixa de diálogo do bot "falha no upload"
O URL onde o arquivo carregado está armazenado pode ser encontrado na variável {UrlArquivoUpload} na sessão do usuário. Você pode reutilizar essa variável para mostrar o arquivo que o usuário carregou usando o modelo de Mídia. Como alternativa, você pode recuperar o URL com um plugin de API para armazenar os arquivos em seus servidores.

Rich text

O rich text permite que você vá além das mensagens de texto e estilize seu texto da maneira que desejar. Você também pode adicionar links da web usando o editor de rich text.
O rich text só é visível no canal do Chat Widget Os outros canais não suportam este tipo de texto.
O editor de rich text permite que você use 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 formate o texto das seguintes maneiras:
  • Negrito
  • Itálico
  • Sublinhado
Você também pode adicionar hiperlinks (links da web) que vão para uma página externa ou para um lugar específico em sua conversa.
Inserindo um link usando rich text
Para criar um hiperlink para uma palavra ou frase, selecione-a e clique no ícone de corrente à direita abaixo. Um pop-up aparecerá onde você pode colocar o endereço do link. Em seguida, clique em 'Salvar'.