RCS API Logotyp

RCS Rich Cards – Den kompletta guiden

Skapa ett utvecklingskonto
RCS Rich Card Carousel illustration

Att kommunicera med kunder handlar idag om mer än bara text.
Med RCS Rich Cards kan du skicka interaktiva och visuellt
tilltalande meddelanden direkt till mottagarens standard-app för meddelanden.

I den här guiden går vi igenom hur du använder vårt API för
att skicka RCS Rich Cards och Carousels – de verktyg som förvandlar
ett enkelt meddelande till en rik upplevelse.

Förutsättningar

  • Ett konto: Skapa ett konto på shop.ip1.net/account/new
  • API-nyckel: Skapa en Bearer token i användarportalen under Konton > Behörigheter > API-nycklar
  • Kontakta supporten på support@ip1.se för att sätta upp en agent
  • Bas-URL: Alla anrop görs mot https://api.ip1.net/v3/

Hur det fungerar: Bundles och conversations

För att skicka meddelanden kan vi använda oss av endpointen bundles
eller conversations. Om du vill skicka till flera mottagare använder du med
fördel endpointen bundles, medan conversations används för att skicka till
enskilda mottagare.

Båda endpoints behöver grundläggande data för att kunna hantera ditt utskick:

  1. Vem som skickar (brand & agent)
  2. Vad som skickas (card/carousel)
  3. Vem som ska få det (recipient eller recipients)

Genom att använda bundles-endpointen sköter vårt API all tung logistik kring att leverera rätt innehåll till rätt person, oavsett om det är 10 eller 10 000 mottagare.

Conversation-endpointen låter dig skicka till enskilda personer, samtidigt kan du föra konversationen vidare utan att behöva skicka metadatan på nytt.

Viktiga fält i ditt anrop

brand

En referens till ditt specifika brand bestående av ett unik GUID 

"41b71b67-4035-4650-afdb-6f6531f4hf78".

Agent

En referens till agenten besående av en unik sträng

"test_pfphlqns_agent"

Recipient - Bundle

Ett objekt där nyckeln är telefonnumret.

{"46700123456": {"firstName": "Kalle"}}

Recipient - Conversation

Ett sträng där värdet är mottagarens telefonnummer.

"recipient": "46700123456"

card

Objektet som definierar ditt Rich Card.

"card": {
    "title": "Vår-REA!",
    "content": "Hej {name}! Nu tömmer vi lagret inför sommaren.",
    "mediaUrl": "https://cdn.site.se/spring-sale.jpg",
    "type": 1
}

Oroa dig inte för att din mottagare ska se ett konstigt ID eller en tråkig sträng när du skickar ett RCS, både Brands och agenter har ett attribut för displayName, exempelvis ditt företagsnamn och den avdelning som du skickar från. Du kan läsa om detta i dokumentationen för Brands och Agenter

Steg för steg: Skicka ett RCS Rich Card

Här är ett fullständigt exempel för att skicka ett meddelande med ett RCS Rich Card (bild och text). Glöm inte att lägga till din Auth Token som du genererar i användarportalen.

🐍
Rich Card (Python)
Kopiera 
import requests

api_token = "DIN_API_TOKEN"
url = "https://api.ip1.net/v3/bundles"

headers = {
    "Authorization": f"Bearer {api_token}",
    "Content-Type": "application/json"
}

