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 Visual Flow Builder

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.

Para construir um bot, siga estes passos:

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

Há duas outras maneiras de adicionar um novo componente no fluxo do seu 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 Top-menu e soltá-lo no editor. Dos sockets 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 de cancelamento. A partir deste menu, você pode selecionar um componente, e ele aparecerá no editor, conectado automaticamente ao componente pai.

Opção Cancelar: Se você decidir não selecionar um componente e quiser descartar 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 do mouse no editor e encontrará uma lista de componentes e poderá selecionar um componente de lá.

(In this documentation, we've employed a variety of approaches, distinct from these three methods, for creating bots)

Realização de pesquisas: Chatbots podem coletar feedback do cliente e dados de pesquisa via SMS. Configuração: Configure esses componentes de acordo com seus requisitos.
Conectar componentes: estabeleça conexões entre os componentes para criar um fluxo funcional.

Iniciar fluxo de bot

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

Para configurar este elemento, você deve saber:

Acionamento por palavra-chave: para iniciar o bot usando palavras-chave específicas, clique duas vezes no elemento `Start Bot Flow`. Esta ação abrirá a barra lateral esquerda `Configure Reference`, com dez campos e dois botões. No campo de palavra-chave, adicione palavras-chave e separe-as com vírgulas quando adicionar mais de uma palavra-chave. Quando um usuário insere texto na janela de mensagens que corresponde 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 seu bot.

Adicionar 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 direcionadas e campanhas adaptadas a 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.

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

Cancelar inscrição da sequência: este campo permite que você cancele 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 a parte responsável.
Enviar dados para URL do webhook: adicione seu link do webhook para enviar dados do bot para uma URL específica. Isso facilita o armazenamento de dados por meio da integração do webhook.

Webhook: webhook é um recurso que permite que você conecte seu bot do Telegram a sistemas ou serviços externos, permitindo 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 para configurar o 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 de bot`.

Insira suas palavras-chave separadas por vírgulas.

Escolha entre `Correspondência exata de 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 uma URL de 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 maneira:

Uso do componente de texto:

Insira sua mensagem de resposta no campo `Please provide your reply message`. Utilize a opção `Delay in reply` se precisar introduzir um atraso em sua resposta à mensagem do cliente.

Entretanto, em certas situações, em vez de exibir um menu de lista com vários componentes, um único componente aparecerá já conectado ao componente pai.

Por exemplo, se você arrastar o componente de texto do soquete de saída do botão e soltá-lo no editor, o componente de 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 o que você precisa fazer é clicar com o botão direito do mouse no componente que deseja gerenciar. Isso acionará um menu suspenso com duas opções: `Clonar` e `Excluir`. Opte por `Clonar` para criar uma cópia do componente ou escolha `Excluir` para removê-lo permanentemente da sua configuração.

Texto

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

Adicionando um 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 Save e as informações aparecerão no componente. Então conecte o componente text com o componente Start bot flow.

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 na 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 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 carregar uma imagem.

Componente de vídeo:

Adicione um componente `Vídeo` no Menu Superior.

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

Audio Component:

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 sua URL ou enviando uma.

Este guia simples ajudará você a configurar esses componentes para seu chatbot de forma rápida e eficaz.

Teclado

Você também tem a opção de incorporar um componente Keyboard no seu bot. Este componente em particular é projetado para coletar números de telefone e localizações de usuários.

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

Para incluir este componente, simplesmente arraste seu cursor do `soquete do botão do teclado` dos componentes Texto, Imagem, Áudio, Vídeo ou Arquivo e solte-o 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 de arrastar e soltar amigável ao usuário que facilita a integração perfeita entre seu bot do Telegram e uma loja de Ecommerce. Esse recurso poderoso permite que você estabeleça uma experiência de loja online abrangente diretamente na interface do seu bot do Telegram. (Você encontrará mais informações sobre Ecommerce na seção Ecommerce na documentação)

A configuração do recurso de comércio eletrônico é realizada por meio do seguinte steps:

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

Clique duas vezes no componente Ecommerce 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 concluir, você pode fornecer uma mensagem final para concluir a interação. Para fazer isso, arraste seu cursor do socket `Next` do componente Ecommerce e selecione o componente de texto. Então, insira sua mensagem final.

Doença

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

A configuração do componente Condição envolve o seguinte steps:

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

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

Additionally, you can apply conditions to both system field data and custom fields, selecting the desired condition by utilizing the operator field.

Para implementar esta funcionalidade, siga estes passos:

Adicione dois elementos de texto ao fluxo do chatbot.
Conecte um desses elementos de texto 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 socket `True` será enviada aos usuários cujos endereços de e-mail já estão no sistema.
Se a condição for avaliada como falsa, você pode conectar uma mensagem User Input Flow ao elemento Text conectado ao socket `False`. Essa mensagem User Input Flow 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 New Sequence é uma capacidade interna da plataforma, projetada para capacitar os usuários a criar e personalizar sequências de mensagens ou ações para chatbots em plataformas de mensagens. Esse 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.

A configuração de uma sequência envolve várias steps:

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 `New Sequence Campaigns`. Nesta etapa, especifique um nome para sua Sequence Campaign preenchendo o campo `Sequence Campaign Name`.

Para determinar o tempo de entrega das suas mensagens de série, use o campo `Tempo de entrega preferido para mensagens programadas fora da janela de 24 horas`. Você pode escolher entre horários predefinidos ou inserir manualmente seu tempo de entrega preferido.

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

Ao concluir as etapas anteriores, você descobrirá três componentes adicionais `Enviar mensagem depois` no criador 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 de uma janela de 24 horas`: este botão inicia a sequência para começar dentro de um período de 24 horas.

`Programar 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 horários predefinidos ou, alternativamente, você pode definir manualmente o horário do 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 User Input Flow é um recurso poderoso que facilita a coleta de dados de usuários por meio de interações naturais e conversacionais. 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 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 User Input Flow estiver pronta, você pode integrá-la perfeitamente ao fluxo do seu bot. Quando um usuário encontrar o componente User Input Flow no fluxo do seu bot, ele será solicitado com 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 reunir uma ampla gama 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 o seguinte steps:

Comece arrastando o componente `User Input Flow` do menu Top, ou alternativamente, selecione-o no menu socket. Há duas opções para adicionar esse 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 a URL do Webhook: Se desejar, você pode salvar os dados de entrada no seu Webhook.

Após salvar o `User Input Flow`, um componente `New Question` aparecerá automaticamente no fluxo. Como alternativa, você pode arrastar o socket chamado `First question` e colocá-lo no seu fluxo de bot para revelar o componente `New Question`.

Clique duas vezes no componente `New Question` para acessar dois botões: `Free Keyboard Input` e `Multiple choice`. Esses botões determinam o tipo de perguntas que você quer fazer.

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

Escolha múltipla: Neste botão o usuário obtém respostas pré-escritas. Seu cliente só precisa selecionar uma resposta pré-definida.

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

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

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

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

Salvar em campo personalizado: Você pode armazenar os dados de resposta em uma tabela de dados específica que você especificar. Se você precisar de um novo campo personalizado, você pode criar um clicando no botão `Add New`.

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.

Salvar no campo do sistema: No sistema, há tabelas de dados preexistentes 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 URL do Webhook: Para enviar dados de bot para uma URL específica, adicione seu link de webhook. Este recurso simplifica o armazenamento de dados por meio da integração do 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 você 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 em campo personalizado: Você tem a opção de armazenar os dados de resposta em uma tabela de dados específica que você especificar. Se você precisar de um novo campo personalizado, ele pode ser criado clicando no botão `Add New`.

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.

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

Salvar no campo do sistema: Dentro do sistema, tabelas de dados predefinidas estão disponíveis para uso, eliminando a necessidade de criar novas. Basta acessar o menu pop-up `Salvar no campo do sistema` e designar a tabela de dados que você deseja empregar.

Enviar dados para URL do Webhook: Para transmitir dados de bot para uma URL designada, insira seu link de webhook. Este recurso simplifica o armazenamento de dados por meio da integração do webhook.