Embed Size (px)
Citation preview
https://suporte.icewarp.com.br/index.php?_m=knowledgebase&_a=viewarticle&kbarticleid=336
Como enviar e receber SMS pelo IceWarp Server?
Autor:IceWarp Brasil
Criado em:02 Oct 2007 10:03 PM
O servidor de SMS do IceWarp Server permite enviar e receber torpedos via Email. Éextremamente útil para diversas funções, como promoções (recebimento de torpedos),mobile commerce (envio de mala direta via SMS), envio de alertas para monitoramento deservidores, ativação de funções como boot do servidor via SMS, etc.
Antes de mais nada, verifique se sua licença para o módulo SMS não está expirada. Casoesteja expirada, entre em contato com licencas em icewarp.com.br enviando seu license.xml paraque possamos fornecer 30 dias de trial.
O sistema opera de duas possÃveis formas:
1 - através de modem GSM2 - através de requests HTTP
1) No caso de um modem GSM (testado com modems 3G USB da Tim, Claro, Vivo e Oi), configureo mesmo na aba Geral, conforme tela a seguir. Observe que informarmos a porta decomunicação (que pode ser verificada no gerenciador de dispositivo do Windows), escolhemostipo GSM e definimos também o número do SMS Center (que pode ser visto no softwarefornecido pela operadora de telefonia, procure por "Centro SMS").
Números do SMS Center são de responsabilidade das operadores e não podemos fornecergarantias quanto à validade dos mesmos.
No caso da TIM, seguem alguns SMS Centers por região:
TSP - +551181138200 - Todo Estado de SPTRJ - +552181138200 - Estados Do RJ e ESTNO - +559181119200 - Estados do AM, PA, MA, AP e RRTCO - +556181136200 - Estados do AC, TO, GO, DF, MS, MT e ROTRS - +555181136200 - Todo o Estado do RSTSL - +554199138200 - PR, SC e Pelotas (RS)TLE - +553191938200 - MG, BA e SETNE - +558199238200 - CE, RN, AL, PE, e PI
No caso da OI, temos o SMS Center: +550310000010
No caso da Vivo, SMS Center: +550101102010
Page 1/5Powered By Kayako SupportSuite
https://suporte.icewarp.com.br/index.php?_m=knowledgebase&_a=viewarticle&kbarticleid=336
Vale ressaltar a importância de manter o software da operadora de telefonia desativado, paraevitar conflito.
Na tela acima, note que cada gateway tem seu ID, que pode ser referenciado via URL para enviarmensagens através de um gateway especÃfico, ou atrelar, nas propriedades da conta de umusuário, qual gateway ele deve usar (com controle de quantos torpedos cada conta enviou). Vocêpode, ainda, fixar o FROM, para garantir replies.
1.1) Enviando torpedos/SMS
Você pode alocar cópias para SMS, em Filtros, Regras e cópias/encaminhamento de contas.Basta usar a sintaxe sms:número (ex: sms:2199221133). Para que seus usuários possam enviarSMS via email, é necessário criar uma conta de e-mail especial em seu IceWarp Server. Note,conforme tela a seguir, que criamos uma conta chamada SMS (alias) e no campo Encaminha p/:informamos sms:%%extensionnosep%%
Na aba Caixa de Correio da conta, marque a opção NULA, de forma que esta conta nãoarmazena mensagens, servindo apenas para encaminhar mensagens para SMS.
Agora, a partir do Cliente Web, você pode enviar uma mensagem que será enviada como SMSpara qualquer telefone celular (contato que suportado pela operadora). A sintaxe é<sms:numero>
Veja o exemplo na tela abaixo:
Vale ressaltar que, na v10, há um link SMS em novas mensagens, caso clique no mesmo, seráaberto um campo onde basta informar o número do SMS (caso use gateway Clickatell, especifiquecom código do páis, ex: 552188888888).
Para enviar SMS a partir de um programa de email (como Outlook), utilize uma das seguintessintaxes:
"sms:+552199992222"@darnis.comouVineeta <"sms:+552199992222"@exemplo.com>ou"Vineeta Darnis" <"sms:+552199992222"@exemplo.com>
1.2) Recebimento de Torpedos
Veja a aba Msgs de Entrada, no módulo SMS. É possÃvel criar regras, como
"Quando assunto combina com string teste, encaminhar para [email protected]".
Page 2/5Powered By Kayako SupportSuite
https://suporte.icewarp.com.br/index.php?_m=knowledgebase&_a=viewarticle&kbarticleid=336
Na aba mensagens de entrada há duas opções interessantes, úteis apenas quando se usa ummodem GSM, o que permite receber SMSs em sua caixa de e-mail.
Uma verifica por #email# dentro do SMS e, caso encontrado, o SMS será entregue para arespectiva conta de email. A outra é um método inteligente que grava um histórico de todas asmensagens enviadas (remetente e número de destino) e, caso um SMS de entrada chegue de umnúmero para o qual anteriormente enviado uma mensagem, o histórico é lido e a mensagemé enviada para aquele remetente (dentro de um perÃodo de tempo). Isso torna possÃvel enviarSMS e receber um reply sem ter que definir quais regras.
2) Através de requests HTTP
É possÃvel utilizar serviços como Clickatell para o envio de torpedos, ou até fazer com queum IceWarp Server encaminhe mensagens para outro servidor IceWarp que possua um modemGSM acoplado.
Veja whitepaper (em inglês) sobre como configurar o gateway da Clickatell no IceWarp Server.Você pode obter uma conta de avaliação na maioria dos sistemas como Clickatell e configurara chamada no IceWarp, em Serviço SMS / guia Geral / botão Adicionar, além é claro, dousuário ter o serviço SMS ativado em sua conta (o que deve ocorrer por padrão devido ao fatodo Modo de acesso estar definido por default para Todas contas).
A sintaxe comumente usada é:
http://api.clickatell.com/http/sendmsg?user=usuario&password=senha&api_id=xxxx&to=%number%&data=%data%&concat=%parts%
Claro, necessário adaptar os devidos campos (user, password e api_id), conforme orientaçãodo Whitepaper.
Atenção: Notamos que o serviço padrão da Clickatell costuma enfrentar problemas paraenviar SMSs apenas para celulares Nextel, assim como números que tenham sido portados(alterado a operadora e mantido mesmo número). Há uma solução, entretanto, que envolvesolicitar à Clickatell um profile especial que consegue enviar SMSs para Nextel, além das demaisoperadores. O custo é um pouco mais alto, de aproximadamente 2 créditos (cerca de US$ 0,12por SMS). Solicite algo como "I requested special profile for ported numbers in Brazil, that is able tosend SMSs to Nextel devices".
Uma ótima opção, por nós recomendada, é a Mobile Pronto (http://www.mobilepronto.org),empresa nacional que garante 99.8% de SLA no envio de SMSs para o Brasil e não temproblemas para realizar envios para qualquer operadora, incluindo Nextel. Caso haja interesse,favor abrir um chamado juntoa o suporte IceWarp, a fim de colocarmos você em contato com osresponsáveis por tal sistema, garantindo um perÃodo de avaliação e suporte personalizado.
A sintaxe do gateway via Mobile Pronto fica da seguinte forma:
http://www.mpgateway.com/v_2_00/smspush/enviasms.aspx?Credencial=xxxx&Principal_User=yyyy&Aux_User=F1&Mobile=%number%&Send_Project=N&Message=%data%
Page 3/5Powered By Kayako SupportSuite
https://suporte.icewarp.com.br/index.php?_m=knowledgebase&_a=viewarticle&kbarticleid=336
Os parâmetros Credencial e Principal_User devem ser substituidos por valores que você podeverificar efetuando login com seu cadastro no site da MobilePronto e acessando a opçãoConfigurações/Editar dados do projeto. O campo PROJETO, em tal opção, indica oPrincipal_User, bem como é referenciado o valor para o parâmetro Credencial.
Ressaltamos a importância de não realizar o chamado spam, envio de SMSs para pessoas quenão autorizaram tal envio, o que pode lhe causar sérios problemas.
Temos também clientes usando o serviço brasileiro Human com a seguinte sintaxe:
http://system.human.com.br/GatewayIntegration/msgSms.do?dispatch=send&account=xxxx&code=yyyy&to=%number%&msg=%data%
xxxx = account / userid yyyy = senha
A Human tem restrições ao uso do sistema deles para fins pessoais ou envio de mala direta.
Há diversos outros sistemas no mercado (como tww.com.br), bastando realizar uma busca noGoogle por "gateway SMS" e localizar sistemas que permitem realizar o envio via chamada HTTP.Caso tenha alguma sugestão de operadora, favor nos informar.
O Routomessaging, citado no manual do IceWarp, é uma opção interessante, porémapresenta problemas de envio para aparelhos Nextel e, diferentemente da Clickatell, até agoranão nos forneceu uma solução. De toda forma, a sintaxe nesse sistema é:
http://smsc5.routotelecom.com/SMSsend?user=xxxx&pass=xxxxx&number=%number%&message=%data%&type=LongSMS
Você pode usar as mesmas funcionalidades citadas no item 1, caso utilize gateway da Clickatellao invés de modem GSM. A única excessão é o recebimento de SMS. Há, entretanto, umasolução que permite receber respostas de SMSs enviados pelo IceWarp (via Clickatell) em seutelefone celular. Veja o seguinte FAQ: https://suporte.icewarp.com.br/index.php?_m=knowledgebase&_a=viewarticle&kbarticleid=625
Outro aspecto interessante é a aba Mensagens de saÃda que lhe oferece uma série depossibilidades, como arquivar mensagens de SMS enviadas como email, verificar o remetente,conteúdo do SMS e escrever regras de reescrita para o número de destino. Você pode verificarse uma mensagem de saÃda SMS já está saindo através de um gateway especÃfico e casonegativo, baseado no prefixo do número, roteá-la através de um gateway especÃfico (vejaEditar Cabeçalhos da Mensagem e o novo regex Rewrite). Veja icewarp/doc/releasenotes.txt paradetalhes.
Outras dicas
- Veja como realizar integração com aplicativos: https://suporte.icewarp.com.br/index.php?_m=knowledgebase&_a=viewarticle&kbarticleid
Page 4/5Powered By Kayako SupportSuite
https://suporte.icewarp.com.br/index.php?_m=knowledgebase&_a=viewarticle&kbarticleid=336
=499
- Na v10 a autenticação é requerida sempre, caso o usuário não tenha autenticado SMTP. Aautenticação SMTP, na v10, ocorre mesmo quando acessando via Cliente Web, portanto vocênão deve ter problemas.
De toda forma, você pode incluir o usuário na guia Autenticação do módulo de SMS, noconsole, caso o usuário não esteja autenticando SMTP ou até não exista no servidor.
Caso queira incluir um endereço SMS em um tipo de conta que não possui autenticação,como mailing lists ou notificações, use a seguinte sintaxe:
<sms:[email protected]&pass=senha>, especificando dados de uma contaválida.
No caso acima, a contagem do envio do SMS seria feita para a conta que você especificou naautenticação. Uma outra opção é colocar a autenticação direto na conta SMS: criada noitem 1.1, porém nesse caso todos os envios são autenticados com uma única conta.
Finalmente, mais uma opção para fugir da autenticação em contas que não sejam do tipousuário, é desativar a autentição do SMS via API, usando o seguinte comando na raÃz doIceWarp:
tool modify system C_SMSService_RequireAuth 0
Cuidado, pois nesse caso, a autenticação não será requerida. Sempre pode ser interessantecriar mecanismos adicionais de proteção, por exemplo, em mailing lists, a proteção por senha(client moderator), a opção "somente membros podem enviar mensagens" ou uma Regra querestrinja envio para aqueles que autenticam SMTP (caso não ocorra autenticação SMTP,rejeitar).
- Para alertas de servidores, pode ser útil criar contas de notificação que encaminham para oseu <sms>, já que você pode definir tamanho máximo da mensagem, separar mensagens emvários SMSs e fazer com que o assunto, data, corpo da mensagem, etc. constem no assunto/noSMS (basta marcar as checkboxes de Inserir no assunto na guia Opções de uma conta denotificação).
Page 5/5Powered By Kayako SupportSuite
