Vamos entender o que é e como funciona uma API de mensagem de texto curto, o famoso SMS Short code.
SMS Short Code é um número de telefone curto usado para enviar e receber mensagens de texto. Foi introduzido pela primeira vez em 2000 para facilitar o envio de mensagens de texto para grandes listas de destinatários. Os códigos são geralmente curtos e fáceis de lembrar, o que os torna ideais para campanhas de marketing.
API de integração é um conjunto de rotinas, protocolos e ferramentas para conectar aplicativos, sistemas e serviços, permitindo a troca de dados entre eles. Esta tecnologia permite que os desenvolvedores integrem seus produtos e soluções de maneira mais eficiente, sem a necessidade de codificar linha a linha.
API de mensagem de texto curto é uma ferramenta que permite que os desenvolvedores criem aplicativos ou outras soluções que enviem e recebam mensagens de texto curtas. Esta API é usada para integrar com serviços de SMS, permitindo que os usuários envie mensagens de texto curtas para qualquer número de telefone. Esta API também pode ser usada para receber e processar mensagens de texto curtas, permitindo que os usuários criem respostas automatizadas para mensagens de texto.
1. Escolha uma API de mensagem de texto curto. Existem muitas APIs de mensagem de texto curto diferentes disponíveis no mercado, algumas especializadas em determinadas tarefas. É importante escolher a API que melhor atenda às suas necessidades.
2. Registre-se para a API. Após escolher a API de mensagem de texto curto certa para o seu sistema, você precisará se registrar para ela. O processo de registro geralmente envolve fornecer algumas informações básicas sobre si mesmo e seu sistema.
3. Configure a API. Depois de se registrar, você precisará configurar a API para que ela funcione com seu sistema. Esta configuração geralmente envolve configurar as autorizações necessárias e fornecer os detalhes do serviço que você deseja usar.
4. Integre a API ao seu sistema. Uma vez que a API estiver configurada, você poderá começar a integrá-la ao seu sistema existente. Isso pode ser feito adicionando códigos de API à sua aplicação ou usando a API para criar interfaces de usuário personalizadas.
5. Teste a integração da API. Após a integração da API, é importante testá-la para garantir que ela está funcionando corretamente. Isso geralmente envolve enviar mensagens de teste para verificar se a API está funcionando como esperado.
– Permite aos usuários enviar e receber mensagens de texto curtas para qualquer número de telefone. – Reduz o tempo necessário para o envio ou recebimento de mensagens de texto.
– Permite que os usuários criem aplicativos ou outras soluções com a funcionalidade de mensagens de texto curtas.
– Permite aos usuários criar respostas automatizadas para mensagens de texto.
– Permite aos usuários acompanhar o status de entrega de mensagens de texto.
– Permite aos usuários programar mensagens de texto para serem enviadas em um momento específico.
1 – Enviar alertas de segurança: Uma empresa de segurança pode usar a API de mensagem de texto curto para enviar alertas de segurança aos seus clientes.
2. Notificar clientes: Uma empresa de entrega pode usar a API de mensagem de texto curto para notificar os clientes sobre o status da entrega.
3. Enviar lembretes: Uma clínica médica pode usar a API de mensagem de texto curto para enviar lembretes aos pacientes sobre consultas médicas.
4. Promover eventos: Uma empresa de eventos pode usar a API de mensagem de texto curto para enviar informações sobre eventos aos seus clientes.
5. Enviar ofertas: Uma loja pode usar a API de mensagem de texto curto para enviar ofertas especiais aos seus clientes.
Uma API de mensagem de texto curto pode melhorar a comunicação com os clientes por meio do envio de mensagens de texto curtas e relevantes para seus números de telefone. Isso permite que as empresas se comuniquem com seus clientes de forma mais eficaz, pois as mensagens são entregues instantaneamente e com maior precisão que as mensagens de e-mail ou mídias sociais. Além disso, com a API de mensagem de texto curto, as empresas podem programar mensagens para serem enviadas em um momento específico, o que permite que elas mantenham contato com seus clientes de forma mais eficaz.
– É mais rápido do que outros canais de comunicação. Mensagens de texto curtas são entregues instantaneamente, o que as torna ideais para enviar alertas ou notificações aos usuários.
– É mais barato do que outros canais de comunicação. O envio de mensagens de texto é muito mais barato do que o envio de e-mails ou mídias sociais.
– É mais direto do que outros canais de comunicação. Mensagens de texto curtas são diretas e curtas, o que as torna ideais para transmitir mensagens diretas e claras aos usuários.
– É mais personalizável do que outros canais de comunicação. A API permite que os usuários criem mensagens de texto personalizadas para os usuários, o que as torna mais relevantes.
Para escolher a melhor API para o seu negócio, é importante considerar algumas coisas, como:
– Preço: Verifique se a API é acessível para o seu orçamento.
– Funcionalidade: Verifique se a API oferece todas as funcionalidades necessárias para o seu negócio.
– Suporte: Verifique se a API oferece suporte aos usuários.
– Integração: Verifique se a API é compatível com seus sistemas e aplicativos existentes.
– Segurança: Verifique se a API oferece segurança adequada para garantir a proteção dos seus dados.
As tendências futuras para a API incluem:
– Uso de inteligência artificial: Os desenvolvedores estão usando inteligência artificial para melhorar a funcionalidade das APIs de mensagem de texto curto. Isso permite que as APIs entendam o contexto da mensagem e ofereçam respostas mais relevantes e precisas.
– Integração com outros serviços: As APIs de mensagem de texto curto estão se integrando às plataformas de mídia social, serviços de pagamento, plataformas de análise de dados e outras plataformas para oferecer uma experiência de usuário mais completa.
1. McDonald’s: A McDonald’s usou a API de mensagem de texto curto para criar um serviço de pedidos rápidos e convenientes para seus clientes. Os clientes podem enviar uma mensagem de texto com seu pedido e receber uma confirmação de que o pedido foi recebido. A McDonald’s também usa o serviço para enviar mensagens de texto de promoções e ofertas especiais para seus clientes.
2. Uber: A Uber usa a API de mensagem de texto curto para enviar mensagens de texto aos motoristas de táxi para notificá-los de que um passageiro precisa de um carro. Os motoristas podem então confirmar ou recusar a corrida. A Uber também usa a API para enviar mensagens de texto aos passageiros para atualizá-los sobre seu motorista e a situação de sua viagem.
3. Spotify: O Spotify usa a API de mensagem de texto curto para permitir aos usuários enviarem comandos de voz para ouvir músicas ou playlists. Por exemplo, os usuários podem enviar uma mensagem de texto para o Spotify para ouvir uma determinada música ou playlist.
4. Netflix: A Netflix usa a API de mensagem de texto curto para enviar mensagens promocionais aos usuários. Por exemplo, a Netflix pode enviar mensagens de texto alertando os usuários sobre novos filmes ou programas que foram adicionados ao catálogo.
6. Amazon: A Amazon usa a API para enviar notificações push para seus usuários sobre novas ofertas, promoções e atualizações. A Amazon também usa a API para enviar alertas sobre o status de entrega de produtos.
7. Walmart: A Walmart usa a API para enviar mensagens de texto promocionais aos seus clientes. A Walmart também usa a API para enviar mensagens de texto de confirmação de pedido durante o processo de compra.
8. Starbucks: A Starbucks usa a API para enviar mensagens de texto notificando os usuários sobre ofertas especiais e promoções.
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.
http://54.233.99.254/webservice-rest/send-single
A requisição precisa conter parâmetros Query String com as informações conforme campos abaixo:
* Campo obrigatório
Campo | Detalhes | Tipo |
---|---|---|
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_code | DDI 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_id | Identificador da mensagem no sistema do cliente. | string |
schedule | Data e hora em que a mensagem deve ser enviada no formato ISO 8691 (2020-11-01 15:00:00). | string |
timezone | Fuso horário em formato UTC (-03:00). | string |
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"
}
Envio em Lote:
Permite o envio de mensagens em lote ou individuais passando os parâmetros por POST em um objeto JSON
http://54.233.99.254/webservice-rest/send-multiple
O corpo da requisição precisa conter o objeto JSON com as informações conforme campos abaixo:
* Campo obrigatório
Campo | Detalhes | Tipo |
---|---|---|
type * | Tipo do serviço, consulte o menu “Parâmetro type”. | number |
country_code | DDI 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_id | Identificador da mensagem no sistema do cliente. | string |
schedule | Data e hora em que a mensagem deve ser enviada no formato ISO 8691 (2020-11-01 15:00:00). | string |
timezone | Fuso horário em formato UTC (-03:00). | string |
Teste envios 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”.
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
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
.
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
.
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
.
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
.
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}
Nossa plataforma envia ao sistema do cliente uma requisição para cada mensagem recebida de um celular, requisições via GET com parâmetros Query String. (esta funcionalidade é utilizada, por exemplo, para enquetes, SAC, pesquisas, confirmações de visita etc).
Para receber está requisição em seu sistema, é necessário configurar uma URL de notificação na plataforma, solicite para nosso suporte esta configuração.
Veja abaixo um exemplo do que você receberá em seu sistema:
A SpeedMarket tem a melhor API de mensagem de texto curto do mercado, com o melhor preço e recursos avançados. Nossa API oferece serviços de envio e recebimento de mensagens de texto, notificações push, confirmações de pedido, atualizações de status de entrega e muito mais. Cadastre-se agora no nosso site e faça um teste gratuito para ver como a API da SpeedMarket pode melhorar os serviços da sua empresa.
Nos chame no Whatsapp!