API RCS

RCS via API REST

Intégrez des messages RCS interactifs dans vos applications. Rich Cards, carrousels, boutons et repli SMS : le tout via une simple API REST.

Obtenez votre clé API Documentation API

Types de messages Boutons interactifs Envoi groupé Webhooks Exemples de code Authentification

Types de messages

9 formats de messages pour chaque cas d'usage

Des simples messages texte aux carrousels interactifs - l'API prend en charge tous les formats RCS.

textBasic

Max. 160 caractères, similaire au SMS avec expéditeur vérifié

text

Jusqu'à 3 072 caractères + 11 suggestions

richCard

Image/vidéo + titre + description + 4 boutons

carousel

Jusqu'à 10 cartes, défilement horizontal

image

JPEG, PNG, GIF : directement dans l'application de messagerie

video

MP4, 3GP pour du contenu dynamique

audio

MP3 pour les messages vocaux et podcasts

file

PDF, documents pour factures et tickets

media

Type de média générique + suggestions

"suggestions": [
  {
    "reply": {
      "text": "Prendre rendez-vous",
      "postbackData": "book_apt",
      "webhookUrl": "https://..."
    }
  },
  {
    "action": {
      "text": "Appeler",
      "type": "dial",
      "dialAction": {
        "phoneNumber": "+33..."
      }
    }
  }
]

Interactif

7 types de boutons pour chaque interaction

Créez des messages interactifs avec jusqu'à 11 suggestions et 4 actions par carte.

postback - Callback webhook avec données personnalisées
openUrl - Ouvrir des liens externes dans le navigateur
openUrlInWebview - Afficher les liens dans l'application de messagerie
dial - Lancer un appel direct
createCalendarEvent - Ajouter un événement au calendrier
viewLocation - Afficher la localisation dans Google Maps
shareLocation - Demander la position du destinataire

Envoi groupé

Jusqu'à 10 000 destinataires par requête

Envoyez le même message à des milliers de destinataires en un seul appel API. Idéal pour les campagnes et la communication de masse.

Filtrage automatique des contacts désactivés
Numéros de test non facturés
Suivi de progression via l'ID de tâche (job ID)
Taille de lot et délai configurables
Noms de campagne pour le suivi et le reporting

10 000

Destinataires par requête

POST /send-batch

RCS

Non disponible ?

SMS

Repli SMS

Repli SMS automatique

Lorsque le RCS n'est pas disponible, un SMS est envoyé automatiquement. Définissez un texte de repli SMS pour chaque message.

Détection automatique de la compatibilité RCS
Expéditeur SMS distinct configurable
Jusqu'à 1 530 caractères de texte SMS
Raison du repli dans la réponse API

Planification

Planification avec gestion des fuseaux horaires

Planifiez l'envoi de messages à un moment précis dans le futur. Grâce à la prise en charge des fuseaux horaires IANA, vous atteignez toujours vos destinataires au bon moment.

Prise en charge des fuseaux horaires IANA (Europe/Paris, etc.)
Validation avant envoi via /validate-schedule-time
Messages groupés planifiables
Tâches annulables via DELETE /batch/{jobId}

{
  "scheduleAt": "2024-02-15T09:00:00",
  "timeZone": "Europe/Paris"
}

{
  "event": "rcs_button_clicked",
  "timestamp": "2024-01-15T10:30:00Z",
  "interaction": {
    "type": "button_click",
    "buttonText": "Buy now",
    "postbackData": "product_123",
    ...
  },
  "message": {
    "id": "...",
    "campaignName": "Soldes d'été",
    ...
  },
  "contact": {
    "phone": "+4412345678",
    "name": "John Smith",
    ...
  }
}

Webhooks

Callbacks de boutons en temps réel

Recevez des notifications instantanées lorsque les destinataires cliquent sur les boutons. Connectez vos systèmes backend pour des workflows automatisés.

Notifications en temps réel lors des clics sur les boutons
postbackData personnalisé pour le contexte
Informations de contact dans le payload
URL de webhook par bouton prises en charge

Exemples de code

Intégration simple

Envoyez votre premier message RCS en quelques lignes de code.

Requête

# Envoyer une Rich Card avec bouton
curl -X POST https://api.sendrcs.eu/api/rcs/send \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+4412345678",
    "messageType": "richCard",
    "sendernameId": "your-sender-id",
    "content": {
      "title": "Welcome!",
      "description": "Discover our offers",
      "media": {
        "height": "MEDIUM",
        "contentInfo": {
          "fileUrl": "https://example.com/image.jpg"
        }
      },
      "cardActions": [{
        "text": "En savoir plus",
        "type": "openUrl",
        "openUrlAction": {
          "url": "https://example.com"
        }
      }]
    }
  }'

