{"id":1212,"date":"2026-08-25T08:47:04","date_gmt":"2026-08-25T08:47:04","guid":{"rendered":"https:\/\/rcs-api.com\/?post_type=docs&#038;p=1212"},"modified":"2026-09-03T09:13:20","modified_gmt":"2026-09-03T09:13:20","password":"","slug":"fallback","status":"publish","type":"docs","link":"https:\/\/rcs-api.com\/en\/dokumentation\/introduktion\/fallback\/","title":{"rendered":"Fallback"},"content":{"rendered":"<p class=\"wp-block-paragraph\">Since RCS requires that the recipient's device and carrier support the technology, fallback logic is used to guarantee delivery (for example, by automatically switching to standard SMS text) if an RCS message cannot be delivered.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" style=\"margin-top:50px;margin-bottom:50px\"\/>\n\n\n\n<h2 id=\"h-oversikt-var-finns-fallback-logiken\" class=\"wp-block-heading my-5\">Overview: Where is the fallback logic?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">In the API specification, fallback is integrated at two levels:<\/p>\n\n\n\n<ol start=\"1\" class=\"wp-block-list\">\n<li><strong>Configuration (Requests):<\/strong> When sending messages, you specify instructions on how the system should act if RCS fails.<\/li>\n\n\n\n<li><strong>Status follow-up (Responses):<\/strong> When fetching data about sent messages, you can see the exact status and reason for any fallback.<\/li>\n<\/ol>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" style=\"margin-top:50px;margin-bottom:50px\"\/>\n\n\n\n<h2 id=\"h-1-konfiguration-av-fallback-vid-sandning-requests\" class=\"wp-block-heading my-5\">1. Configuring Fallback for Sending (Requests)<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Fallback settings can be defined in three central <code>POST<\/code>-endpoints when messages are initiated. These endpoints use the data structures <code>Bundle Request<\/code>, <code>Conversation Request<\/code> oh <code>Message Request<\/code>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>POST \/bundles<\/code> \u2013 Creates a bundle of messages to one or more recipients.<\/li>\n\n\n\n<li><code>POST \/conversations<\/code> \u2013 Starts a new two-way conversation with an initial message.<\/li>\n\n\n\n<li><code>POST \/conversations\/{conversation}<\/code> - Sending a new message in an ongoing conversation.<\/li>\n<\/ul>\n\n\n\n<h3 id=\"h-konfigurationsparametrar\" class=\"wp-block-heading\">Configuration parameters<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The following parameters are included in the JSON body to control the fallback behavior:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Parameter<\/strong><\/td><td><strong>Type<\/strong><\/td><td><strong>Description of the project<\/strong><\/td><\/tr><\/thead><tbody><tr><td><strong><code>fallback policy<\/code><\/strong><\/td><td>Enum<\/td><td>Determines which strategy\/policy to apply. Refers to <code>FallbackPolicy<\/code> (valid values: <code><em>NoFallback, FallbackOnNoCapability, FallbackOnFailure, FallbackAfterTimeout, CustomerControlledFallback<\/em><\/code>). Add multiple policies by separating each individual policy with a comma.<\/td><\/tr><tr><td><strong><code>fallbackTimeoutSeconds<\/code><\/strong><\/td><td><code>Integer<\/code><\/td><td>Time in seconds that the system waits for a delivery report from RCS before the fallback message is triggered.<br>\u2022 <em>Minimum<\/em> <code>1<\/code><br>\u2022 <em>Maximum:<\/em> <code>2147483647<\/code><\/td><\/tr><tr><td><strong><code>fallback message<\/code><\/strong><\/td><td><code>string<\/code><\/td><td>The actual text message (e.g., SMS) to be sent if fallback is activated.<br>\u2022 <em>Maximum length:<\/em> <code>160<\/code> characters (corresponds to the standard length of 1 SMS). The fallback message is auto-generated from Content or Card if not explicitly specified in the call.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" style=\"margin-top:50px;margin-bottom:50px\"\/>\n\n\n\n<h2 id=\"h-2-uppfoljning-och-status-responses-amp-get\" class=\"wp-block-heading my-5\">2. Follow-up and Status (Responses &amp; GET)<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">When reviewing sent messages or bundles via the API <code>GET<\/code>-endpoints, the object is included <code>RcsMessageFallback<\/code> in the response to report how the fallback has been handled.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This is available via, among other things:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>GET \/bundles\/{bundle}<\/code><\/li>\n\n\n\n<li><code>GET \/bundles\/{bundle}\/messages<\/code><\/li>\n\n\n\n<li><code>GET \/conversations\/{conversation}\/messages<\/code><\/li>\n\n\n\n<li><code>GET \/conversations\/{conversation}\/messages\/{id}<\/code><\/li>\n<\/ul>\n\n\n\n<h3 id=\"h-datastrukturen-rcsmessagefallback\" class=\"wp-block-heading\">Data structures <code>RcsMessageFallback<\/code><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">When reading a message, the following fields are returned in the fallback object:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Type<\/strong><\/td><td><strong>Description of the project<\/strong><\/td><\/tr><\/thead><tbody><tr><td><strong><code>fallback policy<\/code><\/strong><\/td><td><code>Text (enum)<\/code><\/td><td>The policy that is active for the message (<code><em>NoFallback, FallbackOnNoCapability, FallbackOnFailure, FallbackAfterTimeout, CustomerControlledFallback<\/em><\/code>).<\/td><\/tr><tr><td><strong><code>fallback timeout<\/code><\/strong><\/td><td><code>string<\/code> (date range)<\/td><td>The time span\/setting specified when setting up the request.<\/td><\/tr><tr><td><strong><code>fallback message<\/code><\/strong><\/td><td><code>string<\/code><\/td><td>The text provided in the request.<\/td><\/tr><tr><td><strong><code>fallback status<\/code><\/strong><\/td><td>Enum<\/td><td>Current status of the fallback delivery. Refers to <code>Fallback Status<\/code> (valid values: <code><em>Unknown, Pending, Sent, Completed, Failed<\/em><\/code>).<\/td><\/tr><tr><td><strong><code>fallback reason<\/code><\/strong><\/td><td><code>string<\/code><\/td><td>System error message or description of <em>why<\/em> fallback was activated (e.g. \u201dRecipient lacks RCS capability\u201d).<\/td><\/tr><tr><td><strong><code>fallbackMessageId<\/code><\/strong><\/td><td>String<code>ObjectId<\/code>)<\/td><td>The unique ID of the generated fallback message (e.g., the Batch ID in the underlying SMS gateway) to enable tracking.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" style=\"margin-top:50px;margin-bottom:50px\"\/>\n\n\n\n<h2 id=\"h-3-enum-definitioner\" class=\"wp-block-heading my-5\">3. Enum definitions<\/h2>\n\n\n\n<h3 id=\"h-fallbackpolicy\" class=\"wp-block-heading\"><code>FallbackPolicy<\/code><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Used in requests to select fallback behavior.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Values:<\/strong> <em>NoFallback, FallbackOnNoCapability, FallbackOnFailure, FallbackAfterTimeout, CustomerControlledFallback<\/em>.<\/li>\n<\/ul>\n\n\n\n<h3 id=\"h-fallbackstatus\" class=\"wp-block-heading\"><code>Fallback Status<\/code><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Used in responses to show where in the process the fallback message is located.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Values:<\/strong> <em>Unknown, Pending, Sent, Completed, Failed<\/em>.<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"<p>Eftersom RCS kr\u00e4ver att mottagarens enhet och operat\u00f6r har st\u00f6d f\u00f6r tekniken, anv\u00e4nds fallback-logiken f\u00f6r att garantera leverans (exempelvis genom att automatiskt sl\u00e5 om till vanlig SMS-text) om ett RCS-meddelande inte kan levereras. \u00d6versikt: Var finns Fallback-logiken? I API-specifikationen \u00e4r fallback integrerat p\u00e5 tv\u00e5 niv\u00e5er: 1. Konfiguration av Fallback vid s\u00e4ndning (Requests) Fallback-inst\u00e4llningar kan definieras [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[18],"doc_tag":[],"class_list":["post-1212","docs","type-docs","status-publish","hentry","doc_category-introduktion"],"year_month":"2026-09","word_count":464,"total_views":"7","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"patrik bronner","author_nicename":"patrik-bronnerip1-se","author_url":"https:\/\/rcs-api.com\/en\/author\/patrik-bronnerip1-se\/"},"doc_category_info":[{"term_name":"Introduktion","term_url":"https:\/\/rcs-api.com\/en\/dokumentation\/introduktion\/"}],"doc_tag_info":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v28.3 (Yoast SEO v28.3) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>Fallback - RCS-API.com<\/title>\n<meta name=\"description\" content=\"S\u00e4kerst\u00e4ll att dina meddelanden alltid n\u00e5r fram. L\u00e4r dig hur du konfigurerar automatisk fallback till SMS om mottagaren saknar st\u00f6d f\u00f6r RCS.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/rcs-api.com\/en\/documentation\/introduction\/fallback\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Fallback\" \/>\n<meta property=\"og:description\" content=\"S\u00e4kerst\u00e4ll att dina meddelanden alltid n\u00e5r fram. L\u00e4r dig hur du konfigurerar automatisk fallback till SMS om mottagaren saknar st\u00f6d f\u00f6r RCS.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/rcs-api.com\/en\/documentation\/introduction\/fallback\/\" \/>\n<meta property=\"og:site_name\" content=\"RCS-API.com\" \/>\n<meta property=\"article:modified_time\" content=\"2026-09-03T09:13:20+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/rcs-api.com\\\/dokumentation\\\/introduktion\\\/fallback\\\/\",\"url\":\"https:\\\/\\\/rcs-api.com\\\/dokumentation\\\/introduktion\\\/fallback\\\/\",\"name\":\"Fallback - RCS-API.com\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/rcs-api.com\\\/#website\"},\"datePublished\":\"2026-08-25T08:47:04+00:00\",\"dateModified\":\"2026-09-03T09:13:20+00:00\",\"description\":\"S\u00e4kerst\u00e4ll att dina meddelanden alltid n\u00e5r fram. L\u00e4r dig hur du konfigurerar automatisk fallback till SMS om mottagaren saknar st\u00f6d f\u00f6r RCS.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/rcs-api.com\\\/dokumentation\\\/introduktion\\\/fallback\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/rcs-api.com\\\/dokumentation\\\/introduktion\\\/fallback\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/rcs-api.com\\\/dokumentation\\\/introduktion\\\/fallback\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Hem\",\"item\":\"https:\\\/\\\/rcs-api.com\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Dokumentation\",\"item\":\"https:\\\/\\\/rcs-api.com\\\/dokumentation\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Fallback\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/rcs-api.com\\\/#website\",\"url\":\"https:\\\/\\\/rcs-api.com\\\/\",\"name\":\"RCS-API.com\",\"description\":\"Integrera n\u00e4sta generations kommunikation med v\u00e5rt RCS API\",\"publisher\":{\"@id\":\"https:\\\/\\\/rcs-api.com\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/rcs-api.com\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/rcs-api.com\\\/#organization\",\"name\":\"RCS-API.com\",\"url\":\"https:\\\/\\\/rcs-api.com\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/rcs-api.com\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/rcs-api.com\\\/wp-content\\\/uploads\\\/2025\\\/10\\\/ip1-logo-white.svg\",\"contentUrl\":\"https:\\\/\\\/rcs-api.com\\\/wp-content\\\/uploads\\\/2025\\\/10\\\/ip1-logo-white.svg\",\"width\":589,\"height\":292,\"caption\":\"RCS-API.com\"},\"image\":{\"@id\":\"https:\\\/\\\/rcs-api.com\\\/#\\\/schema\\\/logo\\\/image\\\/\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Fallback - RCS-API.com","description":"Ensure that your messages always get through. Learn how to configure automatic fallback to SMS if the recipient lacks support for RCS.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/rcs-api.com\/en\/documentation\/introduction\/fallback\/","og_locale":"en_US","og_type":"article","og_title":"Fallback","og_description":"S\u00e4kerst\u00e4ll att dina meddelanden alltid n\u00e5r fram. L\u00e4r dig hur du konfigurerar automatisk fallback till SMS om mottagaren saknar st\u00f6d f\u00f6r RCS.","og_url":"https:\/\/rcs-api.com\/en\/documentation\/introduction\/fallback\/","og_site_name":"RCS-API.com","article_modified_time":"2026-09-03T09:13:20+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/rcs-api.com\/dokumentation\/introduktion\/fallback\/","url":"https:\/\/rcs-api.com\/dokumentation\/introduktion\/fallback\/","name":"Fallback - RCS-API.com","isPartOf":{"@id":"https:\/\/rcs-api.com\/#website"},"datePublished":"2026-08-25T08:47:04+00:00","dateModified":"2026-09-03T09:13:20+00:00","description":"Ensure that your messages always get through. Learn how to configure automatic fallback to SMS if the recipient lacks support for RCS.","breadcrumb":{"@id":"https:\/\/rcs-api.com\/dokumentation\/introduktion\/fallback\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/rcs-api.com\/dokumentation\/introduktion\/fallback\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/rcs-api.com\/dokumentation\/introduktion\/fallback\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Hem","item":"https:\/\/rcs-api.com\/"},{"@type":"ListItem","position":2,"name":"Dokumentation","item":"https:\/\/rcs-api.com\/dokumentation\/"},{"@type":"ListItem","position":3,"name":"Fallback"}]},{"@type":"WebSite","@id":"https:\/\/rcs-api.com\/#website","url":"https:\/\/rcs-api.com\/","name":"RCS-API.com","description":"Integrate the next generation of communication with our RCS API","publisher":{"@id":"https:\/\/rcs-api.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/rcs-api.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/rcs-api.com\/#organization","name":"RCS-API.com","url":"https:\/\/rcs-api.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/rcs-api.com\/#\/schema\/logo\/image\/","url":"https:\/\/rcs-api.com\/wp-content\/uploads\/2025\/10\/ip1-logo-white.svg","contentUrl":"https:\/\/rcs-api.com\/wp-content\/uploads\/2025\/10\/ip1-logo-white.svg","width":589,"height":292,"caption":"RCS-API.com"},"image":{"@id":"https:\/\/rcs-api.com\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/rcs-api.com\/en\/wp-json\/wp\/v2\/docs\/1212","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rcs-api.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/rcs-api.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/rcs-api.com\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/rcs-api.com\/en\/wp-json\/wp\/v2\/comments?post=1212"}],"version-history":[{"count":4,"href":"https:\/\/rcs-api.com\/en\/wp-json\/wp\/v2\/docs\/1212\/revisions"}],"predecessor-version":[{"id":1260,"href":"https:\/\/rcs-api.com\/en\/wp-json\/wp\/v2\/docs\/1212\/revisions\/1260"}],"wp:attachment":[{"href":"https:\/\/rcs-api.com\/en\/wp-json\/wp\/v2\/media?parent=1212"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/rcs-api.com\/en\/wp-json\/wp\/v2\/doc_category?post=1212"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/rcs-api.com\/en\/wp-json\/wp\/v2\/doc_tag?post=1212"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}