1. RCS
Conexteo API - Documentation SMS & RCS
FR
  • FR
  • EN
  • Introduction
  • Utilisateur
    • Consulter le solde de crédits
      GET
  • Messages
    • Réponses
      • Lister les réponses (paginé)
      • Lister toutes les réponses
    • RCS
      • Envoyer un message RCS
        POST
    • SMS
      • Envoyer un SMS
      • Envoyer un SMS à des listes de contacts
      • Envoyer un SMS avec variables par destinataire
      • Envoyer un SMS depuis un fichier
    • Lister les messages
      GET
    • Consulter un message
      GET
    • Annuler un message
      PUT
    • Lister les destinataires RCS d'un message
      GET
    • Lister les destinataires SMS d'un message (alias de GET /messages/{id}/sms)
      GET
    • Lister les destinataires SMS d'un message
      GET
  • Modèle
    • Lister les modèles de SMS
      GET
    • Créer un modèle de SMS
      POST
    • Lister les modèles RCS
      GET
    • Créer un modèle RCS
      POST
    • Supprimer un modèle RCS
      DELETE
    • Consulter un modèle RCS
      GET
    • Mettre à jour un modèle RCS
      PUT
    • Supprimer un modèle de SMS
      DELETE
    • Consulter un modèle de SMS
      GET
    • Mettre à jour un modèle de SMS
      PUT
  • Stops
    • Ajouter un STOP
      POST
    • Lister les STOP
      GET
    • Ajouter des STOP depuis un fichier
      POST
    • Supprimer un STOP
      DELETE
  • Listes de contacts
    • Lister les imports de contacts actifs
    • Démarrer un import de contacts
    • Consulter le statut d'un import de contacts
    • Lister les listes de contacts
    • Créer une liste de contacts
    • Supprimer une liste de contacts
    • Consulter une liste de contacts
    • Mettre à jour une liste de contacts
    • Lister les contacts d'une liste de contacts (paginé)
    • Lister tous les contacts d'une liste de contacts
  • Contacts
    • Ajouter des contacts
    • Supprimer un contact
    • Consulter un contact
    • Mettre à jour un contact
  • Sous-Comptes
    • Lister les sous-comptes
    • Créer un sous-compte
    • Lister les sous-comptes (paginé)
    • Consulter un sous-compte
    • Lister les crédits d'un sous-compte
    • Ajouter des crédits à un sous-compte
    • Modifier le mode de consommation des crédits d'un sous-compte
    • Retirer des crédits à un sous-compte
  • Webhooks
    • Consulter la configuration des webhooks
    • Remplacer la configuration des webhooks
    • Lister les livraisons de webhooks
    • Renouveler le secret de signature
  • Schemas
    • Contact
    • ContactDeleteResult
    • ContactImport
    • ContactImportStart
    • ContactImportStatus
    • ContactList
    • ContactListDeleteResult
    • ContactListRcsCapabilityStatus
    • ContactListRequest
    • ContactPage
    • ContactRequest
    • ContactsCreateResult
    • CreateContactsRequest
    • CreateStopRequest
    • CreateSubAccountRequest
    • CreatedSubAccount
    • Credit
    • DuplicateExternalIdError
    • DynamicShortUrlOptions
    • HttpError
    • ImportStopsRequest
    • InsufficientCreditsError
    • Message
    • MessagePage
    • MessageState
    • NotFoundError
    • NotFoundErrorDetail
    • PaginationMeta
    • RcsAgentRoute
    • RcsCallChoice
    • RcsCard
    • RcsCardContent
    • RcsCardHeight
    • RcsCarousel
    • RcsCarouselContent
    • RcsChoice
    • RcsChoiceType
    • RcsFallback
    • RcsLocationChoice
    • RcsQuote
    • RcsQuoteRcs
    • RcsQuoteSms
    • RcsRecipient
    • RcsRecipientPage
    • RcsSendResult
    • RcsSendResultRcs
    • RcsSendResultSms
    • RcsShortUrl
    • RcsTemplate
    • RcsTemplateDeleteResult
    • RcsTemplateRequest
    • RcsTextChoice
    • RcsTextContent
    • RcsType
    • RcsUrlChoice
    • Reply
    • ReplyExport
    • ReplyPage
    • SendDynamicSmsRequest
    • SendRcsRequest
    • SendSmsFromFileRequest
    • SendSmsRequest
    • SendSmsToContactListRequest
    • SendUnavailableError
    • ShortUrlMode
    • ShortUrlOptions
    • SmsQuote
    • SmsRecipient
    • SmsRecipientPage
    • SmsSendResult
    • Stop
    • StopImportResult
    • StopPage
    • SubAccount
    • SubAccountCreditsModeRequest
    • SubAccountCreditsRefusal
    • SubAccountCreditsRequest
    • SubAccountDetail
    • SubAccountListItem
    • SubAccountPage
    • SubAccountTwoFactor
    • Template
    • TemplateDeleteResult
    • TemplateRequest
    • UpdateWebhooksRequest
    • Webhook
    • WebhookConfig
    • WebhookDelivery
    • WebhookDeliveryPage
    • WebhookDeliveryState
    • WebhookEvent
    • WebhookRequestMethod
    • WebhookSecret
    • WebhookSetting
    • WebhookType
  1. RCS

