Recebendo um SMS
Para receber um SMS, você precisa:
- Alugue um número virtual para receber mensagens
- Criar um endpoint de webhook usando um dos exemplos de código apresentados a seguir
- Configure o webhook no seu Painel da Vonage
Pré-requisitos
Adicione o seguinte ao arquivo ` build.gradle`:
implementation 'com.vonage:server-sdk-kotlin:2.1.1'
implementation 'io.ktor:ktor-server-netty'
implementation 'io.ktor:ktor-serialization-jackson'Escreva o código
Adicione o seguinte ao método ` main ` do arquivo ` ReceiveMessage `:
embeddedServer(Netty, port = 8000) {
routing {
route("/webhooks/inbound-sms") {
handle {
if (call.request.contentType().equals("application/x-www-form-urlencoded")) {
println("msisdn: ${call.request.queryParameters["msisdn"]}")
println("messageId: ${call.request.queryParameters["messageId"]}")
println("text: ${call.request.queryParameters["text"]}")
println("type: ${call.request.queryParameters["type"]}")
println("keyword: ${call.request.queryParameters["keyword"]}")
println("messageTimestamp: ${call.request.queryParameters["messageTimestamp"]}")
}
else {
val messageEvent = MessageEvent.fromJson(call.receive())
println(messageEvent.toJson())
}
call.respond(204)
}
}
}
}.start(wait = true)Execute seu código
Podemos usar o plugin “ aplicativo ” para o Gradle a fim de simplificar a execução do nosso aplicativo. Atualize seu arquivo ` build.gradle ` com o seguinte:
apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''Execute o seguinte comando ` gradle ` para rodar seu aplicativo, substituindo ` com.vonage.quickstart.kt.sms ` pelo pacote que contém ` ReceiveMessage`:
Pré-requisitos
Adicione o seguinte ao arquivo ` build.gradle`:
implementation 'com.vonage:server-sdk:9.3.1'
implementation 'com.sparkjava:spark-core:2.9.4'Escreva o código
Adicione o seguinte ao método ` main ` do arquivo ` ReceiveSms `:
/*
* Route to handle incoming SMS GET request.
*/
Route inboundSmsAsGet = (req, res) -> {
System.out.println("msisdn: " + req.queryParams("msisdn"));
System.out.println("messageId: " + req.queryParams("messageId"));
System.out.println("text: " + req.queryParams("text"));
System.out.println("type: " + req.queryParams("type"));
System.out.println("keyword: " + req.queryParams("keyword"));
System.out.println("messageTimestamp: " + req.queryParams("message-timestamp"));
res.status(204);
return "";
};
/*
* Route to handle incoming SMS with POST form-encoded or JSON body.
*/
Route inboundSmsAsPost = (req, res) -> {
// The body will be form-encoded or a JSON object:
if (req.contentType().startsWith("application/x-www-form-urlencoded")) {
System.out.println("msisdn: " + req.queryParams("msisdn"));
System.out.println("messageId: " + req.queryParams("messageId"));
System.out.println("text: " + req.queryParams("text"));
System.out.println("type: " + req.queryParams("type"));
System.out.println("keyword: " + req.queryParams("keyword"));
System.out.println("messageTimestamp: " + req.queryParams("message-timestamp"));
} else {
MessageEvent event = MessageEvent.fromJson(req.body());
System.out.println("msisdn: " + event.getMsisdn());
System.out.println("messageId: " + event.getMessageId());
System.out.println("text: " + event.getText());
System.out.println("type: " + event.getType());
System.out.println("keyword: " + event.getKeyword());
System.out.println("messageTimestamp: " + event.getMessageTimestamp());
}
res.status(204);
return "";
};
Spark.port(8080);
Spark.get("/webhooks/inbound-sms", inboundSmsAsGet);
Spark.post("/webhooks/inbound-sms", inboundSmsAsPost);Execute seu código
Podemos usar o plugin “ aplicativo ” para o Gradle a fim de simplificar a execução do nosso aplicativo. Atualize seu arquivo ` build.gradle ` com o seguinte:
apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''Execute o seguinte comando ` gradle ` para rodar seu aplicativo, substituindo ` com.vonage.quickstart.sms ` pelo pacote que contém ` ReceiveSms`:
Pré-requisitos
Install-Package VonageCrie um arquivo chamado ` SmsController.cs ` e insira o seguinte código:
{
[HttpGet("webhooks/inbound-sms")] Escreva o código
Adicione o seguinte ao arquivo ` SmsController.cs`:
}
[HttpGet("webhooks/delivery-receipt")]
public IActionResult DeliveryReceipt()
{
var dlr = WebhookParser.ParseQuery<DeliveryReceipt>(Request.Query);
Console.WriteLine($"Delivery receipt received for messages {dlr.MessageId} at {dlr.MessageTimestamp}");Pré-requisitos
composer require slim/slim:^3.8 vonage/clientCrie um arquivo chamado ` index.php ` e insira o seguinte código:
use \Psr\Http\Message\ServerRequestInterface as Request;
use \Psr\Http\Message\ResponseInterface as Response;
use Slim\Factory\AppFactory;Adicione o seguinte ao arquivo ` index.php`:
require 'vendor/autoload.php';
$app = AppFactory::create();Escreva o código
Adicione o seguinte ao arquivo ` index.php`:
$handler = function (Request $request, Response $response) {
$sms = \Vonage\SMS\Webhook\Factory::createFromRequest($request);
error_log('From: ' . $sms->getMsisdn() . ' message: ' . $sms->getText());
return $response->withStatus(204);
};
$app->map(['GET', 'POST'], '/webhooks/inbound-sms', $handler);
$app->run();Execute seu código
Salve este arquivo no seu computador e execute-o:
Pré-requisitos
pip install fastapi[standard]Escreva o código
Adicione o seguinte ao arquivo ` receive-sms.py`:
from pprint import pprint
from fastapi import FastAPI, Request
app = FastAPI()
@app.post('/webhooks/inbound')
async def inbound_message(request: Request):
data = await request.json()
pprint(data)Execute seu código
Salve este arquivo no seu computador e execute-o:
Pré-requisitos
gem install sinatra sinatra-contribCrie um arquivo chamado ` receive.rb ` e insira o seguinte código:
require 'sinatra'
require 'sinatra/multi_route'
require 'json'
helpers do
def parsed_body
json? ? JSON.parse(request.body.read) : {}
end
def json?
request.content_type == 'application/json'
end
endEscreva o código
Adicione o seguinte ao arquivo ` receive.rb`:
route :get, :post, '/webhooks/inbound-sms' do
puts params.merge(parsed_body)
status 204
end
set :port, 3000Execute seu código
Salve este arquivo no seu computador e execute-o:
Configure o endpoint do webhook no seu Painel da Vonage
Para que a Vonage saiba como acessar seu webhook, você deve configurá-lo no seu Account da Vonage.
Nos trechos de código, o webhook está localizado em /webhooks/inbound-sms. Se você estiver usando o Ngrok, o webhook que você precisa configurar no seu Página de configurações da API do Painel do Vonage tem a forma https://demo.ngrok.io/webhooks/inbound-sms. Substituir demo com o subdomínio fornecido pelo Ngrok e insira seu endpoint no campo intitulado URL do webhook para mensagens recebidas:

Experimente
Agora, quando você enviar um SMS para o seu número da Vonage, deverá vê-lo registrado no seu console. O objeto da mensagem contém as seguintes propriedades:
{
"msisdn": "447700900001",
"to": "447700900000",
"messageId": "0A0000000123ABCD1",
"text": "Hello world",
"type": "text",
"keyword": "Hello",
"message-timestamp": "2020-01-01T12:00:00.000+00:00",
"timestamp": "1578787200",
"nonce": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
"concat": "true",
"concat-ref": "1",
"concat-total": "3",
"concat-part": "2",
"data": "abc123",
"udh": "abc123"
}