RCS API

RCS via REST API

Integrera interaktiva RCS-meddelanden i dina applikationer. Rich Cards, karuseller, knappar och SMS-Fallback – allt via ett enkelt REST API.

Meddelandetyper

9 meddelandeformat för alla användningsområden

Från enkla textmeddelanden till interaktiva karuseller – API:et stöder alla RCS-format.

textBasic

Max. 160 tecken, SMS-liknande med verifierad avsändare

text

Upp till 3 072 tecken + 11 förslagsknappar

richCard

Bild/video + titel + beskrivning + 4 knappar

carousel

Upp till 10 kort, horisontellt scrollbara

image

JPEG, PNG, GIF – direkt i meddelandeappen

video

MP4, 3GP för dynamiskt innehåll

audio

MP3 för röstmeddelanden och poddar

file

PDF:er, dokument för fakturor & biljetter

media

Generisk mediatyp + förslagsknappar

"suggestions": [
  {
    "reply": {
      "text": "Boka tid",
      "postbackData": "book_apt",
      "webhookUrl": "https://..."
    }
  },
  {
    "action": {
      "text": "Ring",
      "type": "dial",
      "dialAction": {
        "phoneNumber": "+46..."
      }
    }
  }
]
Interaktivt

7 knapptyper för varje interaktion

Skapa interaktiva meddelanden med upp till 11 förslagsknappar och 3 kortåtgärder per kort.

  • postback – Webhook-callback med anpassad data
  • openUrl – Öppna externa länkar i webbläsaren
  • openUrlInWebview – Visa länkar direkt i meddelandeappen
  • dial – Starta ett direktsamtal
  • createCalendarEvent – Lägg till händelse i kalendern
  • viewLocation – Visa plats i Google Maps
  • shareLocation – Begär mottagarens plats
Massutskick

Upp till 10 000 mottagare per förfrågan

Skicka samma meddelande till tusentals mottagare med ett enda API-anrop. Perfekt för kampanjer och masskommunikation.

  • Automatisk filtrering av avaktiverade kontakter
  • Testnummer debiteras inte
  • Framstegsspårning via Job-ID
  • Konfigurerbar batchstorlek och fördröjning
  • Kampanjnamn för spårning och rapportering
10.000
Mottagare per förfrågan
POST /send-batch
RCS
Inte tillgängligt?
SMS
SMS-Fallback

Automatisk SMS-Fallback

När RCS inte är tillgängligt skickas ett SMS automatiskt. Definiera en SMS-reservtext för varje meddelande.

  • Automatisk detektering av RCS-kapacitet
  • Separat SMS-avsändare konfigurerbar
  • Upp till 1 530 tecken SMS-text
  • Reservlösningsorsak i API-svar
Schemaläggning

Tidszonsmedveten schemaläggning

Schemalägg meddelanden för en specifik tidpunkt i framtiden. Med IANA-tidszonsstöd når du alltid dina mottagare vid rätt tillfälle.

  • IANA-tidszonsstöd (Europe/Stockholm, etc.)
  • Validering före sändning via /validate-schedule-time
  • Schemaläggningsbara massmeddelanden
  • Avbokningsbara jobb via DELETE /batch/{jobId}
{
  "scheduleAt": "2024-02-15T09:00:00",
  "timeZone": "Europe/Stockholm"
}
{
  "event": "rcs_button_clicked",
  "timestamp": "2024-01-15T10:30:00Z",
  "interaction": {
    "type": "button_click",
    "buttonText": "Köp nu",
    "postbackData": "product_123",
    ...
  },
  "message": {
    "id": "...",
    "campaignName": "Sommarkampanj",
    ...
  },
  "contact": {
    "phone": "+46701234567",
    "name": "Anna Svensson",
    ...
  }
}
Webhooks

Realtids-knappcallbacks

Få omedelbara notifieringar när mottagare klickar på knappar. Koppla dina backend-system för automatiserade arbetsflöden.

  • Realtidsnotifieringar vid knappklick
  • Anpassad postbackData för kontext
  • Kontaktinformation i payload
  • Webhook-URL:er per knapp stöds
Kodexempel

Enkel integration

Skicka ditt första RCS-meddelande med bara några rader kod.

Förfrågan

# Skicka ett Rich Card med knapp
curl -X POST https://api.sendrcs.se/api/rcs/send \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+46701234567",
    "messageType": "richCard",
    "sendernameId": "your-sender-id",
    "content": {
      "title": "Välkommen!",
      "description": "Upptäck våra erbjudanden",
      "media": {
        "height": "MEDIUM",
        "contentInfo": {
          "fileUrl": "https://example.com/image.jpg"
        }
      },
      "cardActions": [{
        "text": "Läs mer",
        "type": "openUrl",
        "openUrlAction": {
          "url": "https://example.com"
        }
      }]
    }
  }'

Svar

{
  "success": true,
  "messageId": "msg_abc123def456",
  "method": "rcs",
  "creditsUsed": 1,
  "hasInteractiveButtons": true,
  "conversation": {
    "conversationId": "conv_xyz",
    "status": "ACTIVE",
    "remainingTime": "23:59:00",
    "chargedMessage": true,
    "messageCount": {
      "total": 1,
      "outbound": 1,
      "inbound": 0
    }
  }
}

API-endpoints

Översikt över alla tillgängliga endpoints

Metod Endpoint Beskrivning
POST /send Skicka ett enskilt meddelande
POST /send-batch Massmeddelanden (upp till 10 000 mottagare)
POST /validate Validera meddelande före sändning
GET /timezones Hämta tillgängliga tidszoner
POST /validate-schedule-time Validera schemalagd tid
GET /batch/{jobId}/status Kontrollera status för batchjobb
DELETE /batch/{jobId} Avbryt batchjobb
GET /limits Hämta hastighetsbegränsningar
GET /button-guidelines Knappriktlinjer och begränsningar
GET /conversations Lista aktiva konversationer
GET /status Kontrollera tjänststatus
Autentisering

Enkel API-nyckelautentisering

Alla API-förfrågningar kräver en API-nyckel i headern. Generera din nyckel i din Dashboard.

X-API-Key: your-api-key-here

Du hittar dina API-nycklar under Settings → API Keys i din instrumentpanel.

Konversationsdebitering

24 timmars konversationsfönster

Inom ett 24-timmarsfönster kan du skicka obegränsat med meddelanden till priset av en konversation. Optimera dina kostnader med höga meddelandevolymer.

  • 24-timmarsfönster från första meddelandet
  • Debiteringsförhandsgranskning före sändning via API
  • Analytics-endpoint för konversationsstatistik
  • Kostnadsoptimering för uppföljningsmeddelanden
24h
Konversationsfönster
Obegränsade meddelanden till ett fast pris

Redo att komma igång med RCS API?

Skapa ditt gratis konto och få din API-nyckel på några minuter.

  • Inget abonnemang
  • Ingen bindning
  • Betala per användning
  • Gratis provperiod