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. 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. 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. 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.
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
- 14:02DELIVEREDLevererat till telefonen
- 14:05SEENÖppnat av mottagaren
- 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
Artiklar om integrationen
Hur fungerar RCS API och webhooks?
Ett RCS API låter era system begära ett utskick. Webhooks tar emot senare händelser som leverans, lässtatus och kundsvar. Att API:et accepterat begäran betyder ännu inte att telefonen fått meddelandet.
2 min läsningMeddelandedesignVad betyder Basic, Single och Conversation?
Basic, Single och Conversation är meddelandetyper i företags-RCS, inte abonnemangsplaner. De beskriver olika slags innehåll och dialog.
1 min läsningFöretagVad betyder verifierad avsändare?
Verifieringen kontrollerar kopplingen mellan RCS-avsändaren och varumärket den företräder. I Google Meddelanden kan kunden se företagsnamn, logotyp och en verifieringsmarkering.
1 min läsningGoogles dokumentation
RCS bygger på Googles RCS for Business. Vill ni gå på djupet finns allt om meddelanden, händelser och webhooks där.