API SMS SHORT CODE: Aderente as Principais Plataformas

API SMS SHORT CODE

API SMS SHORT CODE

Uma API SMS Short Code pode melhorar muito a comunicação da sua empresa, criando rotinas, automatizando processo de comunicação, fique ligado nas dicas que vamos te passar.

A tecnologia está sempre evoluindo e, com ela, as empresas precisam se atualizar para atender às demandas de seus clientes. Uma das formas de fazer isso é através da utilização de API SMS Short Code, uma ferramenta que pode trazer inúmeros benefícios para as empresas que desejam se comunicar de forma eficiente com seus clientes.

Neste artigo, como um especialista na área, vou falar sobre as vantagens, benefícios e o porquê de usar a API SMS Short Code na empresa.

Primeiro vamos entender o que é um SMS Short Code

Um SMS Short Code é um número de celular curto (geralmente 5 ou 6 dígitos) que pode ser usado para enviar e receber mensagens de texto curtas (SMS) de um público mais amplo. Estes códigos são usados ​​principalmente para campanhas de marketing e serviços de mensagens, pois permitem que as empresas interajam com seus clientes de forma eficiente e acessível. Esses códigos curtos também são úteis para as pessoas que desejam se inscrever para serviços de mensagens ou participar de promoções ou concursos. Os Short Codes também podem ser usados ​​para envio de mensagens de alerta, como notificações sobre mudanças climáticas, emergências médicas, condições de trânsito e outras notificações importantes.

Vamos entender também o que são APIs

Uma API (Application Programming Interface) é um conjunto de protocolos, ferramentas e subrotinas que permitem a criação de aplicativos que interajam com outros serviços. As APIs permitem a comunicação entre aplicativos, permitindo que eles compartilhem informações e recursos. Elas também ajudam a tornar os serviços mais acessíveis para os usuários, permitindo que os aplicativos se comuniquem e se envolvam com os serviços. APIs também tornam a criação de aplicativos mais fácil, permitindo aos desenvolvedores aproveitar recursos de outros serviços e aplicativos para criar os seus próprios.

Agora que já sabemos o que é cada um, vamos entender como usar essas duas ferramentas unidas para potencializar nossa comunicação através dos envios de SMS.

O que é API SMS Short Code?

API SMS Short Code é um serviço de envio de mensagens de texto por meio de uma plataforma de integração de programação de aplicativos (API). Essa plataforma permite a conexão entre as empresas e as operadoras de telefonia móvel para o envio de SMSs.

O uso de API SMS Short Code traz vantagens para empresas de diferentes tamanhos e setores. Abaixo, listo algumas pautas que podem ser abordadas para ilustrar esses benefícios.

Uma vantagem importante do uso do SMS Short Code é a possibilidade de integração com outras plataformas. Por exemplo, as APIs SMS Short Code permitem a integração com aplicativos móveis, permitindo aos usuários enviar e receber mensagens de texto de forma fácil e eficiente.

Além disso, é importante destacar que o uso das APIs SMS Short Code é mais seguro do que o envio de SMSs usando números de telefone regulares. Isso se deve ao fato de que os serviços usam processos de autenticação para garantir a segurança e a confidencialidade das informações compartilhadas.

Por fim, vale destacar que as APIs SMS Short Code são uma ótima maneira de envolver os usuários, permitindo o envio de mensagens personalizadas e interativas para os clientes. Isso pode ajudar a aumentar a visibilidade de uma marca e a fidelidade do cliente.

Por que as empresas devem ter API de SMS Short Code?

As APIs SMS Short Code oferecem um grande número de vantagens para as empresas, pois permitem que elas entrem em contato diretamente com seus clientes e aumentem seu envolvimento. Além disso, a API também oferece segurança, o que ajuda a assegurar que os dados dos clientes sejam mantidos seguros e confidenciais.

Além disso, a API SMS Short Code permitem que as empresas enviam mensagens de texto de forma eficiente e personalizada. Isso permite que as empresas criem campanhas de marketing mais direcionadas, o que ajuda a aumentar o envolvimento dos clientes.

