--- title: Telegram slug: telegram docTags: createdAt: 2023-06-16T21:40:05.000Z --- ## 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 ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/Y3EXuHzcJz2LFlZuj5nvx_image.png" size="66" width="271" height="52" position="center" showCaption="false"} 1. Abra o aplicativo Telegram e pesquise o **BotFather** na barra de pesquisa. 2. Selecione o **BotFather** nos resultados e inicie uma conversa com ele. 3. Digite /newbot para criar um novo bot. 4. Siga as instruções do BotFather para fornecer um nome e um username para o seu bot. 5. 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. 6. 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)*: ```javascript https://api.telegram.org/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" } } ] } ``` Caminho do **chat\_id** ```javascript 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](docId:1pCVN0mJbFKUjHMhj86K-)*).* ![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/Zzr3twIFGV2kJLfiPwnA0_image.png) Preencha os campos e seu token enviado pelo **BotFather** ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/iuAAqp4QEaJCh55ke0Gqz_image.png" size="80" width="1244" height="812" position="center" showCaption="false"} ### Vamos criar o passo para enviar mensagem 1. Clique na aba **Parametrização** 2. Selecione a operação **Enviar mensagem** 3. Preencha o **char\_id** e a **mensagem** desejada ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/rkAKtImxjdvWijf35cRQz_image.png" size="62" width="788" height="824" position="center" showCaption="false"} 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" } } ``` ### Agora vamos criar um passo para editar a mensagem 1. Clique na aba **Parametrização** 2. Selecione a operação **Enviar mensagem** 3. Preencha o **char\_id**, **message\_id** e a nova **mensagem** :::hint{type="info"} ***Nota****: Usaremos um função para capturar o message\_id do passo anterior dinamicamente *\{\{get `state.mensagem.result.message_id`}} ::: ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/VCEwmUxWqKg_eJfuuulK4_image.png" size="62" width="788" height="982" position="center" showCaption="false"} 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" } } ``` ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/o_JSJARoaLgUW1fHwM8gB_image.png" size="62" width="788" height="832" position="center" showCaption="false"} Resposta da execução ```json { "ok": true, "result": true } ``` ### Todos os passos devem estar configurados 1. Clique no passo, e vá até a aba **Propriedades** 2. Selecione a conexão 3. Preencha o nome do passo ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/xuqtICCBHG5B2VE8ULO6B_image.png" size="62" width="786" height="756" position="center" showCaption="false"} ## 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 1. Slecione a operação **Enviar foto** 2. Preencha o **chat\_id** 3. Informe o nome o arquivo em cache ***OBS**: Conectores que criam arquivo em cache *[FTP](docId:2LBnXR_cp2GkrOu5f7TNI)*, *[AWS - S3](docId\:qT_BP3LzFSzPXCPzrNHQZ)* e *[CSV](docId\:O1G4PSE1EU0n8urrFziwx) ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/pAkD9dKaDPy3NQru574r7_image.png" size="62" width="790" height="832" position="center" showCaption="false"} ### Enviando um documento para o nosso Bot 1. Slecione a operação **Enviar documento** 2. Preencha o **chat\_id** 3. Informe o nome o arquivo em cache ***OBS**: Conectores que criam arquivo em cache *[FTP](docId:2LBnXR_cp2GkrOu5f7TNI)*, *[AWS - S3](docId\:qT_BP3LzFSzPXCPzrNHQZ)* e *[CSV](docId\:O1G4PSE1EU0n8urrFziwx) ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/hrPAxFqCTluaHkCbnJ851_image.png" size="62" width="784" height="832" position="center" showCaption="false"}