RCS API

RCS per REST-API

Integrieren Sie interaktive RCS-Nachrichten in Ihre Anwendungen. Rich Cards, Karussells, Buttons und SMS-Fallback - alles über eine einfache REST-API.

Jetzt API-Key anfordern API Dokumentation
Nachrichten-Typen Interaktive Buttons Batch-Versand Webhooks Code-Beispiele Authentifizierung
Nachrichtentypen

9 Nachrichtenformate für jeden Anwendungsfall

Von einfachen Textnachrichten bis hin zu interaktiven Karussells - die API unterstützt alle RCS-Formate.

textBasic

Max. 160 Zeichen, SMS-ähnlich mit verifiziertem Absender

text

Bis zu 3.072 Zeichen + 11 Suggestion Chips

richCard

Bild/Video + Titel + Beschreibung + 4 Buttons

carousel

Bis zu 10 Karten, horizontal scrollbar

image

JPEG, PNG, GIF - direkt in der Nachrichten-App

video

MP4, 3GP für dynamische Inhalte

audio

MP3 für Sprachnachrichten und Podcasts

file

PDFs, Dokumente für Rechnungen & Tickets

media

Generischer Medientyp + Suggestion Chips

"suggestions": [
  {
    "reply": {
      "text": "Termin buchen",
      "postbackData": "book_apt",
      "webhookUrl": "https://..."
    }
  },
  {
    "action": {
      "text": "Anrufen",
      "type": "dial",
      "dialAction": {
        "phoneNumber": "+49..."
      }
    }
  }
]
Interaktiv

7 Button-Typen für jede Interaktion

Erstellen Sie interaktive Nachrichten mit bis zu 11 Suggestion Chips und 4 Card Actions pro Karte.

  • postback - Webhook-Callback mit benutzerdefinierten Daten
  • openUrl - Externe Links im Browser öffnen
  • openUrlInWebview - Links in der Messaging-App anzeigen
  • dial - Direktanruf starten
  • createCalendarEvent - Termin zum Kalender hinzufügen
  • viewLocation - Standort in Google Maps zeigen
  • shareLocation - Standort des Empfängers anfordern
Batch-Versand

Bis zu 10.000 Empfänger pro Request

Senden Sie dieselbe Nachricht an tausende Empfänger mit einem einzigen API-Call. Ideal für Kampagnen und Massenkommunikation.

  • Automatische Filterung deaktivierter Kontakte
  • Test-Nummern werden nicht berechnet
  • Progress-Tracking via Job-ID
  • Konfigurierbarer Batch-Size und Delay
  • Kampagnen-Namen für Tracking und Reporting
10.000
Empfänger pro Request
POST /send-batch
RCS
Nicht verfügbar?
SMS
SMS Fallback

Automatischer SMS-Fallback

Wenn RCS nicht verfügbar ist, wird automatisch eine SMS gesendet. Definieren Sie pro Nachricht einen SMS-Fallback-Text.

  • Automatische Erkennung von RCS-Fähigkeit
  • Separater SMS-Absender konfigurierbar
  • Bis zu 1.530 Zeichen SMS-Text
  • Fallback-Grund im API-Response
Scheduling

Zeitzonengesteuerte Terminplanung

Planen Sie Nachrichten für einen bestimmten Zeitpunkt in der Zukunft. Mit IANA-Timezone-Unterstützung erreichen Sie Ihre Empfänger immer zum richtigen Zeitpunkt.

  • IANA Timezone-Unterstützung (Europe/Berlin, etc.)
  • Validierung vor dem Senden via /validate-schedule-time
  • Planbare Batch-Nachrichten
  • Stornierbare Jobs via DELETE /batch/{jobId} 
{
  "scheduleAt": "2024-02-15T09:00:00",
  "timeZone": "Europe/Berlin"
}
{
  "event": "rcs_button_clicked",
  "timestamp": "2024-01-15T10:30:00Z",
  "interaction": {
    "type": "button_click",
    "buttonText": "Jetzt kaufen",
    "postbackData": "product_123",
    ...
  },
  "message": {
    "id": "...",
    "campaignName": "Sommeraktion",
    ...
  },
  "contact": {
    "phone": "+4912345678",
    "name": "Max Mustermann",
    ...
  }
}
Webhooks

Echtzeit Button-Callbacks

Erhalten Sie sofortige Benachrichtigungen, wenn Empfänger auf Buttons klicken. Verbinden Sie Ihre Backend-Systeme für automatisierte Workflows.

  • Echtzeit-Benachrichtigungen bei Button-Klicks
  • Benutzerdefinierte postbackData für Kontext
  • Kontakt-Informationen im Payload
  • Pro-Button Webhook-URLs möglich
Code-Beispiele

Einfache Integration

Mit wenigen Zeilen Code senden Sie Ihre erste RCS-Nachricht.

Request

# Rich Card mit Button senden
curl -X POST https://api.sendrcs.eu/api/rcs/send \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+4912345678",
    "messageType": "richCard",
    "sendernameId": "your-sender-id",
    "content": {
      "title": "Willkommen!",
      "description": "Entdecken Sie unsere Angebote",
      "media": {
        "height": "MEDIUM",
        "contentInfo": {
          "fileUrl": "https://example.com/image.jpg"
        }
      },
      "cardActions": [{
        "text": "Mehr erfahren",
        "type": "openUrl",
        "openUrlAction": {
          "url": "https://example.com"
        }
      }]
    }
  }'