Por fim, o uso de APIs SMS Short Code torna a criação de aplicativos mais fácil, pois permite que esses aplicativos acessem recursos de outros serviços e aplicativos. Isso permite que as empresas criem aplicativos mais avançados e funcionais para seus clientes.

Com uma API de SMS Short Code vou melhorar minha comunicação com meu clientes?

Sim, a API SMS Short Code permitem que as empresas estabeleçam uma comunicação mais direta com seus clientes. Isso porque elas permitem que as empresas enviam mensagens de texto de forma eficiente e personalizada. Além disso, as APIs também oferecem segurança, o que ajuda a garantir a confidencialidade dos dados dos clientes. Isso permite que as empresas criem campanhas de marketing mais direcionadas e aumentem o envolvimento dos clientes.

Como faço para encontrar uma API de confiança

A primeira coisa a fazer é pesquisar empresas de serviços de mensagens de texto que ofereçam APIs SMS Short Code. A maioria das empresas de serviços de mensagens oferecem API SMS Short Code, então você pode ter várias opções.

Depois de identificar algumas empresas, é importante comparar os preços e serviços oferecidos. Além disso, é importante verificar se a empresa tem um histórico de boas avaliações de clientes e se a plataforma oferece segurança adequada. Além disso, pesquise sobre os serviços de atendimento ao cliente para garantir que você receba suporte adequado em caso de problemas.

Quais são as vantagens de usar uma API na minha empresa

Além de permitir que as empresas estabeleçam uma comunicação mais direta com seus clientes, as API SMS Short Code oferecem vários outros benefícios. Por exemplo, elas permitem que os aplicativos se comuniquem e se envolvam com serviços externos. Além disso, as APIs oferecem mais segurança e também tornam a criação de aplicativos mais fácil, permitindo aos desenvolvedores aproveitar recursos de outros serviços e aplicativos.

Outra vantagem importante é que elas permitem que as empresas enviam mensagens de texto de forma eficiente e personalizada, o que ajuda a aumentar o envolvimento dos clientes. Isso também facilita o processo de marketing, pois permite que as empresas criem campanhas de marketing mais direcionadas.

Quais os benefícios de usar uma API SMS Short Code na minha empresa

Os benefícios de usar uma API SMS Short Code na sua empresa incluem a possibilidade de estabelecer uma comunicação mais direta com os seus clientes. Além disso, as APIs oferecem mais segurança e também tornam a criação de aplicativos mais fácil. Elas também permitem que as empresas enviam mensagens de texto de forma eficiente e personalizada, o que ajuda a aumentar o envolvimento dos clientes. Além disso, as APIs permitem a integração com outras plataformas, incluindo aplicativos móveis. Isso ajuda a tornar os serviços mais acessíveis para os usuários.

Melhore a eficiência operacional da sua comunicação

Uma maneira de melhorar a eficiência operacional da sua comunicação é usar uma API SMS Short Code. Isso permite que as empresas enviam mensagens de texto de forma eficiente e personalizada, o que ajuda a aumentar o envolvimento dos clientes. Além disso, as APIs oferecem mais segurança e também tornam a criação de aplicativos mais fácil. Elas também permitem a integração com outras plataformas, como aplicativos móveis, o que torna os serviços mais acessíveis. Por fim, as APIs também permitem a criação de campanhas de marketing mais direcionadas, o que ajuda a aumentar a visibilidade da marca e a fidelidade do cliente.

Faça campanha de SMS Marketing usando API

Uma maneira de criar campanhas de SMS Marketing é usar uma API SMS Short Code. Isso permite que as empresas enviam mensagens de texto de forma eficiente e personalizada. Além disso, as APIs oferecem mais segurança e também tornam a criação de aplicativos mais fácil. Elas também permitem a integração com outras plataformas, como aplicativos móveis, o que torna os serviços mais acessíveis. Isso também permite que as empresas criem campanhas de marketing mais direcionadas, o que ajuda a aumentar o envolvimento dos clientes. Além disso, as campanhas de SMS Marketing podem ser usadas para enviar ofertas especiais, alertas de mudanças climáticas, notificações de emergências médicas e outras notificações importantes.

