Products

Comece a usar a API de SMS da Infobip: Um Guia Rápido para Iniciar

Com uma API de SMS de fácil integração é extremamente simples começar a enviar mensagens de texto para os seus clientes.

May 31 2016

Usar a API de SMS da Infobip é simples e fácil. A API foi projetada para que qualquer desenvolvedor possa integrar rapidamente a API de SMS aos seus aplicativos e começar a enviar mensagens para os clientes imediatamente.

Uma vez que o seu acesso de desenvolvedor for aprovado e configurarmos as mensagens de SMS na sua conta, você pode alcançar seus clientes sempre que quiser, onde eles estiverem, em qualquer lugar do mundo. A API de SMS básica da Infobip tem apenas oito linhas de código. Isso é tudo que é preciso para começar a enviar mensagens para seus clientes.

As contas e desenvolvedores aprovados podem usar a API de SMS para:

  • Enviar mensagens de texto de SMS básicas para qualquer lugar do mundo
  • Checar o custo da mensagem e taxas de entrega por país
  • Enviar compartilhamentos sociais e convites (por exemplo, links para baixar aplicativos)
  • Enviar Flash SMS para qualquer lugar do mundo

FALAMOS A SUA LÍNGUA

A API de SMS está baseada nos padrões REST, com todas as solicitações geradas por meio de métodos PUSH, POST e GET. A API da Infobip aceita conteúdos JSON e XML, além de suportar Java, PHP, Python, C# e Ruby on Rails.

Se você tiver dúvidas, o nosso hub de desenvolvedores de APIs tem exemplos e tutoriais detalhados para ajudá-lo a começar e para responder as suas perguntas.

COMO COMEÇAR A ENVIAR MENSAGENS COM A API DE SMS

Vamos explorar a API de SMS da Infobip com alguns exemplos e amostras de código. Primeiramente, os fundamentos do SMS. As normas de SMS são simples:

  • Cada mensagem deve ter no máximo 160 caracteres
  • O número de telefone para o qual você enviará a mensagem deve ter a formatação de números E.164

A API de SMS da Infobip atende a diferentes operadoras de redes móveis e requisitos específicos dos países, para que você só precise se preocupar em escrever o código. Segue o exemplo mais básico de como enviar uma mensagem via API—as oito linhas para fazer isso:

JSON
POST /sms/1/text/single HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
Accept: application/json

{  
   "from":"InfoSMS",
   "to":"41793026727",
   "text":"Teste de SMS."
}

 

ENVIO PARA DIVERSOS DESTINATÁRIOS

Utilizar a API para enviar várias mensagens de texto (ou enviar mensagens para diversos destinatários) não é mais complicado do que enviar uma única mensagem (vide abaixo):

JSON
POST /sms/1/text/multi HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
Accept: application/json

{  
   "messages":[  
      {  
         "from":"InfoSMS",
         "to":[  
            "41793026727",
            "41793026731"
         ],
         "text":"Que a força esteja com você!"
      },
      {  
         "from":"41793026700",
         "to":"41793026785",
         "text":"Há muito tempo atrás, em uma galáxia muito, muito distante... Em um período de guerra civil, naves rebeldes atacando de uma base escondida conquistaram sua primeira vitória contra o Império Galático do mal."
      }
   ]
}

 

ENVIO DE CONVITES SOCIAIS E LINKS DE APLICATIVOS

A API permite integrar Convites Sociais e compartilhar aplicativos. O exemplo abaixo enviará o link e também permitirá o rastreio do link utilizando o Portal Infobip.Convites Sociais são formas poderosas e fáceis de promover o download de aplicativos e o engajamento dos usuários.

JSON
POST /sms/1/text/advanced HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json

{
   "bulkId":"BULK-ID-123-xyz",
   "messages":[
      {
         "from":"InfoSMS",
         "destinations":[
            {
               "to":"41793026727",
               "messageId":"MESSAGE-ID-123-xyz"
            },
            {
               "to":"41793026731"
            }
         ],
         "text":"Oi, veja este aplicativo incrível:   https://play.google.com/store/apps/details?id=com.myApp"
      }
    ],
   "tracking":{
         "track":"URL",
         "type":"SOCIAL_INVITES"
    }
}

 

MENSAGENS COMPLETAS

As opções de mensageria com todos os recursos incorporados à API de SMS permitem especificar parâmetros adicionais que tornarão suas campanhas mais atraentes—e mais fáceis de controlar para relatórios e análises.

SUPORTE A IDIOMAS

Os clientes desejam ver as mensagens em seu idioma preferido, mas o idioma padrão utilizado para SMS não tem todas as letras do mundo. Você pode usar caracteres Unicode, mas fazer isso reduz o tamanho da sua mensagem. Isso significa que você pode precisar enviar um texto dividido em duas mensagens, dobrando seus custos. A Infobip tem duas soluções para reduzir custos e melhorar a experiência do cliente ao usar idiomas complexos.

A transliteração converte o Unicode automaticamente para o conjunto de caracteres regulares. Seu desenvolvedor só precisa definir um parâmetro no código para um dos alfabetos suportados (turco, grego, cirílico, cirílico sérvio, europeu central ou báltico) e a API cuida do resto.

O identificador de idiomas nacionais é uma tecnologia de codificação similar à transliteração para idiomas que exigem muitos sinais diacríticos. Ele também pode ser definido como um parâmetro. Nossa API, atualmente, suporta os idiomas turco, espanhol e português.

Flash SMS

Um banco detecta uma possível fraude. Uma companhia aérea faz uma mudança de última hora no portão de embarque. Quando seus clientes precisam ver mensagens urgentes, as mensagens Flash SMS pulam na sua caixa de entrada do celular e são exibidas diretamente na tela inicial do seu cliente. Apenas uma linha de código adicional permite o envio de mensagens de Flash SMS no seu aplicativo utilizando a API de SMS.

MOMENTO PERFEITO PARA AS SUAS MENSAGENS

Para ajudá-lo a enviar suas mensagens quando elas serão mais efetivas e úteis aos seus clientes, a nossa API de mensageria inclui dois parâmetros de tempo:

  • O “sendAt” permite agendar as mensagens para serem entregues em um horário definido
  • “Validity Period” permite o envio de mensagens dentro de um intervalo de tempo predeterminado

Você não precisa se preocupar com a possibilidade de usar o formato de 12 ou 24 horas—a documentação da API da Infobip mostra os formatos de hora exigidos.

Ninguém quer receber mensagens às 4h da manhã, mas o horário correto não o impede apenas de acordar seus clientes, também evita que você descumpra leis e regulamentos locais. Na Índia, as mensagens de marketing só podem ser enviadas das 09h às 21h (mesmo se você tiver permissão para enviar a mensagem para o seu cliente). A API de SMS e nossa equipe de especialistas em mensageria móvel vão ajudá-lo a se manter dentro das regras e regulamentos locais conforme você amplia seus envios globalmente. Navegar pelas leis e regulamentos locais é apenas uma parte dos nossos programas de suporte a desenvolvedores, que oferecemos sem custo adicional.

MONITORAMENTO DE CAMPANHAS

Nossas ferramentas de relatório simples e poderosas ajudam a identificar o que está funcionando e o que não está nas suas campanhas. A API de SMS fornece os dados para que você faça mudanças rapidamente, visando melhorar as aberturas, atividades e taxas de entrega.

RELATÓRIOS BÁSICOS

Cada mensagem que você envia gera um código de resposta, que será entregue a você, via API. 200 OK significa que a mensagem foi enviada. Se algo der errado, a API irá informá-lo. O código de resposta mostra qual foi o problema e nosso arquivo e recursos de desenvolvedores vão ajudá-lo a determinar a causa e como corrigir o problema.

A API oferece acesso aos relatórios de entrega para o seu aplicativo e campanhas. Estes relatórios identificam cada mensagem de texto e oferecem os seguintes dados aos desenvolvedores:

  • Preço por mensagem
  • Status da mensagem
  • Erros, se houver

Estes dados podem ser usados na forma em que se encontram ou incorporados a relatórios personalizados para outras partes interessadas e membros da equipe.

