API RCS

RCS via API REST

Intégrez des messages RCS interactifs dans vos applications. Rich Cards, carrousels, boutons et fallback 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 suggestion chips

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 + suggestion chips

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

7 types de boutons pour chaque interaction

Créez des messages interactifs avec jusqu'à 11 suggestion chips et 3 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 localisation 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 Job-ID
  • Taille de lot configurable et délai
  • 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 au support des fuseaux horaires IANA, vous atteignez toujours vos destinataires au bon moment.

  • Support 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
  • URLs webhook par bouton supportées
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 groupée
DELETE /batch/{jobId} Annuler la tâche groupée
GET /limits Récupérer les limites de débit
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 sous 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

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