Como a API da SpeedMarket pode ajudar a minha empresa?

A API da SpeedMarket pode ajudar a sua empresa a estabelecer uma comunicação mais direta com os seus clientes. Nossa plataforma é aderente a todas as plataformas, oferecendo segurança e garantindo a confidencialidade dos dados dos clientes. Além disso, nossa plataforma também torna a criação de aplicativos mais fácil, permitindo aos desenvolvedores aproveitar recursos de outros serviços e aplicativos.

Além disso, nossa plataforma também permite que as empresas enviam mensagens de texto de forma eficiente e personalizada. Isso permite que as empresas criem campanhas de marketing mais direcionadas, o que ajuda a aumentar o envolvimento dos clientes. Por fim, nossa plataforma também permite a integração com aplicativos móveis, o que torna os serviços mais acessíveis. Com a SpeedMarket, você tem a melhor plataforma de envio de SMS do mercado.

Veja abaixo as funcionalidade da nossa API SMS Short Code

Autenticação

É recomendado que todas as requisições a API HTTP utilize para autenticação cabeçalhos Basic Authorization em vez de parâmetros query string. Neste campo deve ser informado seu usuário e senha cadastrados em nosso site. Caso haja erro na autenticação, o respectivo código de erro será retornado.

Authorization: Basic dXN1YXJpbzpzZW5oYQ=

O valor após a palavra Basic é uma chave Base64 de seu usuário e senha. Para obter o valor, utilize o comando base64 do linux:

$ echo -n conta:senha | base64 
dXN1YXJpbzpzZW5oYQ=

O site base64Encode também faz essa codificação gratuitamente

Headers

Chamadas realizadas exclusivamente para API HTTP Envio em Lote devem incluir, além do cabeçalho de autenticação, os seguintes headers:

Content-Type:application/json
Accept:application/json

Restantes API HTTP, além do cabeçalho de autenticação devem incluir os seguintes headers:

Content-Type:application/x-www-form-urlencoded

Parâmetro campaign_id

campaign_id

Ao enviar uma requisição, recomendamos que você utilize este parâmetro. Ele serve como um identificador de sua mensagem em nossa plataforma e pode ser utilizado para consulta de status. Este parâmetro também possui a funcionalidade de proteção contra envios duplicados (habilite esta função com nosso suporte).

Parâmetro type

type

Ao enviar uma requisição, é necessário que você utilize este parâmetro. Ele serve para identificar o tipo do serviço da mensagem.

Veja abaixo a tabela contendo os valores aceitos para este parâmetro:

typeTipo do Serviço
0SMS
1SMS Interativo(Modo Flash)
2SMS Interativo
3Torpedo de Voz (Apenas Texto)
4Torpedo de Voz (Áudio)
5Whatsapp (Apenas Texto)
6Whatsapp (Imagem)
7Whatsapp (Áudio)
8Whatsapp (Vídeo)

Status de Chamada

As chamadas à API irão retornar dois parâmetros de status, um numérico denominado responseCode e o outro alfanumérico denominado responseDescription, os dois correspondem a mesma informação.

A seguir, veja a lista de status suportados pela nossa API:

API de Envio
API de Consulta
Todas API
responseCoderesponseDescriptionsuccess
000Success queuedtrue
001Batch processedtrue
002Scheduledtrue
010User or password is invalidfalse
020Empty or invalid typefalse
030Empty message contentfalse
040Scheduling date invalid or incorrectfalse
050Empty or invalid numberfalse
060International sending not allowedfalse
070Message rejected by serverfalse
080Insufficient or expired balancefalse
090Blocked account – Please contact supportfalse
100This service is currently under maintenancefalse
110There was an error processing, please try again, or contact usfalse
120Message array cannot exceed 5000false
130Message array is emptyfalse
140Incorrect time zonefalse
150File extension not allowedfalse
160Unknown method or unknown parameterfalse
170Invalid search attributesfalse
200Successful searchtrue

Status de Envio

Status obtidos através da API de Consulta ou Callback podem possuir três níveis, conforme a seguir:

