RCS API

RCS via REST API

Integrer interaktive RCS-beskeder i dine applikationer. Rich Cards, karruseller, knapper og SMS-Fallback – alt via et enkelt REST API.

Beskedtyper

9 beskedformater til alle anvendelsesområder

Fra enkle tekstbeskeder til interaktive karruseller – API'et understøtter alle RCS-formater.

textBasic

Maks. 160 tegn, SMS-lignende med verificeret afsender

text

Op til 3.072 tegn + 11 forslagsknapper

richCard

Billede/video + titel + beskrivelse + 4 knapper

carousel

Op til 10 kort, horisontalt scrollbare

image

JPEG, PNG, GIF – direkte i beskedappen

video

MP4, 3GP til dynamisk indhold

audio

MP3 til talebeskeder og podcasts

file

PDF'er, dokumenter til fakturaer og billetter

media

Generisk mediatype + forslagsknapper

"suggestions": [
  {
    "reply": {
      "text": "Book tid",
      "postbackData": "book_apt",
      "webhookUrl": "https://..."
    }
  },
  {
    "action": {
      "text": "Ring",
      "type": "dial",
      "dialAction": {
        "phoneNumber": "+45..."
      }
    }
  }
]
Interaktivt

7 knaptyper til enhver interaktion

Opret interaktive beskeder med op til 11 forslagsknapper og 3 korthandlinger per kort.

  • postback – Webhook-callback med tilpassede data
  • openUrl – Åbn eksterne links i browseren
  • openUrlInWebview – Vis links direkte i beskedappen
  • dial – Start et direkte opkald
  • createCalendarEvent – Tilføj begivenhed i kalenderen
  • viewLocation – Vis placering i Google Maps
  • shareLocation – Anmod om modtagerens placering
Masseudsendelse

Op til 10.000 modtagere per forespørgsel

Send den samme besked til tusindvis af modtagere med et enkelt API-kald. Perfekt til kampagner og massekommunikation.

  • Automatisk filtrering af deaktiverede kontakter
  • Testnumre debiteres ikke
  • Fremskridtssporing via Job-ID
  • Konfigurerbar batchstørrelse og forsinkelse
  • Kampagnenavn til sporing og rapportering
10.000
Modtagere per forespørgsel
POST /send-batch
RCS
Ikke tilgængeligt?
SMS
SMS-Fallback

Automatisk SMS-Fallback

Når RCS ikke er tilgængeligt, sendes en SMS automatisk. Definer en SMS-reservetekst for hver besked.

  • Automatisk registrering af RCS-kapacitet
  • Separat SMS-afsender konfigurerbar
  • Op til 1.530 tegn SMS-tekst
  • Fallback-årsag i API-svar
Planlægning

Tidszonebevidst planlægning

Planlæg beskeder til et bestemt tidspunkt i fremtiden. Med IANA-tidszonestøtte når du altid dine modtagere på det rigtige tidspunkt.

  • IANA-tidszonestøtte (Europe/Copenhagen, etc.)
  • Validering før afsendelse via /validate-schedule-time
  • Planlagte massebeskeder
  • Annullerbare jobs via DELETE /batch/{jobId}
{
  "scheduleAt": "2024-02-15T09:00:00",
  "timeZone": "Europe/Copenhagen"
}
{
  "event": "rcs_button_clicked",
  "timestamp": "2024-01-15T10:30:00Z",
  "interaction": {
    "type": "button_click",
    "buttonText": "Køb nu",
    "postbackData": "product_123",
    ...
  },
  "message": {
    "id": "...",
    "campaignName": "Sommerkampagne",
    ...
  },
  "contact": {
    "phone": "+4570123456",
    "name": "Anna Jensen",
    ...
  }
}
Webhooks

Realtids-knapcallbacks

Få øjeblikkelige notifikationer, når modtagere klikker på knapper. Forbind dine backend-systemer til automatiserede workflows.

  • Realtidsnotifikationer ved knapklik
  • Tilpasset postbackData til kontekst
  • Kontaktoplysninger i payload
  • Webhook-URL'er per knap understøttes
Kodeeksempler

Enkel integration

Send din første RCS-besked med blot et par linjer kode.

Forespørgsel

# Send et Rich Card med knap
curl -X POST https://api.sendrcs.dk/api/rcs/send \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+4570123456",
    "messageType": "richCard",
    "sendernameId": "your-sender-id",
    "content": {
      "title": "Velkommen!",
      "description": "Opdag vores tilbud",
      "media": {
        "height": "MEDIUM",
        "contentInfo": {
          "fileUrl": "https://example.com/image.jpg"
        }
      },
      "cardActions": [{
        "text": "Læs mere",
        "type": "openUrl",
        "openUrlAction": {
          "url": "https://example.com"
        }
      }]
    }
  }'

Svar

{
  "success": true,
  "messageId": "msg_abc123def456",
  "method": "rcs",
  "creditsUsed": 1,
  "hasInteractiveButtons": true,
  "conversation": {
    "conversationId": "conv_xyz",
    "status": "ACTIVE",
    "remainingTime": "23:59:00",
    "chargedMessage": true,
    "messageCount": {
      "total": 1,
      "outbound": 1,
      "inbound": 0
    }
  }
}

API-endpoints

Oversigt over alle tilgængelige endpoints

Metod Endpoint Beskrivelse
POST /send Send en enkelt besked
POST /send-batch Massebeskeder (op til 10.000 modtagere)
POST /validate Valider besked før afsendelse
GET /timezones Hent tilgængelige tidszoner
POST /validate-schedule-time Valider planlagt tid
GET /batch/{jobId}/status Kontroller status for batchjob
DELETE /batch/{jobId} Annuller batchjob
GET /limits Hent hastighedsbegrænsninger
GET /button-guidelines Knapretningslinjer og begrænsninger
GET /conversations Liste aktive samtaler
GET /status Kontroller tjenestestatus
Autentificering

Enkel API-nøgleautentificering

Alle API-forespørgsler kræver en API-nøgle i headeren. Generer din nøgle i dit Dashboard.

X-API-Key: your-api-key-here

Du finder dine API-nøgler under Settings → API Keys i dit dashboard.

Samtaledebitering

24 timers samtalevindue

Inden for et 24-timersvindue kan du sende ubegrænsede beskeder til prisen af en samtale. Optimer dine omkostninger med høje beskedvolumener.

  • 24-timersvindue fra den første besked
  • Debiteringsforhåndsvisning før afsendelse via API
  • Analytics-endpoint til samtalestatistik
  • Omkostningsoptimering for opfølgningsbeskeder
24h
Samtalevindue
Ubegrænsede beskeder til en fast pris

Klar til at komme i gang med RCS API?

Opret din gratis konto og få din API-nøgle på få minutter.

  • Intet abonnement
  • Ingen binding
  • Betal per brug
  • Gratis at prøve