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 3 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 Rate Limits 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

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