Telegram
Objetivo/Resumo
A integração com a API do Telegram permite uma ampla variedade de interações. Com as operações editar mensagem, excluir mensagem, enviar mensagem, enviar foto e enviar documento, é possível aprimorar a experiência do usuário de forma eficiente. O editar mensagem possibilita a atualização de mensagens existentes, enquanto o excluir mensagem, permite a remoção de mensagens indesejadas. O enviar mensagem viabiliza o envio de mensagens de texto personalizadas, enquanto o enviar foto permite o compartilhamento de imagens. Já o enviar documento possibilita o envio de documentos diversos. Com essa integração, é possível criar interações dinâmicas e ricas dentro da plataforma Fluid, proporcionando uma experiência completa aos usuários.
Criando um bot para integração na plataforma Fluid
- Abra o aplicativo Telegram e pesquise o BotFather na barra de pesquisa.
- Selecione o BotFather nos resultados e inicie uma conversa com ele.
- Digite /newbot para criar um novo bot.
- Siga as instruções do BotFather para fornecer um nome e um username para o seu bot.
- Após criar o bot, o BotFather irá fornecer um token de acesso. Copie esse token, pois você vai precisar dele para conectar seu bot a plataforma Fluid.
- Obter o chat_id
Obtendo o chat_id
Abra um navegador da web e digite o seguinte URL, substituindo "TOKEN_DO_SEU_BOT" pelo token fornecido pelo BotFather (Antes, envie uma mensagem para o bot para que exista um chat_id):
https://api.telegram.org/bot<TOKEN_DO_SEU_BOT>/getUpdatesResposta no navegador
{
"ok": true,
"result": [
{
"update_id": 454971193,
"message": {
"message_id": 6,
"from": {
"id": 6132345456,
"is_bot": false,
"first_name": "Fluid",
"last_name": "Api",
"language_code": "pt-br"
},
"chat": {
"id": 6132345938,
"first_name": "Fluid",
"last_name": "Api",
"type": "private"
},
"date": 1687367740,
"text": "teste"
}
}
]
}Caminho do chat_id
result["chat"]["id"]Criando um exemplo de fluxo para envio, edição e exclusão de mensagens
Crie uma conexão (Saiba mais em Criar Conexão).
Preencha os campos e seu token enviado pelo BotFather
Vamos criar o passo para enviar mensagem
- Clique na aba Parametrização
- Selecione a operação Enviar mensagem
- Preencha o char_id e a mensagem desejada
Resposta da execução
{
"ok": true,
"result": {
"chat": {
"first_name": "Fluid",
"id": 6516946351,
"last_name": "API",
"type": "private"
},
"date": 1687206078,
"from": {
"first_name": "Poc-Fluid",
"id": 6025702973,
"is_bot": true,
"username": "fluid_poc_bot"
},
"message_id": 107,
"text": "test message canvas"
}
}Agora vamos criar um passo para editar a mensagem
- Clique na aba Parametrização
- Selecione a operação Enviar mensagem
- Preencha o char_id, message_id e a nova mensagem
Nota: Usaremos um função para capturar o message_id do passo anterior dinamicamente {{get state.mensagem.result.message_id}}
Resposta da execução
{
"ok": true,
"result": {
"chat": {
"first_name": "Fluid",
"id": 6516946351,
"last_name": "API",
"type": "private"
},
"date": 1687206078,
"edit_date": 1687206083,
"from": {
"first_name": "Poc-Fluid",
"id": 6025702973,
"is_bot": true,
"username": "fluid_poc_bot"
},
"message_id": 107,
"text": "canvas message updated"
}
}
Resposta da execução
{
"ok": true,
"result": true
}Todos os passos devem estar configurados
- Clique no passo, e vá até a aba Propriedades
- Selecione a conexão
- Preencha o nome do passo
Gerenciando arquivos
O envio de fotos e documentos por meio de plataformas digitais é essencial para compartilhar informações visualmente e de forma segura. No contexto do Telegram, o envio de fotos e documentos é uma funcionalidade poderosa e versátil. Com a plataforma Fluid, é possível enviar fotos e documentos para os usuários. Isso permite o compartilhamento de imagens, capturas de tela, documentos PDF, arquivos de texto e muito mais. Através dessa integração, os usuários podem desfrutar de uma experiência completa e conveniente, obtendo e compartilhando conteúdo visual e documentos importantes diretamente no Telegram. Seja para compartilhar fotos e documentos profissionais ou qualquer outro tipo de arquivo, o envio de fotos e documentos no Telegram torna a comunicação mais rica e eficiente.
Enviando uma foto para o nosso Bot
- Slecione a operação Enviar foto
- Preencha o chat_id
Enviando um documento para o nosso Bot
- Slecione a operação Enviar documento
- Preencha o chat_id