Réponse

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

Endpoints API

Aperçu de tous les endpoints disponibles

Méthode	Endpoint	Description
POST	/send	Envoyer un message unique
POST	/send-batch	Messages groupés (jusqu'à 10 000 destinataires)
POST	/validate	Valider le message avant l'envoi
GET	/timezones	Récupérer les fuseaux horaires disponibles
POST	/validate-schedule-time	Valider l'heure planifiée
GET	/batch/{jobId}/status	Vérifier le statut de la tâche d'envoi groupé
DELETE	/batch/{jobId}	Annuler la tâche d'envoi groupé
GET	/limits	Récupérer les limites et contraintes des messages
GET	/button-guidelines	Directives et limites des boutons
GET	/conversations	Lister les conversations actives
GET	/status	Vérifier le statut du service

Authentification

Authentification simple par clé API

Toutes les requêtes API nécessitent une clé API dans l'en-tête. Générez votre clé dans le tableau de bord.

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

Vous trouverez vos clés API dans Paramètres → Clés API dans votre tableau de bord.

Facturation par conversation

Fenêtre de conversation de 24 heures

Dans une fenêtre de 24 heures, envoyez un nombre illimité de messages au prix d'une seule conversation. Optimisez vos coûts avec des volumes de messages élevés.

Fenêtre de 24 heures à partir du premier message
Aperçu de la facturation avant envoi via API
Endpoint d'analyse pour les métriques de conversation
Optimisation des coûts pour les messages de suivi

24h

Fenêtre de conversation

Messages illimités à un prix fixe

FAQ

API RCS : vos questions

Comment envoyer un message RCS via l'API ?

Envoyez une requête POST à https://api.sendrcs.eu/api/rcs/send avec votre clé API dans l'en-tête X-API-Key et un corps JSON contenant l'identifiant de l'expéditeur, le destinataire et le contenu du message - par exemple une Rich Card avec titre, description, image et un bouton. La réponse renvoie un identifiant de message et un statut. Des exemples complets pour chaque format se trouvent dans la documentation de l'API.

Comment authentifier les requêtes API ?

Chaque requête nécessite une clé API dans l'en-tête X-API-Key. Vous créez et gérez vos clés dans le tableau de bord SendRCS, sous Paramètres puis Clés API.

Quels formats de messages l'API prend-elle en charge ?

Neuf formats : Texte simple (jusqu'à 160 caractères), Texte enrichi (jusqu'à 3 072 caractères et 11 suggestions), Rich Card, carrousel (jusqu'à 10 cartes), image, vidéo, audio, fichier (PDF et documents) et média générique avec suggestions. Sept types de boutons sont disponibles : postback, openUrl, openUrlInWebview, dial, createCalendarEvent, viewLocation et shareLocation.

Puis-je envoyer à de nombreux destinataires en une seule requête ?

Oui. Le point de terminaison batch envoie le même message à jusqu'à 10 000 destinataires en un seul appel API. Les contacts désactivés sont filtrés automatiquement, la taille des lots et le délai sont configurables, et un nom de campagne vous permet de suivre l'envoi et d'en faire le reporting.

Comment fonctionne le repli SMS dans l'API ?

Définissez un texte de repli SMS pour chaque message. L'API détecte automatiquement si le destinataire peut recevoir du RCS et envoie sinon le SMS à la place, avec un expéditeur SMS configurable séparément et jusqu'à 1 530 caractères de texte. La réponse de l'API indique quand et pourquoi un repli a été utilisé.

Puis-je programmer des messages via l'API ?

Oui. Transmettez une heure scheduleAt avec prise en charge des fuseaux horaires IANA, par exemple Europe/Paris, et le message est envoyé à ce moment dans l'heure locale du destinataire. Vous pouvez valider une heure à l'avance via le point de terminaison validate-schedule-time et annuler un envoi programmé avec DELETE /batch/{jobId}.

Comment être informé lorsqu'un destinataire clique sur un bouton ?

Via des webhooks. SendRCS appelle votre backend en temps réel à chaque clic sur un bouton, avec les postbackData que vous avez définies et les informations du contact dans la charge utile. Les URL de webhook peuvent être définies par bouton, ce qui permet de déclencher des flux automatisés dans vos propres systèmes.

Prêt à démarrer avec l'API RCS ?

Créez votre compte gratuit et obtenez votre clé API en quelques minutes.

Obtenez votre clé API Documentation API

Sans abonnement
Sans engagement
Paiement à l'usage
Essai gratuit