Como criar um bot e obter uma chave API
Antes de conectar um bot a Albato, você precisa criá-lo ou selecionar um existente no bot especial do sistema @BotFather:
Escreva um comando para ele /start.
Se você já tem bots e precisa obter sua chave API, envie um comando /mybots.
Selecione o bot desejado na lista e solicite a chave de API que será necessária para se conectar:
Ou escreva um comando /newbotpara criá-lo.
Depois disso, escreva o nome do seu bot. Será visível para todos.
Em seguida, digite seu nome de usuário. Ele irá após o símbolo “@” e deve terminar com bot. Por exemplo, “youNamebot” ou “youName_bot”.
Depois disso, a chave API do bot criado ficará disponível para você e você pode conectá-lo ao Albato:
Como criar uma conexão
Vá para a seção “Conexões”.
Clique no botão “Adicionar conexão”.
Escolha o serviço “Telegrama (pessoal)”:
No campo “API Key”, cole a chave copiada da API @BotFather
A conexão está pronta!
Como usar o bot
Depois de conectar o bot, qualquer usuário que escrever um comando /startnele será automaticamente incluído na lista de IDs de bate-papo. E se você escrever este comando em um grupo quando o bot estiver lá, ele analisará o ID do grupo / canal atual.
Para enviar uma mensagem ao Telegram, você precisa saber o ID do chat para onde a mensagem será enviada. Você não pode usar seu login ou número de telefone de acordo com as regras da API do Telegram.
Portanto, se você quiser escrever algo para um usuário ou grupo, primeiro precisa enviar um comando para o bot no chat certo /start. Após receber o ID do bate-papo, você pode selecioná-lo na lista e usar o bate-papo na ação “Enviar mensagem”.
Como funciona o acionador de mensagem de entrada
O gatilho “Mensagem de entrada” será lançado toda vez que qualquer usuário escrever uma mensagem para o bot, ou uma nova mensagem aparecer no grupo / canal onde o bot conectado está localizado. Quaisquer comandos que começam com um caractere “/” (por exemplo /start) são ignorados pelo gatilho e não iniciam o vínculo, mesmo se houver algum texto após o comando.
Mas um gatilho pode receber alguns comandos. Para fazer isso, abra os parâmetros de gatilho:
Aqui você pode escrever uma lista de comandos permitidos:
Como resultado, se o bot receber uma mensagem com um comando e texto, ele também disparará um gatilho. Por exemplo, ele transferirá /SeuComando Olá! todo o texto para o pacote .
Como resultado, se o bot receber uma mensagem com um comando e texto, ele também disparará um gatilho. Por exemplo, ele transferirá /SeuComando Olá! todo o texto para o pacote.
O acionador recebe muitos outros dados além do próprio texto da mensagem. Por exemplo, o nome e o ID do usuário que enviou a mensagem e o ID do bate-papo de onde a mensagem veio:
Assim, você pode configurar adicionalmente o filtro no gatilho para que ele execute:
Apenas a partir de um texto específico.
Somente quando um determinado usuário do grupo escreve.
Quando receberá mensagens de um chat específico.
Nesse caso, o campo “De” são os dados sobre quem exatamente enviou a mensagem (útil quando as mensagens vêm de um grupo). E o campo “Chat” são os dados do próprio chat (um pessoal com um bot / grupo / canal).
Certifique-se de usar filtros se o seu bot estiver em vários chats.
Leia mais sobre as configurações de filtro neste manual .
Como funciona a ação Enviar Mensagem
A ação Enviar mensagem permite que você envie texto para o bate-papo selecionado usando qualquer gatilho no Albato. A funcionalidade é semelhante ao nosso bot .
A diferença é que um chat específico não está mais vinculado a uma conexão específica, ele deve ser selecionado na lista no campo de ação:
Em seguida, você pode selecionar o tipo de marcação:
Você também pode gerar um pequeno formato de texto, como HTML, com imagens e links.
Depois disso, tudo o que resta é preencher o campo de texto e executar o link:
Você pode usar esta ação em conjunto com a ferramenta Substituição de Tabela. Por exemplo, você designará a quem enviará uma notificação do CRM sobre um novo negócio. Isso ajudará você a não reunir todos os funcionários em um canal e a não distraí-los desnecessariamente.