Status de preparação da mensagem para envio, este status e não é retornado por Callback:

StatusDescription
-1Message Queued
3Preparing message to send
6Paused Message

Status de entrega na operadora, este é o primeiro status que retornamos por Callback:

Envio Individual


Este método é indicado para clientes que realizão requisições contendo apenas um destinatário. Ele utiliza protocolos HTTP e HTTPS, aceita os métodos GET e POST com parâmetros query string.

– URL para envio individual

http://54.233.99.254/webservice-rest/send-single

– Instruções para chamada

A requisição precisa conter parâmetros Query String com as informações conforme campos abaixo:

* Campo obrigatório

Envio em Lote

Permite o envio de mensagens em lote ou individuais passando os parâmetros por POST em um objeto JSON

– URL para envio em Lote

http://54.233.99.254/webservice-rest/send-multiple

– Instruções para chamada

O corpo da requisição precisa conter o objeto JSON com as informações conforme campos abaixo:

* Campo obrigatório

REFERENCE

Serviços da API

Envio Individual


Este método é indicado para clientes que realizão requisições contendo apenas um destinatário. Ele utiliza protocolos HTTP e HTTPS, aceita os métodos GET e POST com parâmetros query string.

– URL para envio individual

http://54.233.99.254/webservice-rest/send-single

– Instruções para chamada

A requisição precisa conter parâmetros Query String com as informações conforme campos abaixo:

* Campo obrigatório

CampoDetalhesTipo
user*Nome do usuário cadastrado em nosso site, obrigatório caso não utilize cabeçalho de autenticação.string
password*Senha de acesso do usuário, obrigatório caso não utilize cabeçalho de autenticação.string
type*Tipo do serviço, consulte o menu “Parâmetro type”.number
country_codeDDI do país de destino. (Padrão: 55)number
number*Número do telefone do destinatário sem DDI (55).number
content*(SMS):Texto da mensagem a ser enviada.string
(WHATSAPP Texto):Texto da mensagem a ser enviada.string
(WHATSAPP Imagem):URL da imagem hospedada em seu servidor. Aceito arquivo .jpg com até 1MB e máximo 1024 pixels.string
(WHATSAPP Vídeo):URL do vídeo hospedado em seu servidor. Aceito arquivo .mp4 com até 2MB.string
caption(SMS):Parâmetro não utilizado.string
(WHATSAPP):Texto com até 490 caracteres para legenda de imagem ou vídeo.string
campaign_idIdentificador da mensagem no sistema do cliente.string
scheduleData e hora em que a mensagem deve ser enviada no formato ISO 8691 (2020-11-01 15:00:00).string
timezoneFuso horário em formato UTC (-03:00).string

Clique abaixo e veja exemplos em várias linguagens de programação:

Testar Envio Individual

Em resposta à chamada, a API retornará um arquivo JSON com as informações necessárias para rastreio, será gerado um id e status do processo:

    {
            "success" : true,
            "responseCode" : "000",
            "responseDescription" : "Success queued",
            "credit" : "0"
            "balance" : "99984"
            "id" : "813831"
    }

Outro exemplo de retorno síncrono da chamada:

    {
            "success" : false,
            "responseCode" : "080",
            "responseDescription" : "Insufficient or expired balance",
            "credit" : "0"
            "balance" : "0"
    }
CampoDetalhesTipo
successEste campo indica se a requisição obteve sucesso ou não.boolean
responseCodeEste campo indica o código do status da requisição.string
responseDescriptionEste campo indica a descrição do status da requisição.string
creditEste campo indica quantos créditos foram debitados em sua conta.string
balanceEste campo indica o saldo atual de créditos em sua conta.string
idCaso a mensagem seja aceita, é retornado um código id único para rastreio.string

Para receber retornos assíncronos, consulte o menu “Callbacks da API”.

Envio em Lote na API SMS SHORT CODE

Permite o envio de mensagens em lote ou individuais passando os parâmetros por POST em um objeto JSON

– URL para envio em Lote

http://54.233.99.254/webservice-rest/send-multiple

