Ir para o conteúdo

Mensagens SMS

Envie mensagens de texto padrão usando a API SMSBAT. SMS é o canal de mensagens mais universal, com as taxas de entrega mais altas em todos os dispositivos móveis.

Visão geral

SMS (Serviço de Mensagens Curtas) é ideal para:

  • Notificações urgentes
  • Fallback para mensagens Viber/RCS
  • Alcançar usuários sem smartphones
  • Compatibilidade universal em todas as redes móveis
  • Altas taxas de entrega (95%+)

Mensagem SMS básica

Solicitação

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

Parâmetros

Parâmetro Tipo Obrigatório Descrição
de corda Sim ID alfanumérico do remetente (até 11 caracteres)
para corda Sim Número de telefone do destinatário no formato E.164
tipo corda Sim Defina como "sms"
texto corda Sim Conteúdo da mensagem
customerMessageId corda Não Seu ID de rastreamento interno
ttl inteiro Não Tempo de vida em segundos

Exemplos

SMS simples

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

SMS com ID do cliente

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

SMS com TTL

CODE_BLOCO_3

Codificação de caracteres

Codificação GSM de 7 bits

Alfabeto GSM padrão (160 caracteres por SMS):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

Caracteres GSM estendidos

Esses caracteres contam como 2 caracteres:

CODE_BLOCO_5

Codificação Unicode (UCS-2)

Mensagens com caracteres especiais utilizam codificação Unicode (70 caracteres por SMS):

  • Emoji: 😀 🎉 ❤️
  • Cirílico: А Б В Г Д Е Ж
  • Símbolos especiais: ✓ ✗ ★ ♥

Comprimento da mensagem

SMS único

  • GSM 7 bits: 160 caracteres
  • Unicode: 70 caracteres

SMS multiparte

Quando sua mensagem excede o limite, ela é dividida em várias partes:

  • GSM 7 bits: 153 caracteres por parte
  • Unicode: 67 caracteres por parte

Exemplo

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

Esta mensagem (201 caracteres) será dividida em 2 partes.

Resposta

Resposta de sucesso

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

Campos de resposta

Campo Descrição
mensagemId Identificador único para rastreamento
estado Status da mensagem (aceita, rejeitada)
partes Número de partes SMS
para Número de telefone do destinatário

ID do remetente

Remetente Alfanumérico

Use o nome da sua marca como remetente (até 11 caracteres):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

Restrições:

  • Máximo de 11 caracteres
  • Somente letras e números
  • Sem espaços ou caracteres especiais
  • O destinatário não pode responder a remetentes alfanuméricos

Remetente Numérico

Use um número de telefone como remetente (para SMS bidirecionais):

CODE_BLOCO_9

Casos de uso

Verificação OTP

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

Notificações de pedidos

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

Lembretes de compromissos

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

Confirmações de pagamento

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

Melhores práticas

Conteúdo da mensagem

  • ✅ Mantenha as mensagens concisas e claras
  • ✅ Incluir identificação do remetente
  • ✅ Adicione uma frase de chamariz, se necessário
  • ✅ Use gramática e ortografia adequadas
  • ❌Evite pontuação excessiva!!!
  • ❌ Não use todas as letras MAIÚSCULAS
  • ❌ Evite encurtadores de URL que pareçam suspeitos

Uso de caracteres

  • Verifique a contagem de caracteres antes de enviar
  • Esteja ciente dos caracteres GSM estendidos (conte como 2)
  • Teste com caracteres especiais antes do envio em massa
  • Considere usar a codificação GSM para mensagens mais longas

Números de telefone

  • Sempre use o formato E.164: +380XXXXXXXXX
  • Valide os números de telefone antes de enviar
  • Remova números inválidos da sua lista
  • Mantenha sua lista de contatos atualizada

Tempo

  • Respeite os fusos horários locais
  • Evite enviar à noite (22h - 8h)
  • Considere o horário comercial para mensagens comerciais
  • Defina o TTL apropriado para mensagens urgentes

Conformidade

  • Obtenha consentimento antes de enviar mensagens de marketing
  • Incluir instruções de cancelamento para SMS promocionais
  • Siga os regulamentos locais (GDPR, etc.)
  • Respeite as listas de "Não perturbe"

Tratamento de erros

Erros Comuns

Erro Causa Solução
INVALID_RECIPIENT Formato de telefone errado Usar formato E.164
INVALID_SENDER ID de remetente inválido Verifique as regras de ID do remetente
MESSAGE_TOO_LONG Excede o comprimento máximo Dividir ou encurtar mensagem
INVALID_ENCODING Caracteres não suportados Use GSM ou Unicode

Otimização de custos

Reduza partes da mensagem

  • Mantenha as mensagens com menos de 160 caracteres (GSM) ou 70 (Unicode)
  • Evite caracteres especiais que acionam Unicode
  • Use abreviaturas quando apropriado
  • Remova espaços desnecessários

Exemplo de otimização

❌ Antes (171 caracteres, 2 SMS): 

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ Depois (156 caracteres, 1 SMS): 

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

Envio em massa

Envie várias mensagens em uma solicitação:

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

Próximas etapas