SQL Server - Como fazer uma integração do banco de dados com o Telegram e enviar mensagens utilizando o CLR (C#)

Post Views 9,318 views

Neste artigo

Reading time 8 minutes

Olá pessoal,
Bom dia!

Neste post vou demonstrar como fazer uma integração do banco de dados com o Telegram e enviar mensagens utilizando CLR (C#), que é o principal concorrente do Whatsapp. Anteriormente, já demonstrei como fazer essa mesma integração nos posts:

SQL Server – Como fazer uma integração do banco de dados com o Slack e enviar mensagens utilizando Python e sp_execute_external_script
SQL Server – Como fazer uma integração do banco de dados com o Slack e enviar mensagens utilizando o CLR (C#)

Caso você não conheça ou não saiba utilizar o CLR no SQL Server, descubra como acessando o post Introdução ao SQL CLR (Common Language Runtime) no SQL Server.

O que é o Telegram?

Para quem não conhece, o Telegram é um dos comunicadores mais famosos e utilizados em todo o mundo, principal concorrente do Whatsapp e tem a proposta de permitir uma comunicação rápida, segura e fácil entre pessoas de qualquer parte do mundo.

Você pode criar grupos públicos, onde qualquer pessoa pode entrar e interagir ou grupos privados, onde somente quem está no grupo pode visualizar as mensagens. O Telegram possui uma versão em português, uma API aberta que permite realizar a integração com suas aplicações e o envio de mensagens automatizadas. O seu visual é muito parecido com o Whatsapp e ele é mais seguro, mais rápido e possui mais recursos que o seu principal concorrente e líder de mercado, mas possui uma quantidade de usuários ainda bem menor, principalmente no Brasil.

Onde e como posso usar o Telegram na minha empresa?

Esse recurso é especialmente útil para criar equipes na sua empresa e gerar alertas e monitoramentos por equipe, onde cada equipe recebe apenas os alertas referentes às suas atividades. Além disso, você pode utilizar os grupos abertos para enviar informativos e notificações que interessam para a empresa toda. Tudo isso, sem custo algum e você pode receber por e-mail, visualizar na Web e no seu smartphone.

Uma outra forma legal de se utilizar o Telegram, é enviar acompanhamento de metas de vendas para o setor de comercial, de forma que os gerentes regionais e locais possam acompanhar a performance da equipe de vendas em tempo real, sem ter que ficar consultando e abrindo relatórios, onde quer que eles estejam, mesmo fora da empresa.

Caso sua empresa adote o Telegram, o setor de RH pode utilizar o serviço para enviar mensagens e informativos para os colaboradores. Enviar mensagens de natal, uma mensagem especial no aniversário do colaborador, etc.

Enfim, a vantagem do Telegram é que ele pode ser enviado de várias formas diferentes (Web, Smartphone), onde quer que você esteja, dentro ou fora da empresa e representa uma grande revolução na forma em que as pessoas interagem com as informações.

Você pode utilizar o Telegram como ferramenta de comunicação, monitoramento e alertas das rotinas de TI, como falhas em jobs críticos, problemas em backups, corrupções de bases, queries lentas, locks, etc. Sempre que alguma rotina crítica falha, é enviado um e-mail interno e uma notificação via Telegram, onde chega uma notificação Push no meu celular (igual do Whatsapp) e onde quer que eu esteja, tomo conhecimento dessa falha.

Como desvantagem do Telegram (e Whatsapp) em relação ao Slack e o Ryver, é que os 2 primeiros comunicadores são abertos ao mundo, e podem ser utilizados para conversas pessoais e particulares com qualquer pessoa, podendo gerar uma desconcentração e perda de foco. O Slack e o Ryver são muito mais voltados ao meio corporativo, tanto que as pessoas que vão interagir precisam de convite.

Como ativar a API do Telegram

Para começar a utilizar a API do Telegram você precisará criar um novo BOT, que será o responsável por enviar as mensagens. Para isso, logue na sua conta do Telegram, seja na Web ou no celular, e inicie uma conversa com o usuário @BotFather

Clique no botão “Começar”.

Assim que você clicar no botão “Começar”, o Bot irá enviar uma lista de comandos:

Telegram – Opções do Bot

Selecione a opção /newbot e depois escolha o nome do bot e o usuário, conforme print abaixo:

Anote o token gerado, pois ele será utilizado pela Stored Procedure para realizar o envio das mensagens.

Como identificar o ID do canal ou do usuário?

Assim com o Ryver, a API do Telegram exige que você digite o ID do canal ao invés de um nome fácil de decorar e se utilizar, como é a API do Slack. Apesar de ser mais seguro, ter que ficar armazenando os ID’s dos canais e usuários é uma tarefa um pouco chata e improdutiva.

Vou demonstrar aqui como identificar o ID do canal e dos usuários, para enviar mensagens privadas.

Como identificar o ID de um grupo:

Para identificar o ID de um grupo do Telegram, basta acessar o Telegram Web, clicar no grupo desejado e observar a URL do grupo. Lembre-se que o BOT deve ser convidado para o grupo em que você deseja enviar a mensagem.

Se você não convidar o BOT e tentar enviar uma mensagem para o grupo, você verá essa mensagem de erro:

Erro : O servidor remoto retornou um erro: (400) Solicitação Incorreta.

Quando for utilizar o ID do usuário na chamada da sua Stored Procedure, o valor geralmente é NEGATIVO.

Como identificar o ID de um usuário:

Para identificar o ID de um grupo do Telegram é um pouco mais trabalhoso, pois o próprio usuário terá que lhe enviar essa informação. Para isso, ele terá que iniciar uma conversa com o BOT @get_id

Após iniciar a conversa, o BOT já irá enviar o código do usuário para o próprio usuário, e ele deverá lhe informar esse ID para poder enviar as mensagens privadas (DM’s).

Como identificar o ID de um usuário pela API getUpdates

Uma outra forma de se fazer isso, é utilizando o método getUpdates da API do Telegram. Após o usuário iniciar uma conversa com o seu BOT, essa ação fica gravada nessa método, que recuperar todas as “novidades” que interagem com o seu BOT.

Utilizando uma ferramenta como o Postman, você pode utilizar essa API e visualizar facilmente o ID do usuário que iniciou a conversa com o seu BOT.

Lembre-se que a URL desse método é: https://api.telegram.org/botSEU_TOKEN_AQUI/getUpdates

Em qualquer um dos métodos acima, o usuário precisará iniciar uma conversa com o seu BOT, para que ele possa enviar as mensagens para o seu usuário. Essa é uma definição de segurança da API do Telegram para evitar SPAM.

Quando for utilizar o ID do usuário na chamada da sua Stored Procedure, o valor geralmente é POSITIVO.

Como integrar o banco de dados ao Telegram

Uma vez que você já criou sua conta no Telegram e já criou o bot que você irá utilizar para enviar as mensagens para os grupos, vamos à parte interessante: Criar o código .NET (C#) que irá realizar a integração do banco de dados SQL Server com a API do Telegram.

Como pré-requisito para utilizar essa procedure, você precisará criar a classe Retorno, disponível no post SQL Server – Como enviar avisos e mensagens de erro para o banco pelo CLR (C#) para utilizar o método Retorno.Erro e assim, enviar mensagens de erro, caso ocorram. Você também pode optar por comentar o código e remover as chamadas para esse método (e comentar também o using Bibliotecas.Model), mas não aconselho, pois você não saberá quando ocorreu algum erro na sua chamada à SP de envio de mensagens para o Telegram.

Assim como ocorre no Ryver e no Slack, para que seja possível enviar as mensagens, o usuário do BOT tem que ser adicionado em todos os grupos, privados e públicos, pois ele que faz o envio das mensagens e não é possível enviar as mensagens se ele não estiver no grupo.

Agora que já temos a conta criada, o usuário do BOT está nos grupos desejados e já geramos o nosso token, é hora de enviar as mensagens pelo banco de dados com o CLR.

using System;
using System.Data.SqlTypes;
using System.IO;
using System.Net;
using System.Text;
using Bibliotecas.Model;

public partial class StoredProcedures
{
    [Microsoft.SqlServer.Server.SqlProcedure]
    public static void stpEnvia_Mensagem_Telegram(SqlString Ds_Canal, SqlString Ds_Mensagem)
    {


        const string token = "seu_token_telegram";
        
        
        try
        {

            var mensagem = Ds_Mensagem.Value;
            var canais = Ds_Canal.Value.Split(';');

            foreach (var canal in canais)
            {

                var dsScript = $"chat_id={canal.Trim()}&text={mensagem}&parse_mode=Markdown";

                var url = $"https://api.telegram.org/bot{token}/sendMessage";

                var request = (HttpWebRequest) WebRequest.Create(url);

                request.Method = "POST";
                request.UserAgent = "curl/7.45.0";
                request.ContentType = "application/x-www-form-urlencoded";

                var buffer = Encoding.GetEncoding("UTF-8").GetBytes(dsScript);
                using (var reqstr = request.GetRequestStream())
                {

                    reqstr.Write(buffer, 0, buffer.Length);

                    using (var response = request.GetResponse())
                    {

                        using (var dataStream = response.GetResponseStream())
                        {

                            if (dataStream == null) return;

                            using (var reader = new StreamReader(dataStream))
                            {
                                var responseFromServer = reader.ReadToEnd();
                                Retorno.Mensagem(responseFromServer);
                            }
                        }

                    }

                }

            }

        }
        catch (Exception e)
        {
            Retorno.Erro("Erro : " + e.Message);
        }

    }

};

using System;

using System.Data.SqlTypes;

using System.IO;

using System.Net;

using System.Text;

using Bibliotecas.Model;

public partial class StoredProcedures

{

[Microsoft.SqlServer.Server.SqlProcedure]

public static void stpEnvia_Mensagem_Telegram(SqlString Ds_Canal, SqlString Ds_Mensagem)

{

const string token = "seu_token_telegram";

try

{

var mensagem = Ds_Mensagem.Value;

var canais = Ds_Canal.Value.Split(';');

foreach (var canal in canais)

{

var dsScript = $"chat_id={canal.Trim()}&text={mensagem}&parse_mode=Markdown";

var url = $"https://api.telegram.org/bot{token}/sendMessage";

var request = (HttpWebRequest) WebRequest.Create(url);

request.Method = "POST";

request.UserAgent = "curl/7.45.0";

request.ContentType = "application/x-www-form-urlencoded";

var buffer = Encoding.GetEncoding("UTF-8").GetBytes(dsScript);

using (var reqstr = request.GetRequestStream())

{

reqstr.Write(buffer, 0, buffer.Length);

using (var response = request.GetResponse())

{

using (var dataStream = response.GetResponseStream())

{

if (dataStream == null) return;

using (var reader = new StreamReader(dataStream))

{

var responseFromServer = reader.ReadToEnd();

Retorno.Mensagem(responseFromServer);

}

catch (Exception e)

{

Retorno.Erro("Erro : " + e.Message);

}

};

Exemplos de uso

Enviando mensagem para o grupo “Teste Dirceu Resende”

EXEC CLR.dbo.stpEnvia_Mensagem_Telegram 
    @Ds_Canal = N'-155990210', -- nvarchar(max) | grupos = ID negativo / DM = ID positivo
    @Ds_Mensagem = N'Teste de *negrito*, _italico_ e 
Quebra 
de 

linha.' -- nvarchar(max)

EXEC CLR.dbo.stpEnvia_Mensagem_Telegram

@Ds_Canal = N'-155990210', -- nvarchar(max) | grupos = ID negativo / DM = ID positivo

@Ds_Mensagem = N'Teste de *negrito*, _italico_ e

Quebra

linha.' -- nvarchar(max)

Enviando mensagem para o grupo “Teste Dirceu Resende” com URL externa

-- Enviando mensagem para o grupo "Teste Dirceu Resende" com URL
EXEC CLR.dbo.stpEnvia_Mensagem_Telegram 
    @Ds_Canal = N'-155990210', -- nvarchar(max) | grupos = ID negativo / DM = ID positivo
    @Ds_Mensagem = N'Gostou desse recurso? Veja mais no meu blog: (https://dirceuresende.com/blog)' -- nvarchar(max)

-- Enviando mensagem para o grupo "Teste Dirceu Resende" com URL

EXEC CLR.dbo.stpEnvia_Mensagem_Telegram

@Ds_Canal = N'-155990210', -- nvarchar(max) | grupos = ID negativo / DM = ID positivo

@Ds_Mensagem = N'Gostou desse recurso? Veja mais no meu blog: (https://dirceuresende.com/blog)' -- nvarchar(max)

Enviando mensagem privada (DM)
Uma vez que você tenha o ID do usuário, basta iniciar uma conversa com o BOT para que ele tenha permissão de te enviar mensagens. Se você não fizer isso, irá receber essa mensagem de erro ao tentar enviar a mensagem:

Erro : O servidor remoto retornou um erro: (400) Solicitação Incorreta.

Após iniciar uma conversa com o seu BOT, basta executar a SP abaixo:

EXEC CLR.dbo.stpEnvia_Mensagem_Telegram 
    @Ds_Canal = N'191345344', -- nvarchar(max) | grupos = ID negativo / DM = ID positivo
    @Ds_Mensagem = N'Teste de mensagem *privada*' -- nvarchar(max)

EXEC CLR.dbo.stpEnvia_Mensagem_Telegram

@Ds_Canal = N'191345344', -- nvarchar(max) | grupos = ID negativo / DM = ID positivo

@Ds_Mensagem = N'Teste de mensagem *privada*' -- nvarchar(max)

And that's it, folks!
Espero que tenham gostado desse post.
Um abraço e até a próxima.

sql server clr .net dotnet framework c# csharp integration como criar integração banco de dados database como enviar mensagens how to send messages notifications notificações grupo privada dm Telegram

sql server clr .net dotnet framework c# csharp integration como criar integração banco de dados database como enviar mensagens how to send messages notifications notificações grupo privada dm Telegram

Fabrício disse:

August 18, 2020 às 21:23

Boa noite, tentei testei o codigo no sql, tento enviar a msg, não da erro, mas nao envia a msg.

Responder
João Paulo Silva disse:

July 27, 2020 às 10:53

a chamada ao @get_id não mostra conforme o exemplo. somente grupos.

Responder
Leo disse:

September 19, 2019 às 11:14

Otimo artigo!
Você tem um exemplo com Whatsapp?

Responder
Leonardo disse:

August 13, 2019 às 16:35

Boa tarde,

Testei esse código pelo C# e funciona bem, mas quando jogo no SQL o envio de mensagem fica num loop infinito, simplesmente fica executando a vida toda e nem mensagem de erro gera, alguma dica ?

Responder
- Dirceu Resende disse:
  
  September 18, 2019 às 23:15
  
  Me chama no privado pra tentar entender o que está acontecendo
  
  Responder
Juliana disse:

April 25, 2017 às 15:17

Ótimo artigo.
Você estudos desse artigo na linguagem java?
Obrigada

Responder

SQL Server – Envio de Mensagem Telegram | Luiz Fernando

November 19, 2021

[…] inicial para utilizar a API do Telegram vou fazer referencia aqui ao grande Dirceu Resende (https://www.dirceuresende.com/blog/sql-server-como-fazer-uma-integracao-do-banco-de-dados-com-o-tele…), nesse post você vai aprender a configurar um bot do BotFather e descobrir o seu ID para envio de […]

Subscribe to blog by email

Blog Views

Microsoft MVP

Post Archive

Categories

Recent posts

SQL Server – Como fazer uma integração do banco de dados com o Telegram e enviar mensagens utilizando o CLR (C#)

O que é o Telegram?

Onde e como posso usar o Telegram na minha empresa?

Como ativar a API do Telegram

Como identificar o ID do canal ou do usuário?

Como identificar o ID de um grupo:

Como identificar o ID de um usuário:

Como identificar o ID de um usuário pela API getUpdates

Como integrar o banco de dados ao Telegram

Exemplos de uso

sql server clr .net dotnet framework c# csharp integration como criar integração banco de dados database como enviar mensagens how to send messages notifications notificações grupo privada dm Telegram

You may also like...

7 Responses

Deixe uma respostaCancelar resposta

O que é o Telegram?

Onde e como posso usar o Telegram na minha empresa?

Como ativar a API do Telegram

Como identificar o ID do canal ou do usuário?

Como identificar o ID de um grupo:

Como identificar o ID de um usuário:

Como identificar o ID de um usuário pela API getUpdates

Como integrar o banco de dados ao Telegram

Exemplos de uso

sql server clr .net dotnet framework c# csharp integration como criar integração banco de dados database como enviar mensagens how to send messages notifications notificações grupo privada dm Telegram

You may also like...

SQL Server - How to monitor and audit data changes in tables using Change Data Capture (CDC)

SQL Server – Como exportar o código-fonte de todas as Stored Procedures, Functions, Views e Triggers de um database para arquivos .sql

SQL Server – Comparação de performance entre Scalar Function e CLR Scalar Function

7 Responses

Deixe uma respostaCancelar resposta