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.

Hämta din API-nyckel API-dokumentation

Meddelandetyper Interaktiva knappar Massutskick Webhooks Kodexempel Autentisering

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.

Hämta din API-nyckel API-dokumentation

Inget abonnemang
Ingen bindning
Betala per användning
Gratis provperiod