Response

{
  "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

Übersicht aller verfügbaren Endpoints

Methode Endpoint Beschreibung
POST /send Einzelne Nachricht senden
POST /send-batch Batch-Nachrichten (bis 10.000 Empfänger)
POST /validate Nachricht vor dem Senden validieren
GET /timezones Verfügbare Zeitzonen abrufen
POST /validate-schedule-time Geplanten Zeitpunkt validieren
GET /batch/{jobId}/status Batch-Job Status abfragen
DELETE /batch/{jobId} Batch-Job stornieren
GET /limits Nachrichtenlimits und -einschränkungen abrufen
GET /button-guidelines Button-Richtlinien und Limits
GET /conversations Aktive Konversationen auflisten
GET /status Service-Status prüfen
Authentifizierung

Einfache API-Key Authentifizierung

Alle API-Anfragen erfordern einen API-Key im Header. Generieren Sie Ihren Key im Dashboard. 

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

API-Keys finden Sie unter Einstellungen → API Keys in Ihrem Dashboard.

Conversation Billing

24-Stunden Konversationsfenster

Innerhalb eines 24-Stunden-Fensters senden Sie unbegrenzt Nachrichten zum Preis einer Konversation. Optimieren Sie Ihre Kosten bei hohem Nachrichtenvolumen.

  • 24-Stunden Fenster ab erster Nachricht
  • Billing-Preview vor dem Versand via API
  • Analytics Endpoint für Konversations-Metriken
  • Kostenoptimierung bei Follow-up Nachrichten
24h
Konversationsfenster
Unbegrenzte Nachrichten zum Festpreis
FAQ

RCS-API – häufige Fragen

Wie sende ich eine RCS-Nachricht über die API?

Senden Sie einen POST-Request an https://api.sendrcs.eu/api/rcs/send mit Ihrem API-Key im Header X-API-Key und einem JSON-Body mit Absender-ID, Empfänger und Nachrichteninhalt – zum Beispiel einer Rich Card mit Titel, Beschreibung, Bild und Button. Die Antwort liefert eine Nachrichten-ID und den Status. Vollständige Beispiele für jedes Format finden Sie in der API-Dokumentation.

Wie authentifiziere ich API-Anfragen?

Jede Anfrage benötigt einen API-Key im Header X-API-Key. Ihre Keys erstellen und verwalten Sie im SendRCS-Dashboard unter Einstellungen und API-Keys.

Welche Nachrichtenformate unterstützt die API?

Neun Formate: Basic Text (bis 160 Zeichen), Rich Text (bis 3.072 Zeichen und 11 Suggestion Chips), Rich Card, Carousel (bis 10 Karten), Bild, Video, Audio, Datei (PDFs und Dokumente) sowie generische Medien mit Suggestion Chips. Sieben Button-Typen stehen zur Verfügung: postback, openUrl, openUrlInWebview, dial, createCalendarEvent, viewLocation und shareLocation.

Kann ich mit einer Anfrage an viele Empfänger senden?

Ja. Der Batch-Endpoint sendet dieselbe Nachricht mit einem einzigen API-Aufruf an bis zu 10.000 Empfänger. Deaktivierte Kontakte werden automatisch herausgefiltert, Batch-Größe und Verzögerung sind konfigurierbar, und über einen Kampagnennamen lässt sich der Versand tracken und auswerten.

Wie funktioniert der SMS-Fallback in der API?

Definieren Sie für jede Nachricht einen SMS-Fallback-Text. Die API erkennt automatisch, ob der Empfänger RCS empfangen kann, und sendet andernfalls die SMS – mit separat konfigurierbarem SMS-Absender und bis zu 1.530 Zeichen Text. Die API-Antwort zeigt, wann und warum ein Fallback verwendet wurde.

Kann ich Nachrichten über die API zeitlich planen?

Ja. Übergeben Sie eine scheduleAt-Zeit mit IANA-Zeitzonen-Unterstützung, etwa Europe/Berlin, und die Nachricht wird zu diesem Zeitpunkt in der Ortszeit des Empfängers gesendet. Über den Endpoint validate-schedule-time prüfen Sie eine Zeit vorab, mit DELETE /batch/{jobId} brechen Sie einen geplanten Job ab.

Wie erfahre ich, wenn ein Empfänger auf einen Button klickt?

Über Webhooks. SendRCS ruft Ihr Backend bei jedem Button-Klick in Echtzeit auf – mit den von Ihnen definierten postbackData und den Kontaktinformationen im Payload. Webhook-URLs lassen sich pro Button festlegen, sodass Sie automatisierte Workflows in Ihren eigenen Systemen auslösen können.

Bereit, mit der RCS API zu starten?

Erstellen Sie Ihren kostenlosen Account und erhalten Sie Ihren API-Key in wenigen Minuten.

Jetzt API-Key anfordern API Dokumentation
  • Kein Abo
  • Keine Bindung
  • Pay as you go
  • Kostenlos testen