Envoyer un message RCS

POST
/messages/rcs
Envoi de message RCS.
Passez resumeBefore à true pour obtenir un devis sans envoyer la campagne : rien n'est débité, et un solde de repli SMS insuffisant est signalé dans sms.credits_missing au lieu d'une 403.
La partie RCS n'est jamais bloquée par le solde de crédits ; seul le repli SMS est contrôlé et débité, et seulement quand fallback.content est renseigné. À l'envoi, les SMS de repli partent vers les destinataires qui ne peuvent pas recevoir le RCS : avec checkCapability à true, les contacts que la vérification de compatibilité a trouvés non compatibles RCS (un contact sans statut de compatibilité, jamais vérifié, n'en fait pas partie) et les destinataires d'un pays sans agent RCS ; avec checkCapability à false, les destinataires d'un pays sans agent RCS. Ce repli est débité à l'acceptation de l'envoi, et un solde insuffisant est refusé par une 403.
Plus tard, un destinataire à qui le RCS ne peut pas être remis (accusé de réception RECIPIENT_NOT_REACHABLE) reçoit lui aussi le SMS de repli, quel que soit checkCapability : ce repli réactif est débité au moment où il est généré, jamais refusé par une 403 ; si le solde est alors insuffisant, le SMS n'est pas envoyé, le RCS reste non remis et l'événement de webhook rcs.fallback_blocked_credits est émis une fois par campagne (et par instance de traitement), pas une fois par destinataire. Un destinataire dont le pays ne peut plus être tarifé à ce moment (prix changés depuis l'envoi) ne reçoit pas de SMS de repli, sans webhook ni 403.
Variables : écrivez #variable# dans les textes du message. Les noms sont les propriétés de chaque entrée de contacts, ou les champs des contacts des listes (#nom#, #prenom#, #perso1#, ...). #URL# est remplacé par le lien court quand shorturl est renseigné (seule la première occurrence de chaque texte est remplacée).
Les numéros en double (doublons) et les numéros de la liste STOP (stops) sont retirés de l'envoi.

Request

Authorization
API Key
Add parameter in header
X-APP-ID
Example:
X-APP-ID: ********************
API Key
Add parameter in header
X-API-KEY
Example:
X-API-KEY: ********************
or
Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Succès : envoi accepté (RcsSendResult), ou devis si resumeBefore=true (RcsQuote).
Bodyapplication/json

🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🟠409Conflict
🟠413Service Unavailable
🔴503Service Unavailable
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.conexteo.com/messages/rcs?resumeBefore=undefined' \
--header 'X-APP-ID: <api-key>' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "checkCapability": false,
    "contactlist": [
        1,
        2
    ],
    "contacts": [
        {
            "prenom": "Claire",
            "recipient": "+33639980001"
        },
        {
            "prenom": "Paul",
            "recipient": "+33639980002"
        }
    ],
    "data": {
        "choices": [
            {
                "postback_data": "rdv_confirm",
                "text": "Oui, je confirme",
                "type": "text"
            },
            {
                "title": "Voir le RDV",
                "type": "url",
                "url": "https://example.com/rdv/123"
            }
        ],
        "description": "string",
        "media_message_url": "https://example.com/image.png",
        "title": "string"
    },
    "external_id": "123456789-client",
    "fallback": {
        "content": "Hello World",
        "sender": "SENDER"
    },
    "name": "Nom de votre campagne RCS",
    "rcsAgentRoutes": [
        {
            "countryCode": "FR",
            "rcsAgentId": 12
        }
    ],
    "scheduleAt": "2019-08-24T14:15:22.123Z",
    "shorturl": {
        "mode": "unique",
        "url": "https://example.com/promo"
    },
    "type": "card",
    "webviewMode": "FULL"
}'
Response Response Example
200 - Example 1
{
    "message": "message created",
    "message_id": 123456,
    "rcs": {
        "credits_used": 12352,
        "rcs_count": 12352
    },
    "sms": {
        "credits_used": 0,
        "sms_count": 0
    },
    "success": true
}
Modified at 2026-11-17 07:38:43
Previous
Lister toutes les réponses
Next
Envoyer un SMS
Built with