Resposta do bot do Telegram

Acesse o Bot Manager no menu do lado esquerdo do painel e vá até a opção `Bot Reply`, lá você encontrará um botão `Create` localizado no canto superior direito. Para iniciar o processo de construção de um bot, selecione a conta do bot se você tiver vários bots conectados e então simplesmente clique no botão `Criar` garantindo que a opção `Resposta do Bot` esteja selecionada.

Editor do Construtor de Fluxo Visual

Posteriormente, o editor do Visual Flow Builder ficará acessível, apresentando duas seções distintas: o `Menu superior` e o `Editor`.

Depois de abrir o Flow Builder, você descobrirá que todos os componentes estão convenientemente consolidados no canto superior esquerdo da tela no `Menu superior`. Simultaneamente, na seção `Editor`, você notará que o componente `Start Bot Flow` já está pré-carregado para sua conveniência.

To construct a bot, follow these steps:

Arrastar e soltar componentes: comece arrastando os componentes do `Menu superior` e soltando-os na seção `Editor`.

Existem duas outras maneiras de adicionar um novo componente ao fluxo do bot:

Você pode arrastar do soquete e encontrar uma lista para adicionar um novo componente. (Adicione componentes sem arrastar do menu superior)

Você também pode adicionar componentes sem arrastar o componente do menu superior e soltá-lo no editor. Dos soquetes de qualquer componente, arraste o cursor e solte-o no editor.

Adicionar componentes ao seu chatbot é flexível e nem sempre requer arrastar do menu superior para o editor. Você também pode fazer isso diretamente dos soquetes de qualquer componente. Veja como:

Arrastar e soltar dos soquetes: nos soquetes de qualquer componente, basta arrastar o cursor e soltá-lo no editor.

Seleção de Componentes: Na maioria dos casos, esta ação exibirá instantaneamente um menu contendo vários componentes e um botão cancelar. Neste menu, você pode selecionar um componente, e ele aparecerá no editor, automaticamente conectado ao componente pai.

Opção Cancelar: Se você decidir não selecionar um componente e quiser fechar o menu suspenso, clique no botão Cancelar

Por exemplo, digamos que você arraste do próximo soquete de saída do componente de texto. Isso acionará um menu suspenso apresentando diferentes componentes, como texto, imagem, vídeo, áudio, arquivo, comércio eletrônico, fluxo de entrada do usuário e um botão Cancelar. Neste menu suspenso, você pode escolher o componente desejado. Caso deseje cancelar e não adicionar um componente, basta clicar no botão Cancelar.

Você pode clicar com o botão direito no editor e encontrará uma lista de componentes e poderá selecionar um componente a partir daí.

(Nesta documentação, empregamos uma variedade de abordagens, distintas desses três métodos, para criar bots)

Configuração: Configure esses componentes de acordo com suas necessidades.
Conectar componentes: estabeleça conexões entre os componentes para criar um fluxo funcional.

Iniciar fluxo de bot

Na seção `Editor`, você encontrará um elemento crucial conhecido como `Iniciar Fluxo do Bot`. Este componente serve como base para a construção do seu bot. Dos dez campos, `Keyword Triggering`, `Matching Type` e `Title` são de preenchimento obrigatório. Você pode usar outros campos se precisar deles.

Para configurar este elemento, você deve saber:

Acionamento de palavras-chave: para iniciar o bot usando palavras-chave específicas, clique duas vezes no elemento `Iniciar fluxo do bot`. Esta ação abrirá a barra lateral esquerda `Configurar Referência`, com dez campos e dois botões. No campo de palavras-chave, adicione palavras-chave e separe-as com vírgulas ao adicionar mais de uma palavra-chave. Quando um usuário insere um texto na janela de mensagens que corresponda a qualquer uma dessas palavras-chave, o bot será ativado

Tipo de correspondência: Você pode escolher o tipo de correspondência clicando em um dos dois botões fornecidos: `Correspondência exata de teclado` ou `Correspondência de string`. Por padrão, `Correspondência exata do teclado` está selecionado. Com esta opção, o bot será iniciado somente se a entrada do usuário corresponder exatamente à palavra-chave. Por outro lado, com `String Match`, o bot será acionado se a entrada do usuário corresponder parcialmente à palavra-chave.

Título: Atribua um título ao seu bot no campo `Título`. Este título é simplesmente um nome para o seu bot.

Adicione rótulos: utilize rótulos para categorizar seu público em diferentes segmentos, como dados demográficos, interesses ou histórico de compras. Isso permite mensagens e campanhas direcionadas sob medida para cada grupo, melhorando o engajamento e as conversões. (Você pode criar um novo rótulo clicando em `+ Novo` se necessário).
Remover rótulos: se necessário, você pode remover rótulos dos usuários usando este campo.