– Instruções para chamada

O corpo da requisição precisa conter o objeto JSON com as informações conforme campos abaixo:

* Campo obrigatório

CampoDetalhesTipo
type*Tipo do serviço, consulte o menu “Parâmetro type”.number
country_codeDDI do país de destino. (Padrão: 55)number
number*Número do telefone do destinatário sem DDI (55).number
content*(SMS):Texto da mensagem a ser enviada.string
(WHATSAPP Texto):Texto da mensagem a ser enviada.string
(WHATSAPP Imagem):URL da imagem hospedada em seu servidor. Aceito arquivo .jpg com até 1MB e máximo 1024 pixels.string
(WHATSAPP Vídeo):URL do vídeo hospedado em seu servidor. Aceito arquivo .mp4 com até 2MB.string
caption(SMS):Parâmetro não utilizado.string
(WHATSAPP):Texto com até 490 caracteres para legenda de imagem ou vídeo.string
campaign_idIdentificador da mensagem no sistema do cliente.string
scheduleData e hora em que a mensagem deve ser enviada no formato ISO 8691 (2020-11-01 15:00:00).string
timezoneFuso horário em formato UTC (-03:00).string

Importante: Não é permitido o envio de mais de 5000 mensagens por requisição.

Clique abaixo e veja exemplos em várias linguagens de programação:

Testar Envio em Lote

Veja a seguir o exemplo da chamada acima:


    {
  "defaultValues":{
                   "type": 2,
                   "schedule": "2025-08-22 14:55:00",
                   "timezone": "-03:00"
              },
     "messages":[
                 {
                   "country_code": 55,
                   "number": 14999999999,
                   "content": "Mensagem de teste",
                   "campaign_id": "001"
                 },
                 {
                   "country_code": 55,
                   "number": 14999999999,
                   "content": "Mensagem de teste",
                   "campaign_id": "002"
                  }
              ]
    }              

Em resposta à chamada, a API retornará informações do processo conforme abaixo:


{
    "success": true,
    "responseCode": "001",
    "responseDescription": "Batch processed",
    "credit": "2",
    "balance": "87018",
    "totalProcessed": "2",
    "totalSuccess": "2",
    "messages": [
        {
            "success": true,
            "responseCode": "000",
            "responseDescription": "Success queued",
            "credit": "1"
        },
        {
            "success": true,
            "responseCode": "000",
            "responseDescription": "Success queued",
            "credit": "1"
        }
    ]
}

Outro exemplo de retorno síncrono da chamada:


{
    "success": true,
    "responseCode": "001",
    "responseDescription": "Batch processed",
    "credit": "1",
    "balance": "87018",
    "totalProcessed": "2",
    "totalSuccess": "1",
    "messages": [
        {
            "success": true,
            "responseCode": "000",
            "responseDescription": "Success queued",
            "credit": "1"
        },
        {
            "success": true,
            "responseCode": "050",
            "responseDescription": "Empty or invalid number",
            "credit": "0"
        }
    ]
}

Para receber retornos assíncronos, consulte o menu “Callbacks da API”.

Consulta de Status por Identificador

Para consultar o status das mensagens enviadas é necessário fazer uma requisição GET OU POST na URL abaixo passando como parâmetro o id ou o campaign_id obtido na resposta do envio

GET http://54.233.99.254/webservice-rest/mt_id

Importante: a consulta fica disponível por até 32 dias após seu envio.

Abaixo exemplo de requisições realizando a consulta por id e por campaign_id, é possivel também realizar a consulta em lote, para isso basta separar os identificadores com vírgulas

Consulta id:

GET http://54.233.99.254/webservice-rest/mt_id?user={user}&password={password}&id=1,2

Consulta campaign_id:

GET http://54.233.99.254/webservice-rest/mt_id?user={user}&password={password}&campaign_id=abc1,abc2

Clique abaixo e veja exemplos em várias linguagens de programação:

Consulta de Status por Período na API SMS SHORT CODE

Está requisição de busca irá retornar cada mensagem enviada num determinado período de tempo. Você precisa definir os parâmetros start_date e end_date para especificar um período de tempo, deverá ser utilizado o formato ISO-8601.

