Telegram - Docs Fluid

Conectores
Comunicação
15min
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):
JS
https://api.telegram.org/bot<TOKEN_DO_SEU_BOT>/getUpdates
https://api.telegram.org/bot<TOKEN_DO_SEU_BOT>/getUpdates
﻿
Resposta no navegador
JSON
{
  "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"
      }
    }
  ]
}
{
  "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
JS
result["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
JSON
{
    "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"
    }
}
{
    "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
JSON
{
    "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"
    }
}
{
    "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
JSON
{
    "ok": true,
    "result": true
}
{
    "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
Informe o nome o arquivo em cache OBS: Conectores que criam arquivo em cache SFTP﻿, S3﻿ e CSV﻿﻿
﻿
Enviando um documento para o nosso Bot
Slecione a operação Enviar documento
Preencha o chat_id
Informe o nome o arquivo em cache OBS: Conectores que criam arquivo em cache SFTP﻿, S3﻿ e CSV﻿﻿
﻿
﻿
﻿
Updated 01 Nov 2023
Did this page help you?
Comunicação