RCS API Logotyp

Skicka RCS (Flera mottagare)

Skapa utvecklingskonto

Bundles används för att skicka meddelanden till flera mottagare samtidigt, vilket är idealiskt för grupputskick eller marknadsföringskampanjer. Observera: Om du vill skicka RCS till en enskild mottagare, använd endpointen Conversation. En Bundle innehåller information om avsändande Agent, innehåll i form av text eller kort, samt en lista över mottagare. Detta är det mest effektiva sättet att nå ut till en större grupp användare med ett och samma interaktiva budskap.

Quickstart #

💻
Quick Start (cURL)
Kopiera till urklipp
curl -X POST https: //api.ip1.net/v3/bundles \
  -H "Authorization: Bearer API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "brand": "Min-Butik-AB",
  "agent": "Kundservice",
  "recipients": {
    "46700123456": {}
  },
  "reference": "INTERN-REF-001",
  "tags": [
    "frakt",
    "viktigt"
  ],
  "type": "Carousel",
  "carousel": [
    {
      "title": "Sommarkampanj 2026",
      "content": "Få 20% rabatt på alla solglasögon!",
      "mediaUrl": "https://cdn.site.se/promo-sun.jpg",
      "type": 1,
      "order": 0
    },
    {
      "title": "Sommarkampanj 2026",
      "content": "Få 20% rabatt på alla solglasögon!",
      "mediaUrl": "https://cdn.site.se/promo-sun.jpg",
      "type": 1,
      "order": 2
    },
  ],
  "suggestions": [
    {
      "text": "Se utbud",
      "type": 1,
      "order": 0,
      "url": "https://site.se/shop",
      "postbackData": "shop_click"
    },
    {
      "text": "Ring butik",
      "type": 4,
      "order": 1,
      "phoneNumber": "468123456",
      "postbackData": "call_click"
    }
  ]
}'

Anrop #

Endpoint: /bundles

Metod: POST

Exempel på anropsdata #

📋
Anropsdata (JSON)
Kopiera till urklipp
{
  "brand": "Min-Butik-AB",
  "agent": "Kundservice",
  "recipients": {
    "46700123456": {}
  },
  "reference": "INTERN-REF-001",
  "tags": [
    "frakt",
    "viktigt"
  ],
  "type": "Carousel",
  "carousel": [
    {
      "title": "Sommarkampanj 2026",
      "content": "Få 20% rabatt på alla solglasögon!",
      "mediaUrl": "https://cdn.site.se/promo-sun.jpg",
      "type": 1,
      "order": 0
    },
    {
      "title": "Sommarkampanj 2026",
      "content": "Få 20% rabatt på alla solglasögon!",
      "mediaUrl": "https://cdn.site.se/promo-sun.jpg",
      "type": 1,
      "order": 2
    },
  ],
  "suggestions": [
    {
      "text": "Se utbud",
      "type": 1,
      "order": 0,
      "url": "https://site.se/shop",
      "postbackData": "shop_click"
    },
    {
      "text": "Ring butik",
      "type": 4,
      "order": 1,
      "phoneNumber": "468123456",
      "postbackData": "call_click"
    }
  ]
}

Fält för anropsdata #

FältnamnBeskrivningRequiredTypExempel
brandNamnet på ditt brand JaString"Min-Butik-AB"
agentNamnet på din agentJaString”Kundservice
recipientsDin mottagarlistaJaObject”46700123456”: { ”name”: ”Kalle” }
contentSjälva meddelandets innehållKrävs om typen är ”Text”String”Hej {name}! Din order är nu skickad.”
typeMeddelandets typJaString eller number (enum)”Carousel”
referenceIntern referens för bundleNejString”INTERN-REF-001”
tagsEn lista med sökbara taggar för att gruppera utskicketNejArray[”frakt”, ”viktigt”]
carouselEn lista av flera kort som skapar en KarusellKrävs om typen är ”Carousel”Array(Se tabell nedan)
cardInnehåller bild, rubrik och text (Rich Card).Krävs om typen är ”Card”Object(Se tabell nedan)
suggestionsEn lista med interaktiva knappar.NejArray(Se tabell nedan)
uniqueIdUnikt ID för att undvika dubbletter.NejString”order-12345-id”