GET http://54.233.99.254/webservice-rest/mt_date

Importante: a consulta fica disponível por até 32 dias após seu envio.

Abaixo exemplo de requisição de consulta por período de tempo e tipo de serviço, através do parâmetro type.

GET http://54.233.99.254/webservice-rest/mt_date?user={user}&password={password}&start_date=2016-09-12T00:00:00&end_date=2016-09-15T23:59:59&type=2

Abaixo exemplo de requisição de consulta por período de tempo, tipo de serviço e status, através do parâmetro type e status.

GET http://54.233.99.254/webservice-rest/mt_date?user={user}&password={password}&start_date=2016-09-12T00:00:00&end_date=2016-09-15T23:59:59&type=2&status=0,1

Clique abaixo e veja exemplos em várias linguagens de programação:

Consulta por Novas Mensagens Recebidas

Retorna a lista de novas mensagens recebidas. Uma vez cosultada, a mensagem não irá mais ser retornada na chamada deste serviço.

GET http://54.233.99.254/webservice-rest/mo_new

Importante: a consulta fica disponível por até 32 dias após o recebimento.

Abaixo exemplo de requisição com definição do tipo de serviço, através do parâmetro type.

GET http://54.233.99.254/webservice-rest/mo_new?user={user}&password={password}&type=2

Clique abaixo e veja exemplos em várias linguagens de programação:

Consulta de Mensagens Recebidas por Período

Está requisição de busca irá retornar cada MO recebido num determinado período de tempo. Você precisa definir os parâmetros start_date e end_date para especificar um período de tempo, deverá ser utilizado o formato ISO-8601.

GET http://54.233.99.254/webservice-rest/mo

Importante: a consulta fica disponível por até 32 dias após o recebimento.

Abaixo exemplo de requisição de consulta por período de tempo e tipo de serviço, através do parâmetro type.

GET http://54.233.99.254/webservice-rest/mo?user={user}&password={password}&start_date=2016-09-12T00:00:00&end_date=2016-09-15T23:59:59&type=2

Abaixo exemplo de requisição de consulta por período de tempo e identificador da mensagem no sistema do cliente, através do parâmetro campaign_id.

GET http://54.233.99.254/webservice-rest/mo?user={user}&password={password}&start_date=2016-09-12T00:00:00&end_date=2016-09-15T23:59:59&campaign_id=abc123

Clique abaixo e veja exemplos em várias linguagens de programação:

Consulta de Saldo API SMS SHORT CODE

Está requisição de busca irá retornar o saldo atual de todos os serviços, incluindo a data da última ativação de créditos e o vencimento.

GET http://54.233.99.254/webservice-rest/balance

Abaixo exemplo de requisição de consulta de saldo realizando a autenticação por parâmetros query string.

GET http://54.233.99.254/webservice-rest/balance?user={user}&password={password}

Em resposta à chamada, a API retornará informações conforme abaixo:

Integre o serviço de envio de SMS a sistemas existentes na sua empresa

Se você é um desenvolvedor de software ou profissional da área oferecemos também um Gateway para envio de mensagens de SMS e aplicativos de mensagens via protocolos HTTP, SMPP, SMTP, FTP e MySQL. Assim, podem ser usados com facilidade em qualquer linguagem de programação, incluindo Java, Delphi, ASP, ASP.Net, PERL, PHP.

A utilização do nosso Gateway é muito simples. Basicamente, seu programa precisará dar um GET ou POST na URL do nosso gateway. Então, passa-se por parâmetro a identificação da sua conta no sistema, o número do celular de destino, e a mensagem a ser enviada.

Assim como nossa plataforma online, o Gateway também funciona com todas as operadoras. Não há mensalidade nem taxa de inscrição. Você compra créditos e usa quando desejar e ainda conta com relatórios detalhados das mensagens enviadas. QUERO FAZER UM TESTE GRÁTIS!

API SMS SHORT CODE
Plano de SMS para Empresas

Os comentários estão encerrados.

Converse agora com um Especialista