Neste artigo
Na Albato, você pode enviar e receber mensagens do Telegram por meio de um bot. Em 5 minutos ou menos poderá ****criar seu próprio bot no Telegram diretamente pelo aplicativo.
Depois que o bot estiver criado, basta integrá-lo com diversos outros aplicativos.
Aqui estão alguns exemplos de como usar o Telegram junto com outros apps:
- Salesforce & Telegram: envie dados do seu CRM em mensagens do Telegram.
- Google Calendar & Telegram: configure lembretes automáticos no Messenger sobre eventos futuros.
- Tilda & Telegram: receba novos dados de formulários do site.
- Facebook & Telegram: automatize a transferência de leads do Facebook para o Telegram.
Quando você conecta seu bot do Telegram à Albato, é necessário inserir o webhook da Albato nas configurações do bot para enviar todos os eventos para a plataforma. Isso significa que, se o bot estiver conectado a outro sistema ou utilizar funcionalidades de terceiros, ele será desconectado dessas integrações e passará a utilizar apenas as funcionalidades da Albato.
Como criar um bot e obter a chave de API
Crie um bot e conecte-o à Albato ou escolha um bot que você já tenha criado anteriormente usando o @BotFather.
Se você já tem um bot, siga estes passos:
- Envie o comando /start em uma mensagem para o @BotFather.
- Envie o comando /mybots para receber sua chave de API.
- Selecione o bot na lista e solicite a chave de API necessária para a conexão.
Se você precisa criar um novo bot, siga estes passos:
- Envie o comando /newbot em uma mensagem.
- Envie o nome desejado para este novo bot. Esse nome será público.
- Defina o nome de usuário do bot. Ele será exibido após o símbolo @ e deve terminar com “bot”.
Exemplo: seuNomebot ou seuNome_bot
Após receber a chave de API do novo bot, você já poderá conectá-lo à Albato.
Como conectar seu bot à Albato
- Acesse a seção Apps, clique em Conectar App e selecione Telegram.
- Defina um nome para a conexão e Insira a chave de API copiada do @BotFather.
- Clique no botão Continuar e em seguida, a conexão estará pronta para ser usada.
Como usar seu bot
Depois que o bot estiver conectado, qualquer usuário que enviar o comando /start será adicionado à lista de Chat IDs.
Se você enviar esse comando em um grupo com o bot, ele irá capturar o ID do grupo ou canal atual.
Para enviar mensagens pelo Telegram, é necessário conhecer o Chat ID para onde a mensagem será enviada. De acordo com as regras da API do Telegram, não é possível usar login ou número de telefone.
Portanto, se você quiser enviar uma mensagem para um usuário ou grupo, o bot precisa receber o comando /start no chat correto. Após obter o Chat ID, você poderá selecioná-lo na lista e utilizá-lo na ação Enviar Mensagem dentro das suas automações.
Como funciona o gatilho “Incoming Message”
O gatilho “Incoming Message” (mensagem recebida) é acionado sempre que qualquer usuário envia uma mensagem para o bot ou quando uma nova mensagem aparece em um grupo ou canal onde o bot está conectado.
Comandos que começam com o símbolo “/” (por exemplo, /start) são ignorados pelo gatilho e não iniciam uma automação, mesmo que haja texto após o comando.
No entanto, é possível habilitar comandos específicos para o gatilho. Para isso, abra as configurações do gatilho.
Aqui você pode listar os comandos permitidos.
Como resultado, se o bot receber uma mensagem contendo um comando permitido, o gatilho será executado.
Por exemplo, o texto /seuComando será enviado para a Albato junto com qualquer outra mensagem enviada depois do comando. Você pode conferir os dados coletados na aba de Histórico e usar esses valores nas próximas etapas da automação.
Além do texto da mensagem, o gatilho também recebe outras informações, como:
- Nome e ID do usuário que enviou a mensagem.
- Chat ID de onde a mensagem foi enviada.
Uso de filtros no gatilho
Você pode configurar filtros adicionais no gatilho para executar a automação:
- quando uma determinada frase for enviada;
- quando um usuário específico do grupo enviar uma mensagem;
- quando mensagens forem recebidas de um chat específico.
Clique no ícone de Filtro para definir as condições.
Na lista suspensa de valores, você encontrará os campos From e Chat:
- From (De): indica quem enviou a mensagem (recomendado para uso em grupos).
- Chat: contém informações do chat (conversa privada, grupo ou canal).
Atenção: se o seu bot estiver presente em vários chats, é altamente recomendável o uso de filtros.
Você pode ler mais sobre configurações de filtros neste tutorial aqui.
Como funciona a ação “Send Message”
A ação “Send Message” (enviar mensagem) permite enviar mensagens para um chat selecionado usando qualquer gatilho da Albato. A funcionalidade é semelhante à do bot.
A principal diferença é que o chat ID não fica mais vinculado a uma conexão específica, quem recebe a mensagem deve ser selecionado diretamente no campo dentro dessa etapa da automação.
Em seguida, você pode escolher o tipo de formatação da mensagem:
Também é possível criar mensagens formatadas em HTML, incluindo imagens e links.
Essa ação pode ser usada em conjunto com a ferramenta Table Lookup (Substituição da Mesa).
Por exemplo, você pode definir quais gerentes devem ser notificados sobre um novo negócio no CRM, evitando enviar mensagens para todos em um único canal.
O funcionamento seria assim:
- Um novo evento ocorre por exemplo, o gatilho Nova Tarefa do seu CRM.
- A ferramenta verifica o nome do responsável e o substitui pelo Chat ID correspondente.
- O gerente responsável recebe a notificação no Telegram.
Depois disso, configure a ação e selecione o resultado da ferramenta no campo Chat ID.
Exemplos de cenários de automação
Suponha que você precise criar uma tarefa no YouTrack. Basta enviar uma mensagem para o bot e a tarefa será criada automaticamente.
Outro exemplo: imagine que você precise identificar quem está enviando uma determinada frase. Para isso, basta configurar um filtro no campo Texto, usando a condição Contem, e informar a frase desejada.
Esse filtro é excelente para uso com ações que criam leads ou negócios em um CRM, ou registros no Google Sheets. Assim, você não perde nenhuma mensagem importante, mesmo que exista muito spam recebido.