Assine a sequência: as sequências permitem que você envie uma série de mensagens automatizadas aos assinantes do chatbot ao longo do tempo. Isso pode ser útil para integrar novos assinantes, estimular leads, promover produtos ou reengajar assinantes inativos. (você encontrará mais informações sobre isso na seção de sequência desta documentação)

Cancelar inscrição de sequência: Este campo permite cancelar a inscrição de um usuário em qualquer sequência.
Atribuir conversa a um grupo: atribua conversas a grupos específicos da sua organização. Por exemplo, você pode atribuir uma conversa ao seu grupo executivo, permitindo que qualquer membro desse grupo cuide dela.

Atribuir conversa a um usuário: atribua conversas a membros individuais da equipe. Por exemplo, você pode atribuir uma conversa ao seu gerente, designando-o como o responsável.
Enviar dados para URL do webhook: adicione o link do seu webhook para enviar dados do bot para um URL especificado. Isso facilita o armazenamento de dados por meio da integração de webhook.

Webhook: webhook é um recurso que permite conectar seu bot de telegrama a sistemas ou serviços externos, possibilitando a transmissão automática de dados e a comunicação entre seu bot e outros softwares compatíveis. Essa integração ajuda a automatizar processos e aprimora a funcionalidade do seu chatbot.

Depois de preencher esses campos de acordo com suas necessidades, clique no botão `Salvar` para salvar suas configurações. Se necessário, você também pode usar o botão `Fechar` para cancelar o processo de configuração.

Etapas simples de configuração do Start Bot Flow:

Vá para o `Gerenciador de bots`.

Selecione seu bot.

Escolha `Resposta do Bot`.

Clique em `Criar`.

Clique duas vezes em `Iniciar fluxo do bot`.

Insira suas palavras-chave separadas por vírgula.

Escolha entre `Correspondência exata do teclado` ou `Correspondência de string`.

Forneça um título para o seu bot.

Adicione um rótulo (você pode criar um novo clicando em `+ Novo` se necessário).

Selecione uma sequência, se desejar (você também pode criar uma nova sequência aqui).

Atribua a conversa a um grupo com base nas funções da equipe (se necessário).

Atribua a conversa a um membro específico da equipe (se necessário).

Inclua um URL do Webhook se quiser enviar dados para um webhook.

Salve suas alterações clicando no botão `Salvar` ou cancele-as usando o botão `Cancelar`.

Depois de concluir a configuração do `Start Bot Flow`, você verá um soquete chamado `Compose Next Message`. Esses soquetes permitem adicionar vários componentes de resposta. Após adicionar componentes, devemos configurá-los adequadamente.

Para o soquete `Compose Next Message`, você pode adicionar texto, imagens, áudio, vídeo ou componentes de arquivo e configurá-los da seguinte forma:

Uso do componente de texto:

Digite sua mensagem de resposta no campo `Forneça sua mensagem de resposta`. Utilize a opção `Atraso na resposta` se precisar atrasar a resposta à mensagem do cliente.

Porém, em certas situações, ao invés de exibir um menu de lista com vários componentes, um único componente aparecerá já conectado ao componente pai.

Por exemplo, se você arrastar do soquete de saída do botão do componente de texto e soltá-lo no editor, o componente do botão aparecerá imediatamente no editor, já vinculado ao componente pai.

The Button component is not present in the Top-menu.

Clonar e excluir componente

Sinta-se à vontade para duplicar ou remover componentes a qualquer momento. Tudo que você precisa fazer é clicar com o botão direito no componente que deseja gerenciar. Isso irá acionar um menu suspenso com duas opções: `Clone` e `Delete`. Opte por `Clone` para criar uma cópia do componente ou escolha `Excluir` para removê-lo permanentemente de sua configuração.

Texto

Para construir um bot com um elemento de texto, siga estas etapas:

Adicionando Componente de Texto: Comece arrastando o `Componente de Texto` das opções disponíveis e soltando-o no editor.

Configuração: Clique duas vezes no componente de texto, que exibirá uma barra lateral chamada `Configurar mensagem de texto`. Dentro desta barra lateral, você encontrará um campo de texto.

Entrada de mensagem: No campo de texto, você pode inserir sua mensagem de resposta. Aqui, você também tem a capacidade de incluir elementos dinâmicos como o nome, sobrenome do usuário ou variáveis de campo personalizadas na mensagem de resposta para personalizar a interação.

