Registrera Brands och Agenter

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. Bas-URL för samtliga anrop är https://api.ip1.net/v3

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/v3/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ält för responsdata

Agenter

Quickstart

curl -X POST https://api.ip1.net/v3/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ält för responsdata

Vill du veta mer?

Läs mer om hur verifierade avsändare fungerar i vår guide: