Hoppa till innehållet

RCS för utvecklare

Låt era egna system skicka RCS via vårt REST API. Status och svar från kunderna kommer tillbaka till er med webhooks.

Så fungerar flödet

  1. 1. Skicka

    Ert system anropar API:t med mottagare och innehåll, till exempel text, ett kort, en karusell eller knappar. Går RCS inte fram kan ni låta det gå som SMS i stället.

  2. 2. Följ status

    Ni får händelser till er webhook när meddelandet har kommit fram, när kunden har öppnat det och när någon trycker på en knapp.

  3. 3. Ta emot svar

    Trycker kunden på ett förslag eller skriver något kommer det också som en händelse. Då kan ert system svara i samma tråd.

POST/messagesFörenklat exempel

1 Anrop

{
  "sender": "rcsdirekt",
  "to": "+46701234567",
  "card": {
    "title": "Din tid är bokad",
    "description": "Tisdag 14 januari kl. 14.00",
    "media": "https://exempel.se/bild.jpg",
    "buttons": [
      { "type": "reply", "text": "Bekräfta" },
      { "type": "reply", "text": "Boka om" }
    ]
  },
  "fallback": { "sms": "Din tid: tis 14/1 kl. 14.00" }
}

2 Svar 202

{ "messageId": "a1b2c3", "status": "ACCEPTED" }

3 Händelser via webhook

  1. 14:02DELIVEREDLevererat till telefonen
  2. 14:05SEENÖppnat av mottagaren
  3. 14:06REPLYSvarade Bekräfta

Det en integration behöver hantera

Händelser från webhooks kommer inte alltid en gång och i rätt ordning. Här är det som brukar ställa till det.

  • Samma händelse kan komma två gånger
  • Händelser kan komma i fel ordning
  • Lägg inkommande händelser i en kö
  • Kontrollera vem som skickar till webhooken
  • Håll API-nycklarna hemliga
  • Märk när händelser slutar komma