Resposta do bot do Telegram

Access the Bot Manager from the dashboard’s left side menu and head to the `Bot Reply` option, there you'll find a `Create` button located in the upper right-hand corner. To initiate the process of constructing a bot, select the bot account if you have multiple bots connected and then simply click on the `Create` button while ensuring that the `Bot Reply` option is selected.

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`.

Once you've open the Flow Builder, you'll find that all the components are conveniently consolidated at the upper-left corner of your screen in the `Top menu`. Simultaneously, within the `Editor` section, you'll notice that the `Start Bot Flow` component is already preloaded for your convenience.

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.

Adding components to your chatbot is flexible and doesn't always require dragging from the Top-menu to the editor. You can also do it directly from the sockets of any component. Here's how:

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

For instance, let's say you drag from the next output socket of the text component. This will trigger a drop-down menu showcasing different components such as Text, Image, Video, Audio, File, Ecommerce, User Input Flow, and a Cancel button. From this drop-down menu, you can choose your desired component. If you wish to cancel and not add a component, simply click on the Cancel button.

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

(In this documentation, we've employed a variety of approaches, distinct from these three methods, for creating 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

Matching Type: You can choose the matching type by clicking on one of the two buttons provided: `Exact Keyboard Match` or `String Match`. By default, `Exact Keyboard Match` is selected. With this option, the bot will start only if the user's input matches the keyword exactly. In contrast, with `String Match`, the bot will trigger if the user's input partially matches the keyword.

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.

Once you've filled out these fields according to your requirements, click the `Save` button to save your settings. If needed, you can also use the `Close` button to cancel the configuration process.

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`.

Once you've completed the `Start Bot Flow` setup, you'll see a socket called `Compose Next Message`, These sockets allows you to add various reply components. After adding components, we must configure them accordingly.

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.

Configuration: Double-click on the text component, which will prompt the appearance of a sidebar labeled `Configure Text Message`. Within this sidebar, you'll find a text field.

Message Input: In the text field, you can input your reply message. Here, you also have the capability to include dynamic elements like the user's first name, last name, or custom field variables within the reply message to personalize the interaction.

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:

Similarly, you have the option to incorporate image, audio, video, and file components into your chatbot. To use these components, you'll need to upload the corresponding image, audio, video, or file. Afterward, you can establish connections between these components and other elements as needed.

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.
Click on the other Text element connected to the `False` socket to craft a message notifying the user that the system doesn't currently possess their email address. In this case, the bot can prompt the user for their email address using a User Input Flow message.
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:

Begin by double-clicking on the `Start Bot Flow` element. Within the pop-up menu, you'll find the option to `Subscribe to Sequence`. Click on this option, and a new sequence will be created. Save your changes.

After saving, you'll notice that a sequence has been successfully generated.

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.

Here's how to configure them:

Double-click on the `Send Message After` component. Within this component, you'll encounter two radio buttons:

`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.

Moreover, it's important to note that you can include multiple sequences within a single `Flow Builder` by utilizing the designated button. Setting up additional sequences follows a similar process to the one described here.

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.

To create a User Input Flow, you'll first need to establish a User Input Flow campaign. This campaign serves as the container for the questions you want to ask users and the custom fields where their answers will be stored.

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 Added new Custom field: Once you've created a new custom field, you can select it from the `Save to Custom Field` pop-up menu.

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`.

Add New: This feature allows you to establish a fresh custom field. By selecting `Add New`, you'll be prompted to enter a name in the `Custom Field Name` field, set the `Reply Type`, and then click `Save` to generate a new custom field.

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.