Agora clique no botão Salvar e as informações aparecerão no componente. Em seguida, conecte o componente de texto ao componente Iniciar fluxo do bot.

Ao selecionar Atraso na resposta você pode definir o tempo de atraso da sua resposta.

Incluir variáveis personalizadas na mensagem de resposta

Você também pode inserir variáveis personalizadas em sua mensagem de resposta. Clique no botão `Personalizado`, selecione uma variável no menu suspenso e ela será substituída pelo valor real antes de enviar a mensagem.

Componente de imagem, áudio, vídeo e arquivo:

Da mesma forma, você tem a opção de incorporar componentes de imagem, áudio, vídeo e arquivo em seu chatbot. Para usar esses componentes, você precisará fazer upload da imagem, áudio, vídeo ou arquivo correspondente. Posteriormente, você poderá estabelecer conexões entre esses componentes e outros elementos, conforme necessário.

Em resumo, aqui está um guia rápido para adicionar e configurar vários componentes para o seu Chabot:

Componente de texto:

Adicione um componente de texto e clique duas vezes nele.
No campo `Mensagem de resposta`, digite a resposta desejada.

Definir atraso na resposta (se necessário)

Componente de imagem:

Adicione um componente `Image` do menu superior.

Defina a imagem, você pode usar uma URL da imagem ou apenas fazer upload de uma imagem.

Componente de vídeo:

Adicione um componente `Video` no menu superior.

Clique duas vezes no componente Vídeo e defina um vídeo usando seu URL ou enviando um.

Componente de áudio:

Adicione um componente `Áudio` no menu superior.

Clique duas vezes no componente Áudio e defina um áudio usando seu URL ou fazendo upload de um.

Componente de arquivo:

Adicione um componente `Arquivo` no menu superior.

Clique duas vezes no componente Arquivo e defina um arquivo usando seu URL ou fazendo upload de um.

Este guia simples irá ajudá-lo a configurar esses componentes de forma rápida e eficaz para o seu chatbot.

Teclado

Você também tem a opção de incorporar um componente de teclado ao seu bot. Este componente específico foi projetado para coletar números de telefone e locais de usuários.

A configuração do componente Teclado é a seguinte:

Para incluir este componente, basta arrastar o cursor do `soquete do botão do teclado` dos componentes Texto, Imagem, Áudio, Vídeo ou Arquivo e soltá-lo no editor. Esta ação introduzirá imediatamente um componente Teclado conectado ao componente pai.

Em seguida, clique no campo dentro do componente Teclado. Isso acionará um menu suspenso, apresentando opções para coletar números de telefone ou informações de localização.

Comércio eletrônico

O componente Ecommerce é um recurso fácil de usar de arrastar e soltar que facilita a integração perfeita entre seu bot do Telegram e uma loja de comércio eletrônico. Esse poderoso recurso permite que você estabeleça uma experiência abrangente de loja online diretamente na interface do bot do Telegram. (Você encontrará mais informações sobre comércio eletrônico na seção Comércio eletrônico na documentação)

A configuração do recurso Comércio eletrônico é realizada por meio das seguintes etapas:

Comece arrastando o componente Comércio eletrônico do menu superior e soltando-o no editor.

Clique duas vezes no componente Comércio eletrônico para acessar suas configurações. Aqui você pode:

Selecione sua loja de comércio eletrônico específica no campo `Selecione sua loja de comércio eletrônico`.
Opcionalmente, adicione um `Botão Comprar agora` especificando o texto desejado no campo `Texto do botão Comprar agora`.
Se necessário, defina uma mensagem personalizada usando o campo `sua mensagem de resposta`.

Para finalizar, você pode fornecer uma mensagem final para completar a interação. Para fazer isso, arraste o cursor do soquete `Next` do componente Ecommerce e selecione o componente de texto. Em seguida, digite sua mensagem final.

Condição

O componente Condition, disponível na plataforma, permite que os usuários criem bots inteligentes orientados por lógica condicional. Com este recurso, os usuários podem estabelecer critérios precisos que devem ser satisfeitos para que determinadas ações ou respostas sejam executadas dentro de um chatbot.

A configuração do componente Condição envolve as seguintes etapas:

Comece arrastando o componente Condição do menu superior e colocando-o no editor.

Nas configurações do componente Condição, os usuários têm a opção de usar dois botões de opção: `All Match` e `Any Match`. Estas opções determinam se todas as condições especificadas devem ser satisfeitas simultaneamente ou se alguma delas é adequada para iniciar uma acção ou resposta específica.

Além disso, você pode aplicar condições aos dados do campo do sistema e aos campos personalizados, selecionando a condição desejada utilizando o campo do operador.

