Help Center Enviar mensagem

Enviar mensagem

Envie mensagens por meio da API SMSBAT usando o endpoint /bat/messagelist.

Ponto final

POST /bat/messagelist

Estrutura da solicitação

O corpo da solicitação é uma matriz JSON de objetos de mensagem:

{
  "messages": [
    {
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Your message text",
      "customerMessageId": "your-internal-id",
      "ttl": 3600
    }
  ]
}

Parâmetros

Parâmetros Obrigatórios

ParâmetroTipoDescrição
decordaID alfanumérico do remetente
paracordaNúmero de telefone do destinatário no formato E.164 (por exemplo, +380XXXXXXXXX)
tipocordaTipo de mensagem: sms, viber_promo, viber_trans, viber_carousel, viber_survey, viber_otp, rcs, flashcall
textocordaConteúdo da mensagem (obrigatório para a maioria dos tipos, opcional para alguns)

Parâmetros Opcionais

ParâmetroTipoDescrição
customerMessageIdcordaSeu identificador interno para rastreamento
ttlinteiroTempo de vida em segundos
messageDataobjetoConfiguração específica do tipo (varia de acordo com o tipo de mensagem)

Autenticação

Escolha um dos três métodos de autenticação:

=== “Cabeçalho da chave API”

```bash
curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'
```

=== “Autenticação básica HTTP”

__CODE_BLOCO_3__

=== “Chave API como senha”

```bash
curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'
```

Resposta

Resposta de sucesso

CODE_BLOCO_5

Campos de resposta

CampoTipoDescrição
lista de mensagensIdinteiroIdentificador único da lista de mensagens
mensagemIdcordaIdentificador único para cada mensagem
estadocordaStatus da mensagem: aceita, rejeitada, falha
partesinteiroNúmero de partes da mensagem (para SMS)
customerMessageIdcordaO seu identificador interno (se fornecido)
paracordaNúmero de telefone do destinatário

Tipos de mensagens

###SMS

Mensagens de texto simples:

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

Promoção Viber

Mensagens promocionais com rich media:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Check out our new product!",
  "messageData": {
    "image": "https://example.com/image.jpg",
    "button": {
      "text": "View Product",
      "url": "https://example.com/product"
    }
  }
}

Viber Transacional

Notificações de transação:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed"
}

###Viber OTP

Notificações de senha única:

CODE_BLOCO_9

Tratamento de erros

Códigos de status HTTP

CódigoDescrição
200Solicitação bem-sucedida
400Solicitação incorreta - parâmetros inválidos
401Não autorizado - falha na autenticação
429Muitas solicitações - limite de taxa excedido
500Erro interno do servidor

Resposta de erro

{
  "error": {
    "code": "INVALID_RECIPIENT",
    "message": "Invalid phone number format"
  }
}

Melhores práticas

Formato do número de telefone

Sempre use o formato E.164 para números de telefone:

  • ✅ Correto: +380XXXXXXXXX
  • ❌ Incorreto: 380XXXXXXXXX, 0XXXXXXXXX

Texto da mensagem

  • Mantenha o SMS com menos de 160 caracteres para evitar várias partes
  • Use codificação UTF-8 para caracteres internacionais
  • Teste caracteres especiais antes do envio em massa

TTL (tempo de vida)

  • Defina o TTL apropriado para mensagens urgentes
  • Mensagens OTP: 300-600 segundos (5-10 minutos)
  • Mensagens promocionais: 3600-86400 segundos (1-24 horas)

ID da mensagem do cliente

  • Use identificadores exclusivos para cada mensagem
  • Ajuda no rastreamento e depuração
  • Útil para correlacionar com os registros do seu sistema

Limites de taxa

Entre em contato com seu gerente de conta para obter informações sobre:

  • Mensagens por segundo
  • Mensagens por dia
  • Conexões simultâneas

Próximas etapas