Como enviar múltiplos SMS a partir de Objective C
A maneira mais simples de enviar múltiplos SMS a partir de Objective-C é usar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Ao usar esta API, você enviará mensagens SMS através de uma requisição HTTP Post para o gateway de SMS. A requisição HTTP Post irá conter uma mensagem formatada em json. O gateway de SMS irá enviar este SMS para o telefone do destinatário e retornará uma resposta HTTP 200 OK para a sua requisição.
O exemplo de código SMS em Objective-C abaixo demonstra como você pode enviar SMS usando a API HTTP REST de SMS do Ozeki SMS Gateway com a biblioteca Ozeki.Libs.Rest. Esta biblioteca é fornecida gratuitamente e você pode usá-la e modificá-la em qualquer um dos seus projetos.
SendMultipleSms.m
#import <Foundation/Foundation.h>
#import "Ozeki.Libs.Rest.h"
int main(int argc, const char * argv[]) {
Configuration * configuration = [ [ Configuration alloc ] init];
[ configuration setUsername : @"http_user" ];
[ configuration setPassword : @"qwe123" ];
[ configuration setApiUrl : @"http://192.168.0.14:9509/api" ];
// Você deve substituir o endereço IP pelo IP do computador que tem o SMS Gateway instalado!
MessageApi * api = [ [ MessageApi alloc ] initWithConfiguration : configuration ];
Message * msg1 = [ [ Message alloc ] init ];
[ msg1 setToAddress : @"+36201111111" ];
[ msg1 setText : @"Hello world 1" ];
Message * msg2 = [ [ Message alloc ] init ];
[ msg2 setToAddress : @"+36202222222" ];
[ msg2 setText : @"Hello world 2" ];
Message * msg3 = [ [ Message alloc ] init ];
[ msg3 setToAddress : @"+36203333333" ];
[ msg3 setText : @"Hello world 3" ];
NSMutableArray<Message *> * messages = [ [ NSMutableArray<Message *> alloc ] initWithObjects: msg1, msg2, msg3, nil ];
MessageSendResults * result = [ api SendMessages: messages ];
NSLog(@"%@", result);
return 0;
}
Como usar o exemplo de SMS em Objective-C:
Este exemplo de SMS em Objective C pode ser usado em qualquer aplicação core Objective C. Para usá-lo, você deve adicionar o arquivo de cabeçalho Ozeki.Libs.Rest.h e o arquivo de implementação Ozeki.Libs.Rest.m ao seu projeto. Após adicionar a referência do projeto, você deve colocar a diretiva using Ozeki.Libs.Rest; na seção de cabeçalho do seu código fonte Objective C. Isso permitirá que você use as classes fornecidas pela biblioteca Ozeki.Libs.Rest. Você pode usar a classe Message para criar o SMS. Você pode usar a classe MessageApi para enviar o SMS para o gateway de SMS. O gateway de SMS encaminhará sua mensagem para a rede móvel através de uma conexão sem fio ou pela Internet.
Baixar SendMultipleSms.m
O código-fonte explicado neste artigo pode ser baixado, usado e modificado gratuitamente.
Download: SendMultipleSms.m.zip (48.4Kb)
O arquivo SendMultipleSms.m contém a biblioteca Ozeki.Libs.Rest, que fornece todas as ferramentas necessárias para enviar e receber mensagens SMS. Você também encontrará o projeto SendMultipleSms no zip, que contém o código de exemplo para mostrar como enviar um SMS. Este código de exemplo está listado abaixo.
Para enviar múltiplos SMS a partir de Objective-C:
- Instale um usuário de API HTTP em uma máquina Windows
- Ative "Log communication events" na aba Advanced
- Configure o Xcode
- Baixe e extraia o arquivo SendMultipleSms.m.zip
- Abra o arquivo SendMultipleSms.xcodeproj no Xcode
- Inicie o aplicativo Ozeki SMS Gateway na sua máquina Windows
- Execute o código Objective C SendMultipleSms.m no Xcode
- Verifique os logs para ver se o SMS foi enviado
Para poder enviar SMS a partir de Objective-C, primeiro você precisa instalar o Ozeki SMS Gateway. O gateway de SMS pode ser instalado no mesmo computador onde você desenvolve seu código Objective-C no Visual Studio. Após a instalação, o próximo passo é conectar o Ozeki SMS Gateway à rede móvel. Você pode enviar um SMS de teste a partir da interface gráfica do Ozeki para verificar se a sua conexão com a rede móvel está funcionando. O passo final para preparar o seu ambiente é criar um usuário de API HTTP de SMS. Crie um usuário com o nome "http_user" e senha "qwe123" para fazer o exemplo funcionar sem modificações.
Após configurar o ambiente, você pode executar o seu código Objective-C.
URL da API HTTP para enviar SMS a partir de Objective-CPara enviar SMS a partir de Objective-C, o seu código Objective-C terá que fazer uma requisição HTTP para o gateway de SMS. A URL da API é mostrada abaixo. Observe que o endereço IP (127.0.0.1) deve ser substituído pelo endereço IP do seu gateway de SMS. Se o Ozeki SMS Gateway estiver instalado no mesmo computador onde o aplicativo Objective C está rodando, pode ser 127.0.0.1. Se estiver instalado em um computador diferente, deve ser o endereço IP desse computador.
http://127.0.0.1:9509/api?action=rest
Autenticação HTTP para enviar SMS a partir de Objective-C
Para autenticar o cliente de SMS em Objective-C, você precisa enviar o nome de usuário e senha em uma string codificada em base64 para o servidor em uma requisição HTTP. O formato utilizado é: base64(nome de usuário+":"+senha). Em Objective-C, você pode usar o seguinte código para fazer essa codificação:
NSString * username_password = [ NSString stringWithFormat : @"%@:%@", username, password ]; NSData * encode_data = [username_password dataUsingEncoding:NSUTF8StringEncoding]; NSString * username_password_encoded = [encode_data base64EncodedStringWithOptions : 0]; return [ NSString stringWithFormat : @"Basic %@", username_password_encoded ];
Por exemplo, se você codificar o nome de usuário 'http_user' e a senha 'qwe123', você obterá a seguinte string codificada em base64: aHR0cF91c2VyOnF3ZTEyMw==. Para enviar
Cabeçalho da requisição HTTP para enviar SMS a partir de Objective-C
Para enviar as mensagens SMS, você precisa incluir as seguintes linhas como cabeçalhos na requisição HTTP. Observe que incluímos um tipo de conteúdo e um cabeçalho de Autorização.
Content-Type: application/json Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Requisição HTTP para enviar SMS a partir de Objective-C
Para enviar as mensagens SMS, sua aplicação em Objective-C enviará uma requisição HTTP semelhante à mostrada abaixo. Observe que esta requisição contém uma parte de cabeçalho HTTP e uma parte de corpo HTTP. O corpo HTTP é uma string de dados codificada em JSON. Ela contém o número do destinatário e o texto da mensagem.
POST /api?action=sendmsg HTTP/1.1
Connection: keep-alive
Content-Length: 971
Content-Type: application/json
Accept: application/json
Accept-Encoding: gzip, deflate
Accept-Language: en-gb
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 192.168.0.14:9509
User-Agent: SendMutipleSms.m (unknown version) CFNetwork/1220.1 Darwin/20.3.0
{
"messages": [
{
"is_view_report_requested": false,
"create_date": "2021-07-23T09:23:25",
"message_id": "9c6a7eb2-37b5-4fea-a75f-c0cdaba85466",
"time_to_send": "2021-07-23T09:23:25",
"valid_until": "2021-07-30T09:23:25",
"is_submit_report_requested": false,
"to_address": "+36201111111",
"text": "Hello world 1",
"is_delivery_report_requested": false
},
{
"is_view_report_requested": false,
"create_date": "2021-07-23T09:23:25",
"message_id": "8f2ff6cb-417a-4650-a474-8adc4b005cc4",
"time_to_send": "2021-07-23T09:23:25",
"valid_until": "2021-07-30T09:23:25",
"is_submit_report_requested": false,
"to_address": "+36202222222",
"text": "Hello world 2",
"is_delivery_report_requested": false
},
{
"is_view_report_requested": false,
create_date": "2021-07-23T09:23:25",
"message_id": "39b54837-a7e5-4319-a154-25d25bf3d920",
"time_to_send": "2021-07-23T09:23:25",
"valid_until": "2021-07-30T09:23:25",
"is_submit_report_requested": false,
"to_address": "+36203333333",
"text": "Hello world 3",
"is_delivery_report_requested": false
}
]
}
Resposta HTTP recebida pelo exemplo de SMS em Objective-C
Assim que o gateway de SMS receber esta requisição, ele gerará uma resposta HTTP. A resposta HTTP conterá um código de status para indicar se a requisição de envio de SMS foi bem-sucedida ou não. Ela também retornará uma estrutura codificada em JSON para fornecer detalhes úteis sobre o envio da mensagem.
HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 23 Jul 2021 09:21:44 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked
{
"http_code": 200,
"response_code": "SUCCESS",
"response_msg": "Messages queued for delivery.",
"data": {
"total_count": 3,
"success_count": 3,
"failed_count": 0,
"messages": [
{
"message_id": "9c6a7eb2-37b5-4fea-a75f-c0cdaba85466",
"from_station": "%",
"to_address": "+36201111111",
"to_station": "%",
"text": "Hello world 1",
"create_date": "2021-07-23 09:23:25",
"valid_until": "2021-07-30 09:23:25",
"time_to_send": "2021-07-23 09:23:25",
"submit_report_requested": true,
"delivery_report_requested": false,
"view_report_requested": false,
"tags": [
{
"name": "Type",
"value": "SMS:TEXT"
}
],
"status": "SUCCESS"
},
{
"message_id": "8f2ff6cb-417a-4650-a474-8adc4b005cc4",
"from_station": "%",
"to_address": "+36202222222",
"to_station": "%",
"text": "Hello world 2",
"create_date": "2021-07-23 09:23:25",
"valid_until": "2021-07-30 09:23:25",
"time_to_send": "2021-07-23 09:23:25",
"submit_report_requested": true,
"delivery_report_requested": false,
"view_report_requested": false,
"tags": [
{
"name": "Type",
"value": "SMS:TEXT"
}
],
"status": "SUCCESS"
},
{
"message_id": "39b54837-a7e5-4319-a154-25d25bf3d920",
"from_station": "%",
"to_address": "+36203333333",
"to_station": "%",
"text": "Hello world 3",
"create_date": "2021-07-23 09:23:25",
"valid_until": "2021-07-30 09:23:25",
"time_to_send": "2021-07-23 09:23:25",
"submit_report_requested": true,
"delivery_report_requested": false,
"view_report_requested": false,
"tags": [
{
"name": "Type",
"value": "SMS:TEXT"
}
],
"status": "SUCCESS"
}
]
}
}
Exemplo de SMS em Objective-C: SendMultipleSms.xcodeproj
Como baixar e abrir a solução acima (Tutorial em vídeo)
Neste vídeo, vamos mostrar como você pode baixar o projeto de exemplo e abri-lo. Ele começará com o seu navegador na página do tutorial e terminará com o projeto de exemplo no seu computador. Você aprenderá onde clicar para baixar o arquivo e onde procurá-lo após o processo de download. O vídeo tem apenas 30 segundos, então você não terá problemas para seguir os passos.
O código de exemplo abaixo faz parte do projeto SendMultipleSms.xcodeproj. No zip há apenas um projeto: SendMultipleSms.xcodeproj, e três arquivos: SendMultipleSms.m, Ozeki.Libs.Rest.h, Ozeki.Libs.Rest.m.
Como usar o projeto SendMultipleSms.xcodeproj
No vídeo a seguir, apresentamos como usar o arquivo de projeto SendMultipleSMS. Ele começará com o arquivo de log vazio do usuário HTTP no Ozeki SMS Gateway e terminará com o registro do envio de SMS. Você aprenderá como iniciar o aplicativo de envio de SMS e depois verificar o log do usuário. O vídeo tem quase 1 minuto, mas é muito detalhado, então você não terá problemas para entendê-lo. No vídeo, estamos usando o Ozeki SMS Gateway, que oferece uma interface gráfica muito intuitiva para uma melhor experiência do usuário.
Conclusão
Este guia mostrou os passos para o envio de múltiplos SMS em Objective C com a ajuda do Ozeki SMS Gateway. Com este artigo detalhado, entrar em contato com vários clientes de uma vez é rápido e simples. Usar essa função permite o envio de mensagens para mais pessoas, tornando a troca de informações mais rápida. O Ozeki SMS Gateway funciona com alta performance, significando que pode enviar até 1000 SMS por segundo, então o envio de múltiplos SMS em Objective C é muito fácil com este programa.
Certifique-se de não parar de ler aqui, visite a página de tutoriais da Ozeki para aprender sobre tópicos similares, como recebimento em Objective C.
A próxima coisa a fazer é baixar o Ozeki SMS Gateway e começar a trabalhar agora!
More information
- Enviar SMS em Objective-C com a API REST HTTP (exemplo de código)
- Enviar múltiplos SMS em Objective-C com a API REST HTTP (exemplo de código)
- Agendar SMS em Objective-C com a API REST HTTP (exemplo de código)
- Receber SMS em Objective C com a API REST HTTP (exemplo de código)
- Excluir SMS em Objective C com a API REST HTTP (exemplo de código)
- Como baixar a última biblioteca de SMS em Objective C do Github