Para implementar esta funcionalidade, siga estas etapas:

Adicione dois elementos de texto ao fluxo do chatbot.
Conecte um desses elementos Text ao soquete `True` do componente Condition e o outro ao soquete `False`.
Clique no elemento Text conectado ao soquete `True` para redigir uma mensagem informando ao usuário que informações atualizadas serão enviadas para seu endereço de e-mail.
Clique no outro elemento Text conectado ao soquete `False` para criar uma mensagem notificando o usuário de que o sistema atualmente não possui seu endereço de e-mail. Nesse caso, o bot pode solicitar ao usuário seu endereço de e-mail usando uma mensagem User Input Flow.
Se a condição for avaliada como verdadeira, a mensagem do elemento Text conectado ao soquete `True` será enviada aos usuários cujos endereços de e-mail já estejam no sistema.
Se a condição for avaliada como falsa, você pode conectar uma mensagem do User Input Flow ao elemento Text conectado ao soquete `False`. Esta mensagem de fluxo de entrada do usuário solicitará que o usuário forneça seu endereço de e-mail, que pode então ser salvo no sistema ou em uma variável de campo personalizada, conforme necessário.

Nova sequência

O recurso Nova Sequência é um recurso integrado à plataforma, projetado para capacitar os usuários a criar e personalizar sequências de mensagens ou ações para chatbots em plataformas de mensagens. Este recurso visa elevar a qualidade das interações entre chatbots e usuários, permitindo a automação de uma sequência de respostas ou ações, acionadas por entradas do usuário ou gatilhos predefinidos.

Em termos práticos, permite configurar uma série de mensagens que são enviadas em intervalos de tempo precisos, garantindo que a comunicação com os utilizadores se mantém oportuna e contextualmente relevante.

Configurar uma sequência envolve várias etapas:

Comece clicando duas vezes no elemento `Start Bot Flow`. No menu pop-up, você encontrará a opção `Inscrever-se na sequência`. Clique nesta opção e uma nova sequência será criada. Salve suas alterações.

Após salvar, você notará que uma sequência foi gerada com sucesso.

Clique duas vezes em `Novas campanhas de sequência`. Nesta etapa, especifique um nome para sua campanha de sequência preenchendo o campo `Nome da campanha de sequência`.

Para determinar o tempo de entrega de suas mensagens em série, use o campo `Horário de entrega preferencial para mensagens agendadas fora da janela de 24 horas`. Você pode escolher entre horários predefinidos ou inserir manualmente o horário de entrega preferido.

Selecione o fuso horário desejado no campo `Fuso horário` para garantir um agendamento preciso de suas mensagens.

Ao concluir as etapas anteriores, você descobrirá três componentes adicionais `Enviar mensagem após` no construtor de fluxo.

Veja como configurá-los:

Clique duas vezes no componente `Enviar mensagem após`. Dentro deste componente, você encontrará dois botões de opção:

`Agendar mensagem dentro da janela de 24 horas`: Este botão inicia a sequência para começar dentro de um período de 24 horas.

`Agendar mensagem para sequência diária`: Este botão define a sequência para começar fora da janela de 24 horas.

O componente `Schedule Message After` é empregado para estabelecer o agendamento de mensagens dentro de um dia. Clique no menu pop-up para acessar os horários predefinidos ou, alternativamente, você pode definir manualmente o horário de agendamento.

Além disso, é importante observar que você pode incluir várias sequências em um único `Flow Builder` utilizando o botão designado. A configuração de sequências adicionais segue um processo semelhante ao descrito aqui.

Fluxo de entrada do usuário

O fluxo de entrada do usuário é um recurso poderoso que facilita a coleta de dados dos usuários por meio de interações conversacionais naturais. Com esse recurso, você pode criar fluxos interativos para fazer perguntas aos usuários e armazenar suas respostas em campos personalizados. Esses dados coletados podem então ser aproveitados para personalizar experiências do usuário, segmentar assinantes ou exportar informações para um arquivo CSV.

Para criar um fluxo de entrada do usuário, primeiro você precisa estabelecer uma campanha de fluxo de entrada do usuário. Esta campanha serve como contêiner para as perguntas que você deseja fazer aos usuários e os campos personalizados onde suas respostas serão armazenadas.

Depois que sua campanha de fluxo de entrada do usuário estiver implementada, você poderá integrá-la perfeitamente ao fluxo do seu bot. Quando um usuário encontrar o componente User Input Flow no fluxo do seu bot, ele receberá as perguntas definidas em sua campanha. Suas respostas serão registradas automaticamente nos campos personalizados especificados.