payload = {
    "brand": "41b71b67-4035-4650-afdb-6f6531f4hf78",
    "agent": " test_pfphlqns_agent",
    "recipients": {
        "46700123456": {"firstName": "Kalle"}
    },
    "card": {
        "title": "Vår-REA!",
        "content": "Hej {name}! Nu tömmer vi lagret inför sommaren.",
        "mediaUrl": "https://cdn.site.se/spring-sale.jpg",
        "type": 1
    }
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
📄
Rich Cards (Node.js)
Kopiera 
const axios = require('axios');

const sendRcs = async () => {
  const url = 'https://api.ip1.net/v3/bundles';
  const token = 'DIN_API_TOKEN';

  const data = {
    brand: "41b71b67-4035-4650-afdb-6f6531f4hf78",
    agent: " test_pfphlqns_agent",
    recipients: {
      "46700123456": { "firstName": "Kalle" }
    },
    card: {
      title: "Sommarkampanj",
      content: "Få 20% rabatt på alla solglasögon!",
      mediaUrl: "https://cdn.site.se/promo-sun.jpg",
      type: 1
    }
  };

  try {
    const res = await axios.post(url, data, {
      headers: { 'Authorization': `Bearer ${token}` }
    });
    console.log('Success:', res.data);
  } catch (err) {
    console.error('Error:', err.response.data);
  }
};
sendRcs();
📄
Rich Cards (PHP)
Kopiera 
<?php
$url = "https://api.ip1.net/v3/bundles";
$token = "DIN_API_TOKEN";
$data = [
    "brand" => "41b71b67-4035-4650-afdb-6f6531f4hf78",
    "agent" => " test_pfphlqns_agent",
    "recipients" => [
        "46700123456" => ["firstName" => "Kalle"]
    ],
    "card" => [
        "title" => "Välkommen!",
        "content" => "Hej {name}, kul att du är här.",
        "mediaUrl" => "https://site.se/bild.jpg",
        "type" => 1
    ]
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $token,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

RCS Carousels: När ett kort inte räcker

En karusell skapas genom att skicka en lista med flera kort. Det är det ultimata sättet att visa upp flera produkter i samma meddelande. Användaren kan då svajpa horisontellt mellan dina erbjudanden.

Tips: För att bygga en karusell använder du fältet carousel istället för card och skickar med en array av card-objekt. Glöm inte att sätta order på varje card-objekt.

Fältguide

Här bryter vi ner de tekniska termerna till vad de faktiskt betyder för din mottagare.

Card-objektet

Fält Vad det gör Pro tip
title Rubriken längst upp (fetstil). Håll den kort och slagkraftig (max 100 tecken).
content Brödtexten under bilden. Använd {name} för att göra det personligt i en bundle
mediaUrl Länken till din bild eller video. Använd högkvalitativa bilder (JPG/PNG).
height Bestämmer hur högt kortet är (1, 2 eller 3). 2 (Medium) brukar vara "the sweet spot" för de flesta mobiler.

Personifiering i Bundle Recipients (Templating)

Istället för att bara skicka till en lista med nummer, skickar du ett objekt. Detta gör att du kan ”tvätta” din data direkt i utskicket:

"recipients": {
  "46700123456": { "firstName": "Kalle", "city": "Malmö" }
}

I ditt content eller title kan du sedan skriva:

”Hej {firstName}! Vi har fri frakt till {city} idag.”

API:et byter automatiskt ut taggarna mot rätt värden för varje unik mottagare.

Sammanfattningsvis låter RCS Rich Cards och Carousels att ta steget från traditionell text till interaktiva och visuella upplevelser direkt i kunders standard-app för meddelanden. 

Genom vårt API och våra endpoints för /bundles och /conversations kan du smidigt styra om du vill göra storskaliga utskick eller driva enskilda konversationer, utan att tumma på varumärkets identitet tack vare tydliga roller för brands och agenter.

När du väl har ditt konto, din Bearer token och din agent uppsatt är det bara att använda kodexemplen för att komma i gång. Genom att kombinera rätt parametrar för bild, text och knappval har du allt som krävs för att förvandla enkel kommunikation till en rikare och mer engagerande kundupplevelse.

Vill du veta mer om vårt API?

Besök vår dokumentationssida för att läsa mer om autentisering, singel- eller grupputskick samt hur du kan skapa mer engagerande funktionalitet!

Gå till dokumentationen
Dela artikeln