> For the complete documentation index, see [llms.txt](https://www.docpartner.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.docpartner.dev/en/api/sms-partner/rcs.md). # RCS {% hint style="info" %} To enable this feature, please [contact the technical team](https://www.smspartner.fr/contact/) {% endhint %} ## URL `POST` `https://api.smspartner.fr/v1/rcs/send` {% hint style="warning" %} The platform does not send commercial SMS messages between **8 PM and 8 AM on weekdays and on Sundays and public holidays** (legal restriction). If a commercial SMS is sent, the message is **paused until the next working day at 8 AM**.\ Not sending commercial SMS messages? Contact us to disable this restriction: {% endhint %} #### **Required Parameters** | Name | Value | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `apiKey` | [Your API key](https://my.smspartner.fr/dashboard/api) | | `phoneNumbers` |

Recipient phone numbers.
To send multiple messages, separate the numbers with commas. Maximum of 500 numbers per request.
They can be:

| | `isUnicode` | 1 | | `richContent` | [See below](#contenu-enrich) | #### **Optional Parameters** | Name | Value | | ----------------------- | ----------------------------------------------------------------------------------------------- | | `scheduledDeliveryDate` | Scheduled send date in `dd/mm/YYYY` format. Set this only if you want the SMS to be sent later. | | `time` | Send time (0–24 format), required if `scheduledDeliveryDate` is set. | | `minute` | Send minute (0–55, in five-minute intervals), required if `scheduledDeliveryDate` is set. | #### Rich Content {% tabs %} {% tab title="Send a text" %} ```json { "apiKey": "", "isUnicode": 1, "phoneNumbers": [ "+33....." ], "richContent": { "conversation": { "text": "", "suggestions": [ // See the suggestions section (maximum 4) ] } }, "failover": { "sender": "cyril", "message": "this is a fallback SMS" } } ``` {% endtab %} {% tab title="Send a file" %} ```json { "apiKey": "", "phoneNumbers": [ "" ], "isUnicode": 1, "richContent": { "conversation": { "file": { "media": { "fileUrl": "" } }, "suggestions": [ // See the suggestions section (maximum 4) ] } }, "failover": { "sender": "cyril", "message": "this is a fallback SMS", "isStopSms": 1, "isUnicode": 1 } } ``` {% endtab %} {% tab title="Send a rich card" %} ```json { "apiKey": "", "phoneNumbers": [ "" ], "isUnicode": 1, "richContent": { "conversation": { "richCard": { "orientation": "VERTICAL", //VERTICAL or HORIZONTAL "thumbnailImageAlignment": "LEFT", //Only if orientation == HORIZONTAL "title": "", //Max 200 characters "description": "", //Max 500 characters "media": { "height": "MEDIUM", //Only if orientation == VERTICAL "mediaUrl": "" }, "suggestions": [ // See the suggestions section (max 4) ] }, "suggestions": [ // Global suggestions (max 8) ] } }, "failover": { "sender": "cyril", "message": "This is a fallback SMS", "isStopSms": 1, "isUnicode": 1 } } ``` {% endtab %} {% tab title="Send a carousel" %} ```json { "apiKey": "", "phoneNumbers": [ "" ], "isUnicode": 1, "richContent": { "conversation": { "carousel": { "cardWidth": "MEDIUM", //OR SMALL "cards": [ { "title": "", //Max 200 characters "description": "", //Max 500 characters "media": { "height": "MEDIUM", "mediaUrl": "" }, "suggestions": [ // Max 4 suggestions ] }, { "title": "", "description": "", "media": { "height": "MEDIUM", "mediaUrl": "" }, "suggestions": [] } ] }, "suggestions": [ // Global suggestions (max 8) ] } }, "failover": { "sender": "cyril", "message": "this is a fallback SMS", "isStopSms": 1, "isUnicode": 1 } } ``` {% endtab %} {% endtabs %} #### Suggestions {% tabs %} {% tab title="Réponse" %} ```json { "reply": { "text": "Réponse 2", "postbackData": "postback_data_1234" //Valeur qui sera envoyée en réponse à une suggestion. } } ``` {% endtab %} {% tab title="Action : Open a URL" %} ```json { "action": { "text": "Open SMSPartner", "postbackData": "postback_data_1", "openUrlAction": { "url": "https://www.smspartner.fr" } } } ``` {% endtab %} {% tab title="Action : Appeler" %} ```json { "action": { "text": "Call SMSPartner", "postbackData": "postback_data_2", "dialAction": { "phoneNumber": "+33......." } } } ``` {% endtab %} {% tab title="Action : Location" %} ```json { "action": { "text": "Location", "postbackData": "postback_data_3", "viewLocationAction": { "label": "Here !!!", "latLong": { "latitude": 2.4220188, "longitude": -122.0844786 } } } } ``` {% endtab %} {% tab title="Action : Calendar" %} {% endtab %} {% endtabs %} #### **Response** {% tabs %} {% tab title="json" %} ```json { "success":true, "code":200, "message_id":1, "nb_rcs": 1, "cost": 0.12, "currency": "EUR" } ``` {% endtab %} {% endtabs %} #### **Supported Media File Types** RBM supports the following media types: | Content Type | Document Type | Extension | Compatible with Rich Cards | | --------------- | ----------------- | ----------- | -------------------------- | | application/ogg | Audio OGG | .ogx | No | | application/pdf | PDF | .pdf | No | | audio/aac | Audio AAC | .aac | No | | audio/mp3 | MP3 Audio Format | .mp3 | No | | audio/mpeg | Audio MPEG | .mpeg | No | | audio/mpg | Audio MPG | .mp3 | No | | audio/mp4 | Audio MP4 | .mp4 | No | | audio/mp4-latm | Audio MP4-latm | .mp4 | No | | audio/3gpp | Audio 3GPP | .3gp | No | | image/jpeg | JPEG | .jpeg, .jpg | Yes | | image/gif | GIF | .gif | Yes | | image/png | PNG | .png | Yes | | video/h263 | H263 Video | .h263 | Yes | | video/m4v | M4V Video | .m4v | Yes | | video/mp4 | MP4 Video | .mp4 | Yes | | video/mpeg4 | MPEG-4 Video | .mp4, .m4p | Yes | | video/mpeg | MPEG Video | .mpeg | Yes | | video/webm | WebM Video Format | .webm | Yes | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://www.docpartner.dev/en/api/sms-partner/rcs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.