Como agendar um SMS em Objective C

A maneira mais simples de enviar SMS agendados a partir do Objective-C é usar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Ao usar essa API, você enviará mensagens SMS enviando uma solicitação HTTP Post para o gateway de SMS. A solicitação HTTP Post conterá uma mensagem formatada em formato json. O gateway de SMS enviará esse SMS para o telefone do destinatário e retornará uma resposta HTTP 200 OK para sua solicitação.

como agendar um sms em objective c
Figura 1 - Como agendar um SMS em Objective C

Código Objective-C para enviar SMS agendado para celular

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 de seus projetos.

SendScheduledSms.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" ];
    
    MessageApi * api = [ [ MessageApi alloc ] initWithConfiguration : configuration ];
    
    Message * msg = [ [ Message alloc ] init ];
    [ msg setToAddress : @"+36201111111" ];
    [ msg setText : @"Hello world 1" ];
    
    NSDateFormatter * dateFormat = [ [ NSDateFormatter alloc ] init ];
    [ dateFormat setDateFormat : @"yyyy-MM-dd HH:mm:ss" ];
    
    [ msg setTimeToSend: [ dateFormat dateFromString : @"2021-07-23 10:00:00" ] ] ;
    
    MessageSendResult * result = [ api SendMessage : msg ];
    
    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 aplicativo 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 por meio de uma conexão wireless ou pela Internet.

Baixar SendScheduledSms.m

O código-fonte explicado neste artigo pode ser baixado, usado e modificado gratuitamente.
Download: SendScheduledSms.m.zip (46.2Kb)

O que está no arquivo SendScheduledSms.m?

O arquivo SendScheduledSms.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 SendScheduledSms no zip, que contém o código de exemplo para mostrar como enviar um SMS. Este código de exemplo está listado abaixo.

diretório send scheduled sms m
Figura 2 - O que está dentro de SendScheduledSms.m.zip

Como enviar SMS agendado a partir do Objective-C (Passos rápidos)

Para enviar SMS agendado a partir do Objective-C:

  1. Instale um usuário de API HTTP em uma máquina Windows
  2. Ative "Log communication events" na guia Advanced
  3. Configure o Xcode
  4. Baixe e extraia o arquivo SendScheduledSms.m.zip
  5. Abra o arquivo SendScheduledSms.xcodeproj no Xcode
  6. Inicie o aplicativo Ozeki SMS Gateway em sua máquina Windows
  7. Execute o código Objective C SendScheduledSms.m no Xcode
  8. Verifique os logs para ver se o SMS foi enviado
Instale o Ozeki SMS Gateway e crie um usuário de API HTTP

Para poder enviar SMS a partir do 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 GUI do Ozeki para verificar se sua conexão com a rede móvel está funcionando. O passo final para preparar seu ambiente é criar um usuário de API HTTP de SMS. Crie um usuário com o nome de usuário "http_user" e senha "qwe123" para fazer o exemplo funcionar sem modificações.

Após a configuração do ambiente, você pode executar seu código Objective-C.

URL da API HTTP para enviar SMS a partir do Objective-C

Para enviar SMS a partir do Objective-C, seu código Objective-C terá que enviar uma solicitaçã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 de SMS em Objective-C está sendo executado, 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 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 submeter 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: 333
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: SendScheduledSms.m (unknown version) CFNetwork/1220.1 Darwin/20.3.0
 
{
	"messages": [
		{
			"is_view_report_requested": false,
			"create_date": "2021-07-23T10:16:59",
			"message_id": "cab9eb77-309b-4aa4-99ba-cdac32388f7d",
			"time_to_send": "2021-07-23T10:20:00",
			"valid_until": "2021-07-30T10:16:59",
			"is_submit_report_requested": false,
			"to_address": "+36201111111",
			"text": "Hello world 1",
			"is_delivery_report_requested": false
		}
	]
}

Resposta HTTP recebida pelo exemplo de SMS em Objective-C

Assim que o gateway 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:58:42 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "Messages queued for delivery.",
	"data": {
	  "total_count": 1,
	  "success_count": 1,
	  "failed_count": 0,
	  "messages": [
	    {
	      "message_id": "cab9eb77-309b-4aa4-99ba-cdac32388f7d",
	      "from_station": "%",
	      "to_address": "+36201111111",
	      "to_station": "%",
	      "text": "Hello world 1",
	      "create_date": "2021-07-23 10:16:59",
	      "valid_until": "2021-07-30 10:16:59",
	      "time_to_send": "2021-07-23 10:20:00",
	      "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: SendScheduledSms.xcodeproj

Como baixar o código de exemplo (Tutorial em vídeo)

Neste vídeo, você verá como pode baixar o código-fonte para envio agendado de SMS. Ele começará com a página de download e o guiará até a abertura do projeto. Você aprenderá como baixá-lo e qual programa usar para abrir o projeto. O vídeo tem apenas 28 segundos, mas é muito detalhado, então você não terá problemas em seguir os passos. Não perca mais tempo. Vamos começar a enviar SMS!

Vídeo 1 - Como baixar e abrir a solução acima (Tutorial em vídeo)

O código de exemplo abaixo faz parte do projeto SendScheduledSms.xcodeproj. No zip, há apenas um projeto: SendScheduledSms.xcodeproj, e três arquivos: SendScheduledSms.m, Ozeki.Libs.Rest.h, Ozeki.Libs.Rest.m.

como enviar sms agendado usando objective c
Figura 3 - SendScheduledSms.xcodeproj

Como usar o código (Tutorial em vídeo)

Neste vídeo, apresentaremos como usar o projeto SendScheduledSMS. Ele começará com a aba de eventos vazia no Ozeki SMS Gateway e o guiará até a aba de eventos com o registro da primeira mensagem SMS enviada. Você aprenderá como abrir a aba de eventos e como executar o código de envio agendado de SMS no Xcode. Este vídeo é ótimo porque leva apenas 1 minuto para assistir, mas contém todas as informações que você precisa.

Vídeo 2 - Como usar o projeto SendScheduledSms.xcodeproj (Tutorial em vídeo)

Resumo

Este artigo explicou como agendar mensagens em Objective C. Esta é uma função realmente útil se você deseja enviar SMS em um horário específico. Esta solução ajuda você ou sua empresa a ser mais amigável com o cliente, pois as mensagens serão entregues quando os clientes não estiverem ocupados. É importante notar que o Ozeki SMS Gateway funciona em qualquer país e pode enviar e receber SMS através de várias conexões móveis.

Certifique-se de que a leitura não termine aqui, visite a página de tutoriais da Ozeki, onde mais informações podem ser encontradas sobre tópicos como exclusão em Objective C.

Agora, a única coisa a fazer é baixar o Ozeki SMS Gateway e começar a trabalhar!

More information