Detaljer för fältet card #

FältnamnBeskrivningRequiredTypExempel
titleRubriken som visas överst på kortet.JaString”Vår-REA!”
contentDen beskrivande texten på kortet.JaString”Nu tömmer vi lagret.”
typeTyp av kort (2 för Rich Card i karusell).JaInteger2
orderOrdning som korten visasKrävs om typen ”Carousel” användsInteger1
mediaUrlURL till bild eller video (publik länk).NejURI”https://site.se/bild.jpg”

Detaljer för fältet suggestions #

FältnamnBeskrivningRequiredTypExempel
textTexten som står på knappen.JaString”Shoppa nu”
typeTyp av handling (2=URL, 5=Dela Plats, 6=Ring).JaInteger2
orderBestämmer vilken ordning suggestions visas.Ja, vid fler än ett suggestionsInteger”2”
postbackDataDen data du får tillbaka vid ett klick.JaString”track_sale_click”
urlMål-URL (krävs för typ 2).NejString”https://site.se/shop”
TitleTiteln för Visa plats på karta samt Kalenderhändelse.Krävs vid typ 5 och 3String”Vår butik”
DescriptionBeskrivning av en kalenderhändelse.Krävs vid typ 3String”Välkommen på klippning!”
StartTime
Starttiden för en kalenderhändelse.		Krävs vid typ 3String”2026-07-01T14:30”
EndTime
Sluttiden för en kalenderhändelse.		Krävs vid typ 3String”2026-07-01T15:30”
LatitudeLatituden för att visa en plats på en karta.Krävs vid typ 5String”58.3944347”
LongitudeLongituden för att visa en plats på en karta.Krävs vid typ 5String”13.8601547,18”
PhoneNumberTelefonnumret som rings upp vid knapptryckKrävs vid typ 6String”46101606060”

Respons #

Exempel på responsdata #

📋
Responsdata (JSON)
Kopiera till urklipp
{
  "id": "65eb3d14f1234567890abcdef",
  "brand": "Min-Butik-AB",
  "agent": "Kundservice",
  "type": 2,
  "content": "Hej! Din order är nu skickad.",
  "card": {
    "title": "Order #12345",
    "content": "Paketet beräknas anlända imorgon.",
    "mediaUrl": "https://cdn.site.se/package.jpg",
    "type": 1,
    "height": 2
  },
  "suggestions": [
    {
      "text": "Spåra paket",
      "type": 1,
      "url": "https://frakt.se/track/123",
      "postbackData": "track_click",
      "order": 0
    }
  ],
  "sendDate": "2026-03-04T15:05:00Z",
  "uniqueId": "order-12345-id",
  "reference": "INTERN-REF-001",
  "created": "2026-03-04T15:03:02Z",
  "tags": ["frakt", "viktigt"]
}

Fält för responsdata #

FältnamnBeskrivningTypExempel
idBundlens unika id.String"65eb3d14f1234567890abcdef"
brandDet använda varumärket.String”Min-Butik-AB”
agentNamnet på din agentString”Kundservice”
typeMeddelandetyp (t.ex. 1=Text).Integer1
contentTextinnehållet som skickades ut.String”Hej {name}! Din order är nu skickad.”
sendDateTidpunkt för utskick.DateTime”2026-03-04T15:05:00Z”
referenceDin valfria fritextreferens.String”INTERN-REF-001”
uniqueIdDitt egna ID för dubblettkontroll.String”order-12345-id”
createdTidpunkt när posten skapades i systemet.DateTime”2026-03-04T15:03:02Z”
tagsArray med taggar kopplade till utskicket.Array[”frakt”, ”viktigt”]
cardInnehåller detaljer för det skickade kortet (om tillämpligt).Object{…}
suggestionsLista med knappar som skickades med.Array[…]
Innehåll