Innan du kan skicka meddelanden behöver du sätta upp en struktur för ditt varumärke (Brand) och dina agenter.
Brands och agenter utgör den strukturella grunden för din RCS-kommunikation: ett Brand representerar företagets övergripande identitet, medan en Agent är den specifika avsändarprofil eller chattbot som interagerar med slutanvändaren.
Genom att organisera dina agenter under ett varumärke kan du hantera olika tjänster, såsom support och marknadsföring, med unika profiler men med en konsekvent visuell upplevelse för kunden.
Observera: Just nu är möjligheten att registrera Brands eller agenter via API:et begränsad. Vänligen kontakta support@ip1.se för att registrera ditt Brand samt agenter.
Brands #
Quick Start #
Nedan hittar du ett exempel på hur du registrerar en Agent
curl -X POST https://api.ip1.net/brands \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"displayName": "Min Butik AB"}'Endpoints – Brands #
Lista alla dina registrerade Brands #
Endpoint: /brands
Metod: GET
Exempel på responsdata
{
"brandName": "min-butik-ab",
"displayName": "Min Butik AB",
"created": "2026-03-04T10:00:00Z"
}Registrera ett nytt Brand #
Endpoint: /brands
Metod: POST
Exempel på anropsdata
{
"displayName": "Min Butik AB"
}Hämta detaljer kring ett specifikt Brand #
Endpoint: /brands/{brandName}
Metod: GET
Exempel på responsdata
{
"brandName": "min-butik-ab",
"displayName": "Min Butik AB",
"created": "2026-03-04T10:00:00Z"
}Radera ett specifikt Brand #
Endpoint: /brands/{brandName}
Metod: DELETE
Exempel på responsdata
{
"brandName": "min-butik-ab",
"displayName": "Min Butik AB",
"created": "2026-03-04T10:00:00Z"
}Fält för anropsdata #
| Fältnamn | Beskrivning | Required | Typ | Exempel |
| displayName | Namnet på agenten som syns i chatten | Ja | String | "Kundservice" |
Fält för responsdata #
| Fältnamn | Beskrivning | Typ | Exempel |
| brandName | Systemets interna ID/namn för brandet. | String | "min-butik-ab" |
| displayName | Det visningsnamn som angavs vid skapandet. | String | ”Min Butik AB” |
| created | Tidpunkt när brandet registrerades. | DateTime | ”2026-03-04T10:00:00Z” |
Agenter #
Quickstart #
curl -X POST https://api.ip1.net/brands/min-butik-ab/agents \
-H "Authorization: Bearer DIN_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"displayName": "Kundservice",
"description": "Vi hjälper dig med dina leveransfrågor.",
"logoUri": "https://din-doman.se/assets/logo.png",
"heroUri": "https://din-doman.se/assets/banner.png",
"privacyUri": "https://din-doman.se/privacy",
"termsUri": "https://din-doman.se/terms",
"color": "#007AFF",
"emailAdress": "support@din-doman.se",
"websiteUri": "https://din-doman.se"
}'Lista agenter kopplade till ett brand #
Endpoint: /brands/{brandName}/agents
Metod: GET
Skapa en ny agent #
Endpoint: /brands/{brandName}/agents
Metod: POST
Exempel på anropsdata
{
"displayName": "Kundservice",
"description": "Vi hjälper dig med dina frågor om leverans.",
"logoUri": "https://din-sida.se/logo.png",
"heroUri": "https://din-sida.se/banner.png",
"color": "#FF5733",
"privacyUri": "https://din-sida.se/privacy",
"termsUri": "https://din-sida.se/terms"
}Hämta detaljer kring en specifik agent #
Endpoint: /brands/{brandName}/agents/{name}
Metod: GET
Exempel på responsdata
{
"name": "kundservice",
"brandName": "min-butik",
"displayName": "Kundservice",
"description": "Vi hjälper dig med dina frågor.",
"logoUri": "https://din-sida.se/logo.png",
"color": "#FF5733",
"created": "2026-03-04T12:00:00Z"
}Raderar en specifik agent #
Endpoint: /brands/{brandName}/agents/{name}
Metod: DELETE
Exempel på responsdata
{
"name": "kundservice",
"brandName": "min-butik",
"displayName": "Kundservice",
"description": "Vi hjälper dig med dina frågor.",
"logoUri": "https://din-sida.se/logo.png",
"color": "#FF5733",
"created": "2026-03-04T12:00:00Z"
}Fält för anropsdata #
| Fältnamn | Beskrivning | Required | Typ | Exempel |
| displayName | Namnet på agenten som syns i chatten | Ja | String | "Kundservice" |
| description | En kort beskrivning av agentens syfte. | Ja | String | ”Vi hjälper dig med orderfrågor” |
| logoUri | URL till agentens logotyp (kvadratisk). | Ja | URI | ”https://cdn.se/logo.png” |
| heroUri | URL till den stora bannerbilden i profilen. | Ja | URI | ”https://cdn.se/hero.png” |
| color | Temafärg för chatten (Hex-kod). | Ja | String | ”#FF5733” |
| privacyUri | Länk till integritetspolicy. | Ja | URI | ”https://site.se/privacy” |
| termsUri | Länk till användarvillkor. | Ja | URI | ”https://site.se/terms” |
| emailAdress | Kontaktmail för agenten. | Nej | String | ”support@butik.se” |
Fält för responsdata #
| Fältnamn | Beskrivning | Typ | Exempel |
| name | Systemets interna ID för agenten. | String | "kundservice" |
| brandName | Namnet på brandet som agenten tillhör. | String | ”min-butik-ab” |
| displayName | Namnet som visas i användarens telefon. | String | ”Kundservice” |
| description | Beskrivningen av agenten. | String | ”Vi hjälper dig med order.” |
| logoUri | Publik länk till logotypen. | URI | ”https://cdn.se/logo.png” |
| color | Den valda temafärgen (Hex). | String | ”#FF5733” |
| created | Tidpunkt när agenten skapades. | DateTime | ”2026-03-04T12:00:00Z” |