Saltar a contenido

API SMSBAT

SMSBAT es una plataforma API RESTful para enviar varios tipos de mensajes, incluido el carrusel de Viber, el diálogo de opinión de Viber, la promoción de Viber (imágenes, videos), el chat de negocios de Viber, las notificaciones OTP (Viber OTP, Flash Call) y sus variantes alternativas.

URL base

Las solicitudes a la API SMSBAT se transmiten a un punto final con localización. Solicite la dirección a su Gerente de antemano.

Ejemplo: https://restapi.smsbat.com (la URL real puede variar según su región)

Autenticación

SMSBAT API admite tres métodos de autenticación:

Método 1: autenticación básica HTTP

Utilice sus credenciales de nombre de usuario y contraseña:

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

Método 2: encabezado de clave API

Utilice el encabezado 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: clave API como contraseña

Utilice @ como nombre de usuario y su clave API como contraseña:

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

Puntos finales disponibles

Método Punto final Descripción
PUBLICAR /bat/lista de mensajes Enviar mensajes
OBTENER /bat/message/{mensajeId} Verificar el estado del mensaje

Tipos de mensajes

La API SMSBAT admite los siguientes tipos de mensajes:

  • SMS - Mensajes de texto estándar
  • Viber Promo - Mensajes promocionales con medios enriquecidos
  • Viber Transaccional - Notificaciones de transacciones
  • Viber Carousel - Mensajes interactivos en carrusel
  • Encuesta de Viber - Mensajes de diálogo de opinión
  • Viber OTP - Notificaciones de contraseña de un solo uso
  • RCS - Mensajes de servicios de comunicación enriquecidos
  • Llamada flash - Verificación de llamada silenciosa

Características clave

Mensajería alternativa

Cuando falla la entrega principal, SMSBAT recurre automáticamente a canales alternativos:

Viber → SMS → Email

Soporte de medios enriquecidos

Enviar mensajes con:

  • Imágenes (JPG, PNG)
  • Vídeos (MP4)
  • PDF
  • Botones y enlaces de acción.

Seguimiento del estado del mensaje

Realice un seguimiento del estado de la entrega en tiempo real:

  • Enviado
  • Entregado
  • Leer
  • Fallido
  • Caducado

Devoluciones de llamada

Reciba devoluciones de llamadas de mensajes entrantes de Viber para una comunicación bidireccional.

Inicio rápido

  1. Enviar un mensaje: aprende cómo enviar tu primer mensaje
  2. Verificar estado - Seguimiento del estado de entrega del mensaje
  3. Tipos de mensajes: explora diferentes tipos de mensajes

Formato de solicitud

Todas las solicitudes utilizan el formato JSON con la siguiente estructura:

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

Formato de respuesta

Vuelven las respuestas exitosas:

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "recipient": "+380XXXXXXXXX",
      "status": "sent"
    }
  ]
}

Manejo de errores

Códigos de estado HTTP:

  • 200 OK - Solicitud exitosa
  • 400 Solicitud incorrecta - Formato de solicitud no válido
  • 401 No autorizado - Error de autenticación
  • 429 Demasiadas solicitudes - Límite de tasa excedido
  • 500 Error interno del servidor - Error del servidor

Próximos pasos