Os fluxos de entrada do usuário oferecem recursos versáteis de coleta de dados. Você pode usá-los para coletar uma ampla variedade de informações do usuário, como nomes, endereços de e-mail, números de telefone ou preferências do usuário para produtos e serviços, tudo por meio de uma abordagem de conversação natural.

A configuração do fluxo de entrada do usuário envolve as seguintes etapas:

Comece arrastando o componente `User Input Flow` do menu superior ou, alternativamente, selecione-o no menu de soquete. Existem duas opções para adicionar este componente ao seu fluxo.

Clique duas vezes no componente `User Input Flow`. Na janela pop-up, você encontrará dois campos:

Nome da campanha de entrada do usuário: insira um nome para sua campanha neste campo.
Enviar dados para URL do Webhook: Se desejar, você pode salvar os dados de entrada em seu Webhook.

Depois de salvar o `Fluxo de entrada do usuário`, um componente `Nova pergunta` aparecerá automaticamente no fluxo. Como alternativa, você pode arrastar o soquete chamado `Primeira pergunta` e colocá-lo no fluxo do bot para revelar o componente `Nova pergunta`.

Clique duas vezes no componente `Nova pergunta` para acessar dois botões: `Entrada de teclado livre` e `Múltipla escolha`. Esses botões determinam o tipo de perguntas que você deseja fazer.

Free Keyboard Input: In this button user can answer the question by using open keyboard.

Múltipla escolha: Neste botão o usuário obtém respostas pré-escritas. Apenas o seu cliente precisa selecionar respostas predefinidas.

Escolher `Free Keyboard Input` apresentará várias opções:

Aqui estão os detalhes para configurar o componente `Nova Pergunta`:

Campo de pergunta: é aqui que você pode inserir sua pergunta

Tipo de resposta: Este campo determina o tipo de respostas permitidas em seu banco de dados.

Salvar no campo personalizado: você pode armazenar os dados de resposta em uma tabela de dados específica especificada por você. Se precisar de um novo campo personalizado, você pode criar um clicando no botão `Adicionar novo`.

Adicionar novo: Para criar um novo campo personalizado, clique em `Adicionar novo`. Você será solicitado a fornecer um nome no campo `Nome do campo personalizado`, definir o `Tipo de resposta` e clicar em `Salvar`. Isso criará um novo campo personalizado.

Use o novo campo personalizado adicionado: Depois de criar um novo campo personalizado, você pode selecioná-lo no menu pop-up `Salvar no campo personalizado`.

Campo Salvar no sistema: No sistema, existem tabelas de dados pré-existentes que você pode utilizar sem criar novas. Basta clicar no menu pop-up `Salvar no campo do sistema` e escolher a tabela de dados que deseja usar.

Enviar dados para o URL do webhook: para enviar dados do bot para um URL específico, adicione o link do seu webhook. Este recurso simplifica o armazenamento de dados por meio da integração de webhook

Multiple choice

Opte por `Múltipla Escolha` e um novo conjunto de campos ficará disponível para configuração:

Campo de pergunta: use este campo para elaborar a pergunta que deseja fazer ao usuário.

Opção: Nesta seção, você pode fornecer respostas predefinidas. Os usuários podem selecionar uma dessas opções pré-determinadas. Para incluir várias opções, basta clicar em `Adicionar mais`.

Tipo de resposta: Utilize este campo para especificar o tipo de resposta que você prevê e pretende armazenar em seu banco de dados.

Salvar no campo personalizado: você tem a opção de armazenar os dados da resposta em uma tabela de dados específica especificada por você. Se você precisar de um novo campo personalizado, ele poderá ser criado clicando no botão `Adicionar novo`.

Adicionar novo: Este recurso permite estabelecer um novo campo personalizado. Ao selecionar `Adicionar novo`, você será solicitado a inserir um nome no campo `Nome do campo personalizado`, definir o `Tipo de resposta` e clicar em `Salvar` para gerar um novo campo personalizado.

Use o novo campo personalizado adicionado: Depois de criar um novo campo personalizado, você pode escolhê-lo no menu pop-up `Salvar no campo personalizado`.

Campo Salvar no sistema: Dentro do sistema, tabelas de dados pré-definidas ficam disponíveis para utilização, dispensando a necessidade de criação de novas. Basta acessar o menu pop-up `Salvar no campo do sistema` e designar a tabela de dados que deseja empregar.

Enviar dados para o URL do Webhook: para transmitir dados do bot para um URL designado, insira o link do seu webhook. Este recurso agiliza o armazenamento de dados por meio da integração de webhook.