Como utilizar a API do Pushbullet para enviar torpedos SMS no C#, PHP, Java ou pelo SQL Server (com CLR)

Post Views 5,155 views

Neste artigo

Reading time 8 minutes

Olá pessoal,
Boa tarde!!

Neste post, quero lhes mostrar uma novidade que consegui desenvolver essa semana e que achei muito bacana, que é o envio de torpedos SMS a partir de praticamente qualquer linguagem de programação atual (C#, VB.NET, Java, PHP, etc) e inclusive, pelo próprio banco de dados SQL Server utilizando o SQL CLR (também pode ser feito utilizando a xp_cmdshell).

Isso é especialmente útil para criar alertar e monitoramentos em ambientes de produção, onde em caso de qualquer problema grave, você possa ser notificado, onde quer que você esteja, até se estiver sem sinal do 3G ou Wi-FI na hora.

Pode-se utilizar isso para enviar um SMS para o setor comercial de uma empresa quando um cliente enviar uma solicitação de orçamento. Se você tem uma loja virtual, pode enviar torpedos para seus clientes com as alterações de status de um pedido, por exemplo. As possibilidades são muitas!

O que é o Pushbullet?

O Pushbullet é um aplicativo simples com um objetivo principal: transferir coisas do seu smartphone para o computador e vice-versa. É possível enviar arquivos e links para o celular, e receber notificações de qualquer smartphone associado a sua conta no PC, como por exemplo, quando um amigo faz check-in no Swarm, quando alguém está te ligando ou quando a sua agenda te lembra sobre algum compromisso.

Você também pode enviar e receber SMS e responder mensagens do WhatsApp, Facebook Messager, Hangouts e outros sem tocar no smartphone. É fácil: quando alguém enviar uma mensagem pelo WhatsApp, vai aparecer uma notificação interativa no seu computador. Clique em Responder, digite sua mensagem e clique em Enviar.

O Pushbullet também tem alguns truques bem bacanas, como sincronizar a área de transferência entre dispositivos, para que você possa recortar um texto no computador e colar no smartphone

Como funciona essa solução? Como o torpedo é enviado?

O funcionando básico dessa funcionalidade é a seguinte:

Através de uma linguagem de programação à sua escolha, você irá enviar a requisição para a API do Pushbullet, solicitando o envio do SMS e informando o número do destinatário e a mensagem
O servidor do Pushbullet irá receber essa requisição e direcionar para o aplicativo associado ao dispositivo solicitado na sua requisição
O aplicativo do seu celular selecionado irá receber a requisição do servidor e utilizar o recurso de envio de SMS do seu celular
Torpedo SMS enviado com sucesso para o destinatário!

Quais os requisitos para que essa API funcione?

Como o envio é feito realmente pelo seu celular, as mensagens enviadas pela API ficam disponíveis na tela de SMS do seu smartphone. Além disso, você precisará ter créditos para realizar o envio do SMS, assim como qualquer envio de SMS normal, ou ter um pacote junto à sua operadora móvel que permita o envio desses torpedos.

Nos meus testes, eu utilizei o meu celular, onde tenho um plano controle da Vivo de 1 GB e torpedos ilimitados para qualquer operadora, em qualquer DDD, então esse plano me atende perfeitamente. Tem até alguns pacotes exclusivos de SMS que permitem envios de torpedos ilimitados por um custo ainda menor.

Como vocês devem ter notado, para que esse recurso funcione, o aparelho celular que será o responsável por enviar os torpedos precisará estar sempre ligado e com acesso à internet.

Qual o custo dessa solução? Existe algum limite de envio?

Um ponto importante que devo comentar, é que a conta Free do Pushbullet só permite o envio de 500 requisições (pushes) por mês. Para remover esse limite e transformá-lo em envios ilimitados, você precisará atualizar sua conta do Pushbullet para a versão PRO (https://www.pushbullet.com/pro), com um custo de $ 4,99 (dólares) ao mês ou $ 3,33 (dólares) ao mês, caso você opte pelo plano anual. Acho o valor bem justo e acessível.

Acredito que é uma solução bem interessante e com um custo ZERO, para quem precisa de poucos envios por mês e já tenha um pacote de dados com suporte a torpedos ilimitados em seu celular.

Mesmo que você tenha uma necessidade de enviar muitos torpedos SMS e precise adquirir um pacote de dados com torpedos ilimitados + 1 GB de internet 4G (40 reais por mês) e atualizar a sua conta do Pushbullet para a versão PRO (10 reais por mês), o custo mensal por essa solução é bem pequeno (52 reais por mês) e muito inferior às soluções empresariais que as operadoras e outras empresas disponibilizam no mercado (e com limite de quantidade de torpedos enviados).

Fiz uma pesquisa rápida na internet e vi que algumas empresas cobram 100 reais por mês para ter direito a enviar 1.000 torpedos/mês e algumas cobram R$ 0,16 por torpedo (500 torpedos por mês = 80 reais).

Criando sua conta e adicionando os dispositivos

Para realizar essa atividade, vou utilizar a API do Pushbullet, que é bem documentada de fácil utilização (https://docs.pushbullet.com/) de utilizar para acessar todos esses recursos utilizando sua linguagem de programação favorita.

O primeiro passo é criar a sua conta no site do aplicativo (https://www.pushbullet.com/). Ele suporta integração com Facebook e Google, permitindo que o serviço leia seus dados de um desses dois serviços e você economize tempo digitando os dados cadastrais.

Uma vez cadastrado, adicione os seus dispositivos móveis baixando e instalando o aplicativo do Pushbullet neles. Uma vez instalado e logado no Pushbullet pelo app no seu celular, ele será adicionado à sua lista de dispositivos da sua conta.

Recuperando o Access Token, ID do Usuário e ID do Dispositivo

Uma vez que você criou sua conta e adicionou os dispositivos, vá na tela de Preferências (Settings – https://www.pushbullet.com/#settings) e na sessão “Access Tokens” clique no botão “Create Access Tokens”

Após clicar no botão, um código será mostrado na sua tela. Anote esse código, pois ele será o código de acesso para autenticar as requisições que iremos enviar.

Agora que você já tem a sua conta no Pushbullet e já tem o seu Access Token, precisamos recuperar o seu ID de usuário e o ID do seu dispositivo celular que será utilizado para enviar os torpedos.

Para recuperar essas informações, indico o download do binário do cURL, disponível neste link (Windows) ou neste link (Qualquer SO) ou a utilização da extensão Postman, do Google Chrome (mais prático e melhor visualização dos resultados)

Uma vez baixado e instalado (no Windows, copie o executável para o diretório C:\Windows), vamos utilizar o cURL para recuperar o ID da nossa conta, utilizando o comando abaixo:

curl --header "Access-Token: <seu_access_token>" https://api.pushbullet.com/v2/users/me -k

1	curl --header "Access-Token: <seu_access_token>" https://api.pushbullet.com/v2/users/me -k

ou realizando a mesma requisição com o Postman:

Com isso, anote o código do iden retornado. Esse é o seu ID de usuário, uma vez que você pode ter vários usuários associados a sua conta.

Agora vamos recuperar o ID do nosso dispositivo celular, que fará o envio do SMS, utilizando o comando abaixo no cURL:

curl --header "Access-Token: <seu_access_token>" https://api.pushbullet.com/v2/devices -k

1	curl --header "Access-Token: <seu_access_token>" https://api.pushbullet.com/v2/devices -k

ou pelo Postman:

Anote o código iden retornado do seu dispositivo. Esse é o ID do dispositivo.

Desenvolvendo a solução de envio SMS com a API do Pushbullet

Agora que já temos os ID’s necessários para realizar o envio do torpedo, podemos iniciar a nossa rotina de envio de SMS.

Solução escrita na linguagem de programação C#, para ser utilizada no SQL Server pelo CLR

Exemplo:

Código-fonte:

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_Torpedo(SqlString Nr_Numero, SqlString Ds_Mensagem)
    {


        if (Nr_Numero.IsNull)
            Retorno.Erro("Favor informar o número de telefone que irá receber a mensagem");

        if (Nr_Numero.Value.Length <= 9)
            Retorno.Erro("Favor informar o número de telefone com DDD");

        if (Ds_Mensagem.IsNull)
            Retorno.Erro("Favor informar a mensagem que será enviada");

        if (Ds_Mensagem.Value.Length > 160)
            Retorno.Erro("O tamanho máximo da mensagem a ser enviada por SMS é de 160 caracteres");



        try
        {

            
            const string AccessToken = "seu_access_token"; //https://www.pushbullet.com/#settings
            const string UserIdentity = "token_usuario"; //curl --header "Access-Token: access_token" https://api.pushbullet.com/v2/users/me
            const string DeviceIdentity = "token_do_dispositivo"; //curl--header "Access-Token: access_token" https://api.pushbullet.com/v2/devices


            var dsScript = @"{
    ""push"": {
        ""type"": ""messaging_extension_reply"",
        ""package_name"": ""com.pushbullet.android"",
        ""source_user_iden"": """ + UserIdentity + @""",
        ""target_device_iden"": """ + DeviceIdentity + @""", 
        ""conversation_iden"": """ + ((Nr_Numero.Value.Length <= 11) ? "+55" + Nr_Numero.Value : Nr_Numero.Value) + @""",
        ""message"": """ + Ds_Mensagem.Value.Replace('\\', '/') + @"""
    },""type"": ""push""
}";

            var request = (HttpWebRequest) WebRequest.Create("https://api.pushbullet.com/v2/ephemerals");
            
            request.Method = "POST";
            request.Headers.Add("Access-Token", AccessToken);
            request.UserAgent = "curl/7.37.0";
            request.ContentType = "application/json";

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

                using (var response = request.GetResponse())
                {
                    var dataStream = response.GetResponseStream();

                    var reader = new StreamReader(dataStream);
                    var responseFromServer = reader.ReadToEnd();

                    if (responseFromServer == "{}")
                        Retorno.Mensagem(responseFromServer);
                    else
                        Retorno.Erro(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_Torpedo(SqlString Nr_Numero, SqlString Ds_Mensagem)

{

if (Nr_Numero.IsNull)

Retorno.Erro("Favor informar o número de telefone que irá receber a mensagem");

if (Nr_Numero.Value.Length <= 9)

Retorno.Erro("Favor informar o número de telefone com DDD");

if (Ds_Mensagem.IsNull)

Retorno.Erro("Favor informar a mensagem que será enviada");

if (Ds_Mensagem.Value.Length > 160)

Retorno.Erro("O tamanho máximo da mensagem a ser enviada por SMS é de 160 caracteres");

try

{

const string AccessToken = "seu_access_token"; //https://www.pushbullet.com/#settings

const string UserIdentity = "token_usuario"; //curl --header "Access-Token: access_token" https://api.pushbullet.com/v2/users/me

const string DeviceIdentity = "token_do_dispositivo"; //curl--header "Access-Token: access_token" https://api.pushbullet.com/v2/devices

var dsScript = @"{

""push"": {

""type"": ""messaging_extension_reply"",

""package_name"": ""com.pushbullet.android"",

""source_user_iden"": """ + UserIdentity + @""",

""target_device_iden"": """ + DeviceIdentity + @""",

""conversation_iden"": """ + ((Nr_Numero.Value.Length <= 11) ? "+55" + Nr_Numero.Value : Nr_Numero.Value) + @""",

""message"": """ + Ds_Mensagem.Value.Replace('\\', '/') + @"""

},""type"": ""push""

}";

var request = (HttpWebRequest) WebRequest.Create("https://api.pushbullet.com/v2/ephemerals");

request.Method = "POST";

request.Headers.Add("Access-Token", AccessToken);

request.UserAgent = "curl/7.37.0";

request.ContentType = "application/json";

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

using (var reqstr = request.GetRequestStream())

{

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

using (var response = request.GetResponse())

{

var dataStream = response.GetResponseStream();

var reader = new StreamReader(dataStream);

var responseFromServer = reader.ReadToEnd();

if (responseFromServer == "{}")

Retorno.Mensagem(responseFromServer);

else

Retorno.Erro(responseFromServer);

}

catch (Exception e)

{

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

}

Neste script, utilizei a classe Retorno, que tem como objetivo enviar mensagens de informação e mensagens de erro para o banco de dados através do CLR. O seu código-fonte está disponível no post SQL Server – Como enviar avisos e mensagens de erro para o banco pelo CLR (C#).

Solução escrita na linguagem de programação Web PHP

Exemplo:

Código-fonte:

<?php

// Variáveis
$Nr_Numero = "+5527912345678";
$Ds_Mensagem = "Teste da API com o PHP";

$Nr_Numero = (strlen( $Nr_Numero ) <= 11) ? "+55" . $Nr_Numero : $Nr_Numero;
$Ds_Mensagem = str_replace( "\\", "/", $Ds_Mensagem );


// Parâmetros
$strUrl = "https://api.pushbullet.com/v2/ephemerals";
$AccessToken = "seu_access_token";
$UserIdentity = "seu_token_usuario";
$DeviceIdentity = "seu_token_dispositivo";


$requisicao = [
    'type' => 'push',
    'push' => [
        'type' => 'messaging_extension_reply',
        'package_name' => 'com.pushbullet.android',
        'source_user_iden' => $UserIdentity,
        'target_device_iden' => $DeviceIdentity,
        'conversation_iden' => $Nr_Numero,
        'message' => $Ds_Mensagem
    ]
];


$headers = array(
    "Content-type: application/json",
    "Access-Token: " . $AccessToken,
);


$ch = curl_init();


curl_setopt( $ch, CURLOPT_URL, $strUrl );

// Cabeçalhos e configurações
curl_setopt( $ch, CURLOPT_HEADER, 1 );
curl_setopt( $ch, CURLOPT_HTTPHEADER, $headers );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt( $ch, CURLOPT_USERAGENT, "curl/7.37.0" );
curl_setopt( $ch, CURLOPT_FOLLOWLOCATION, TRUE );
curl_setopt( $ch, CURLOPT_MAXREDIRS, 2 );

// Desativa a verificaçõo de certificado SSL
curl_setopt( $ch, CURLOPT_SSL_VERIFYHOST, 0 );
curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, 0 );

// Envia os dados
curl_setopt( $ch, CURLOPT_POST, 1 );
curl_setopt( $ch, CURLOPT_POSTFIELDS, json_encode( $requisicao ) );


$retorno = curl_exec( $ch );
curl_close( $ch );

if ( substr( $retorno, -2 ) == "{}" )
{
    echo "Torpedo enviado com sucesso para o número " . $Nr_Numero;
}
else
{
    echo "Erro: " . $retorno;
}
?>

<?php

// Variáveis

$Nr_Numero = "+5527912345678";

$Ds_Mensagem = "Teste da API com o PHP";

$Nr_Numero = (strlen( $Nr_Numero ) <= 11) ? "+55" . $Nr_Numero : $Nr_Numero;

$Ds_Mensagem = str_replace( "\\", "/", $Ds_Mensagem );

// Parâmetros

$strUrl = "https://api.pushbullet.com/v2/ephemerals";

$AccessToken = "seu_access_token";

$UserIdentity = "seu_token_usuario";

$DeviceIdentity = "seu_token_dispositivo";

$requisicao = [

'type' => 'push',

'push' => [

'type' => 'messaging_extension_reply',

'package_name' => 'com.pushbullet.android',

'source_user_iden' => $UserIdentity,

'target_device_iden' => $DeviceIdentity,

'conversation_iden' => $Nr_Numero,

'message' => $Ds_Mensagem

]

];

$headers = array(

"Content-type: application/json",

"Access-Token: " . $AccessToken,

);

$ch = curl_init();

curl_setopt( $ch, CURLOPT_URL, $strUrl );

// Cabeçalhos e configurações

curl_setopt( $ch, CURLOPT_HEADER, 1 );

curl_setopt( $ch, CURLOPT_HTTPHEADER, $headers );

curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );

curl_setopt( $ch, CURLOPT_USERAGENT, "curl/7.37.0" );

curl_setopt( $ch, CURLOPT_FOLLOWLOCATION, TRUE );

curl_setopt( $ch, CURLOPT_MAXREDIRS, 2 );

// Desativa a verificaçõo de certificado SSL

curl_setopt( $ch, CURLOPT_SSL_VERIFYHOST, 0 );

curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, 0 );

// Envia os dados

curl_setopt( $ch, CURLOPT_POST, 1 );

curl_setopt( $ch, CURLOPT_POSTFIELDS, json_encode( $requisicao ) );

$retorno = curl_exec( $ch );

curl_close( $ch );

if ( substr( $retorno, -2 ) == "{}" )

{

echo "Torpedo enviado com sucesso para o número " . $Nr_Numero;

}

else

{

echo "Erro: " . $retorno;

}

Solução genérica utilizando o binário cURL.exe

Depois de demonstrar exemplos utilizando duas linguagens de programação diferentes, vou demonstrar como usar o próprio cURL.exe, instalado no seu PC, para realizar o envio do SMS. Você pode optar pela sua linguagem de programação favorita para enviar a sua requisição, conforme fiz nos exemplos acima, ou pode também simplesmente executar o binário cURL.exe a partir da sua linguagem de programação:

O comando padrão para enviar SMS pelo cURL é esse:

curl --header "Access-Token: seu_access_token" --header "Content-Type: application/json" --request POST -k --data-binary @"C:\Users\dirceu\Desktop\push_message.json" https://api.pushbullet.com/v2/ephemerals

1	curl --header "Access-Token: seu_access_token" --header "Content-Type: application/json" --request POST -k --data-binary @"C:\Users\dirceu\Desktop\push_message.json" https://api.pushbullet.com/v2/ephemerals

push_message.json

{
  "push": {
    "conversation_iden": "+5527912345678",
    "message": "Teste de Mensagem com cURL",
    "package_name": "com.pushbullet.android",
    "source_user_iden": "seu_token_usuario",
    "target_device_iden": "seu_token_dispositivo",
    "type": "messaging_extension_reply"
  },
  "type": "push"
}

{

"push": {

"conversation_iden": "+5527912345678",

"message": "Teste de Mensagem com cURL",

"package_name": "com.pushbullet.android",

"source_user_iden": "seu_token_usuario",

"target_device_iden": "seu_token_dispositivo",

"type": "messaging_extension_reply"

"type": "push"

}

No comando cURL utilizei um arquivo externo (push_message.json) para armazenar as informações da solicitação que vou enviar. Você pode fazer com que a sua linguagem de programação crie esse arquivo em tempo de execução, utilize o caminho do arquivo recém criado no parâmetro –data-binary e apague-o após a execução.

Acredito que essa solução através do cURL é bem genérica e pode ser utilizada por qualquer linguagem de programação que te permita executar arquivos binários no servidor, seja C#, PHP, Java, Ruby, etc.

And that's it, folks!
Espero que tenham gostado desse post.

Qualquer dúvida, deixem aqui nos comentários!

sql sql server enviar torpedo send sms php java c# clr .net csharp ruby curl command line code script snipplet script

Daniel Cunha Correa disse:

February 1, 2020 às 09:52

Bom dia Dirceu,

tenho múltiplos bancos de dados Linkados a uma aplicação com vários acessos, com a API todas os bancos conseguiriam enviar sms. a duvida é se preciso ter varias contas para atender a todos?

Responder
DJALMA RORATO ANSELONI disse:

October 24, 2017 às 22:29

Dirceu Boa Noite, fiz tudo conforme seu post, estou recebendo o retorno “{}” do HttpWebRequest porém o SMS não é disparado. Estou fazendo o disparo direto da minha aplicação C#. Essa solução funciona apenas no CLR ?

Responder
Laércio Coelho disse:

October 3, 2016 às 18:16

Boa tarde, Dirceu!

Estava com uma necessidade semelhante e esse seu artigo foi realmente um achado!
Não sei se você passou por algum problema, mas eu estou com uma situação estranha: em minha máquina, num banco local, deu tudo certo; porém ao publicar a mesma solução de CLR em outros 2 servidores diferentes, quando executo a procedure ela fica rodando sem parar e só envia a mensagem quando cancelo a sua execução; e se tendo executá-la por um aplicativo em C# no Visual Studio ela dá erro de timeout e não manda nada.
Sabe o que poderia estar causando isso? Sem querer abusar…

Responder
albertochong disse:

September 14, 2016 às 14:12

Boa tarde Dirceu,
Tentei testar o exemplo acima e recebi a resposta {} mas o sms não foi enviado, tenho que por o indicativo do país?

Responder
- Dirceu Resende disse:
  
  September 14, 2016 às 14:18
  
  Alberto, boa tarde. O número deve estar no formato +55DDDNumero.
  
  Responder
Gustavo disse:

September 12, 2016 às 09:07

Bom dia estou tentando criar a classe Retorno como informando” SQL Server – Como enviar avisos e mensagens de erro para o banco pelo CLR (C#). ” porem esta dando um erro em

using (var Conexao = new SqlConnection(Servidor.Localhost))

poderia me auxiliar

Responder
- Dirceu Resende disse:
  
  September 12, 2016 às 10:20
  
  Gustavo, bom dia.
  
  Editei o post e adicionei o código-fonte do arquivo Servidor.cs, que é utilizado pela classe Retorno.
  
  Obrigado!
  
  Responder

Subscribe to blog by email

Blog Views

Microsoft MVP

Post Archive

Categories

Recent posts

Como utilizar a API do Pushbullet para enviar torpedos SMS no C#, PHP, Java ou pelo SQL Server (com CLR)

O que é o Pushbullet?

Como funciona essa solução? Como o torpedo é enviado?

Quais os requisitos para que essa API funcione?

Qual o custo dessa solução? Existe algum limite de envio?

Criando sua conta e adicionando os dispositivos

Recuperando o Access Token, ID do Usuário e ID do Dispositivo

Desenvolvendo a solução de envio SMS com a API do Pushbullet

sql sql server enviar torpedo send sms php java c# clr .net csharp ruby curl command line code script snipplet script

You may also like...

7 Responses

Deixe uma respostaCancelar resposta

O que é o Pushbullet?

Como funciona essa solução? Como o torpedo é enviado?

Quais os requisitos para que essa API funcione?

Qual o custo dessa solução? Existe algum limite de envio?

Criando sua conta e adicionando os dispositivos

Recuperando o Access Token, ID do Usuário e ID do Dispositivo

Desenvolvendo a solução de envio SMS com a API do Pushbullet

sql sql server enviar torpedo send sms php java c# clr .net csharp ruby curl command line code script snipplet script

You may also like...

SQL Server 2016 – Lista de novidades e novos recursos

Enviar e baixar arquivos via protocolo FTP com o PHP

Gerando engenharia reversa (DDL de Criação) de Usuários, Tablespaces, Roles, Jobs e Profiles no Oracle Database

7 Responses

Deixe uma respostaCancelar resposta