Ir para o conteúdo

API SMSBAT

SMSBAT é uma plataforma RESTful API para enviar vários tipos de mensagens, incluindo carrossel Viber, diálogo de opinião Viber, promoção Viber (fotos, vídeo), bate-papo comercial Viber, notificações OTP (Viber OTP, Flash Call) e suas variantes alternativas.

URL base

As solicitações à API SMSBAT são transmitidas para um endpoint com localização. Solicite previamente o endereço ao seu gerente.

Exemplo: https://restapi.smsbat.com (o URL real pode variar de acordo com sua região)

Autenticação

A API SMSBAT oferece suporte a três métodos de autenticação:

Método 1: autenticação básica HTTP

Use suas credenciais de nome de usuário e senha:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d @request.json

Método 2: cabeçalho da chave de API

Use o cabeçalho X-Authorization-Key:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Método 3: chave de API como senha

Use @ como nome de usuário e sua chave API como senha:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Terminais disponíveis

Método Ponto final Descrição
POSTAR /bat/lista de mensagens Enviar mensagens
OBTER /bat/mensagem/{messageId} Verifique o status da mensagem

Tipos de mensagens

A API SMSBAT oferece suporte aos seguintes tipos de mensagens:

  • SMS - Mensagens de texto padrão
  • Promoção Viber - Mensagens promocionais com rich media
  • Viber Transacional - Notificações de transações
  • Viber Carousel - Mensagens interativas do carrossel
  • Viber Survey - Mensagens de diálogo de opinião
  • Viber OTP - Notificações de senha única
  • RCS - Mensagens avançadas de serviços de comunicação
  • Chamada Flash - Verificação de chamada silenciosa

Principais recursos

Mensagens substitutas

Quando a entrega primária falha, o SMSBAT recorre automaticamente a canais alternativos:

CODE_BLOCO_3

Suporte Rich Media

Envie mensagens com:

  • Imagens (JPG, PNG)
  • Vídeos (MP4)
  • PDFs
  • Botões e links de ação

Rastreamento de status de mensagens

Acompanhe o status da entrega em tempo real:

  • Enviado
  • Entregue
  • Leia
  • Falhou
  • Expirado

Retornos de chamada

Receba retornos de chamada de mensagens do Viber para comunicação bidirecional.

Início rápido

  1. Envie uma mensagem - Aprenda como enviar sua primeira mensagem
  2. Verificar status - Rastrear o status de entrega de mensagens
  3. Tipos de mensagens - Explore diferentes tipos de mensagens

Formato de solicitação

Todas as solicitações usam o formato JSON com a seguinte estrutura:

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "type": "viber",
      "text": "Your message here",
      // ... additional parameters
    }
  ]
}

Formato de resposta

Retorno de respostas bem-sucedidas:

CODE_BLOCO_5

Tratamento de erros

Códigos de status HTTP:

  • 200 OK - Solicitação bem-sucedida
  • 400 Bad Request - Formato de solicitação inválido
  • 401 Não Autorizado - Falha na autenticação
  • 429 Too Many Requests - Limite de taxa excedido
  • 500 Erro interno do servidor - Erro do servidor

Próximas etapas