Gå till innehållet

SMSBAT API

SMSBAT är en RESTful API-plattform för att skicka olika typer av meddelanden inklusive Viber-karusell, Viber åsiktsdialog, Viber-kampanj (bilder, video), Viber affärschatt, OTP-aviseringar (Viber OTP, Flash Call) och deras reservvarianter.

Bas-URL

Förfrågningar till SMSBAT API överförs till en slutpunkt med lokalisering. Begär adressen från din chef i förväg.

Exempel: https://restapi.smsbat.com (faktisk webbadress kan variera beroende på din region)

Autentisering

SMSBAT API stöder tre autentiseringsmetoder:

Metod 1: HTTP Basic Auth

Använd ditt användarnamn och lösenord:

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

Metod 2: API Key Header

Använd rubriken "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

Metod 3: API-nyckel som lösenord

Använd @ som användarnamn och din API-nyckel som lösenord:

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

Tillgängliga slutpunkter

Metod Slutpunkt Beskrivning
POST /bat/messagelist Skicka meddelanden
FÅ /bat/meddelande/{messageId} Kontrollera meddelandestatus

Meddelandetyper

SMSBAT API stöder följande meddelandetyper:

  • SMS - Standard textmeddelanden
  • Viber-kampanj - Reklammeddelanden med rich media
  • Viber Transactional - Transaktionsmeddelanden
  • Viber Carousel - Interaktiva karusellmeddelanden
  • Viber Survey - Åsiktsdialogmeddelanden
  • Viber OTP - Engångslösenordsaviseringar
  • RCS - Rich Communication Services-meddelanden
  • Flashsamtal - Tyst samtalsverifiering

Nyckelfunktioner

Reservmeddelanden

När primär leverans misslyckas, faller SMSBAT automatiskt tillbaka till alternativa kanaler:

Viber → SMS → Email

Support för multimedia

Skicka meddelanden med:

  • Bilder (JPG, PNG)
  • Videor (MP4)
  • PDF-filer
  • Knappar och åtgärdslänkar

Spårning av meddelandestatus

Spåra leveransstatus i realtid:

  • Skickat
  • Levereras
  • Läs
  • Misslyckades
  • Utgått

Återuppringningar

Ta emot inkommande Viber-meddelandeuppringningar för tvåvägskommunikation.

Snabbstart

  1. Skicka ett meddelande - Lär dig hur du skickar ditt första meddelande
  2. Kontrollera status - Spåra meddelandeleveransstatus
  3. Meddelandetyper - Utforska olika meddelandetyper

Begärformat

Alla förfrågningar använder JSON-format med följande struktur:

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

Svarsformat

Lyckade svar returnerar:

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

Felhantering

HTTP-statuskoder:

  • 200 OK - Begäran lyckades
  • 400 Bad Request - Ogiltigt format för begäran
  • 401 obehörig - Autentisering misslyckades
  • 429 Too Many Requests - Beloppsgränsen har överskridits
  • 500 Internt serverfel - Serverfel

Nästa steg