RELATÓRIOS COMPLETOS

A API de SMS permite definir parâmetros de monitoramento de campanhas e mensagens. O monitoramento preciso é essencial para mensagens críticas—como o envio de PINs para o 2-Fator de Autenticação—e também para determinar os resultados de qualquer campanha de mensageria.

ID DE ENVIO EM MASSA E ID DE MENSAGEM PERSONALIZADOS

Você pode acompanhar o desempenho de uma única campanha definindo um ID para um grupo de mensagens. Esses IDs podem ser gerados automaticamente ou definidos por você. Configurar IDs de rastreamento com a API de SMS é simples:

JSON
POST /sms/1/text/advanced HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json

{
   "bulkId":"CUSTOM-BULK-ID-1",
   "messages":[
      {
         "from":"InfoSMS",
         "destinations":[
            {
               "to":"41793026727",
               "messageId":"CUSTOM-MESSAGE-ID-1"
            },
            {
               "to":"41793026731",
               "messageId":"CUSTOM-MESSAGE-ID-2"
            }
         ],
         "text":"Há muito tempo atrás, em uma galáxia muito, muito distante..."
      },
      {
         "from":"41793026700",
         "destinations":[
            {
               "to":"41793026785"
            }
         ],
         "text":"Em um período de guerra civil, naves rebeldes atacando de uma base escondida conquistaram sua primeira vitória contra o Império Galáctico do mal."
      }
   ]
}

 

RELATÓRIOS DE ENTREGA INTERMEDIÁRIOS, EM TEMPO REAL

A API pode enviar relatórios em tempo real sempre que um erro de entrega ocorrer para que você possa tomar medidas imediatas e não ter que esperar o fim da campanha para corrigir problemas. Por exemplo, se os PINs não estiverem chegando a determinados clientes. Você pode ver quais países e operadoras estão causando a maioria dos erros. Os relatórios em tempo real permitem ajustar as campanhas enquanto elas estão ocorrendo para otimizar a entrega e ações.

TAXAS DE CONVERSÃO

As suas mensagens estão sendo abertas? As pessoas estão clicando nos links? Quais usuários, em quais países? Os usuários de iOS estão mais engajados do que os de Android?

A definição de um parâmetro simples no seu código, exibe uma mensagem como uma possível conversão, uma vez que uma ação seja tomada. Após a tomada de ação no seu aplicativo ou site, você enviará essas informações de volta para a Infobip. Vamos combiná-las ao nosso relatório e te mandar as taxas de conversão, que podem ser segmentadas por:

  • País
  • Operadora de rede celular
  • Sistema operacional
  • Horário de recebimento

Você pode usar a API de SMS para criar relatórios personalizados, de erros, marketing ou custos de campanhas.

ENCURTAMENTO E MONITORAMENTO DE URLS

Você pode acompanhar os clique-throughs da sua mensagem para o seu site ou outro destino. A API pode encurtar URLs para que elas se encaixem nos limites de caracteres de SMS e monitorar os click-throughs automaticamente para você.

Quando um usuário clica em um link, você receberá um relatório que inclui as seguintes informações sobre ele:

  • Número de telefone
  • País
  • Operadora de rede celular
  • Sistema operacional de telefonia

INDO ALÉM DO TEXTO

Agora que você já domina os fundamentos da utilização da API de SMS da Infobip, pode usá-la para gerar, controlar e otimizar campanhas de mensagens de texto de maneira rápida e fácil.

Quando estiver pronto para que o seu aplicativo faça mais, a API de SMS pode gerenciar o Number Lookup (pesquisa de números), 2- Fator de autenticação, e mensageira em plataformas adicionais (e-mail, voz e chat/OTT). Todas essas funções avançadas estão disponíveis usando a mesma API e podem reutilizar grande parte do mesmo código desenvolvido para suas campanhas iniciais.

Comece conectando seus aplicativos ao SMS com a API de SMS da Infobip e ajude a sua empresa a atingir bilhões de pessoas em todo o mundo.

Teste Nossa Plataforma