feat: Add Messages failover example (#10)

Author: SMadani

.env-example

@@ -130,6 +130,14 @@ VERIFY_TEMPLATE_NAME="verify"
 VERIFY_TEMPLATE_ID="bcdef09-8765-4321-8cde-0123456789ab"
 VERIFY_TEMPLATE_FRAGMENT_ID="aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab"
 
+# Video
+VIDEO_SESSION_ID="flR1ZSBPY3QgMjkgMTI6MTM6MjMgUERUIDIwMTN"
+VIDEO_TOKEN="eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhcHBsaWNhdGlvbl9pZCI6ImFhYWFhYWFhLWJiYmItNGNjYy04ZGRkLTAxMjM0NTY3ODlhYiJ9.o3U506EejsS8D5Tob90FG1NC1cR69fh3pFOpxnyTHVFfgqI6NWuuN8lEwrS3Zb8bGxE_A9LyyUZ2y4uqLpyXRw"
+VIDEO_CONNECTION_ID="bcdef09-8765-4321-8cde-0123456789ab"
+VIDEO_STREAM_ID="bcdef09-8765-4321-8cde-0123456789ab"
+VIDEO_ARCHIVE_ID="aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab"
+VIDEO_BROADCAST_ID="aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab"
+
 # Voice
 VOICE_CALL_ID="aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab"
 VOICE_TO_NUMBER="447700900000"

SNIPPETS.md

@@ -202,6 +202,24 @@ embeddedServer(Netty, port = 8000) {
 }.start(wait = true)
 ```
 
+### Send Message With Failover
+```kotlin
+val messageId = client.messages.send(
+    rcsText {
+        to(MESSAGES_TO_NUMBER)
+        from(RCS_SENDER_ID)
+        text("This is an RCS text message sent using the Messages API")
+        failover(
+            smsText {
+                to(MESSAGES_TO_NUMBER)
+                from(SMS_SENDER_ID)
+                text("This is an SMS sent using the Vonage Messages API.")
+            }
+        )
+    }
+)
+```
+
 ### RCS
 #### Send RCS Suggested Reply
 ```kotlin

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

src/main/kotlin/com/vonage/quickstart/kt/EnvironmentVariables.kt

@@ -166,6 +166,14 @@ val VERIFY_TEMPLATE_NAME = envVar("VERIFY_TEMPLATE_NAME")
 val VERIFY_TEMPLATE_ID = envVar("VERIFY_TEMPLATE_ID")
 val VERIFY_TEMPLATE_FRAGMENT_ID = envVar("VERIFY_TEMPLATE_FRAGMENT_ID")
 
+// Video
+val VIDEO_SESSION_ID = envVar("VIDEO_SESSION_ID")
+val VIDEO_TOKEN = envVar("VIDEO_TOKEN")
+val VIDEO_CONNECTION_ID = envVar("VIDEO_CONNECTION_ID")
+val VIDEO_STREAM_ID = envVar("VIDEO_STREAM_ID")
+val VIDEO_ARCHIVE_ID = envVar("VIDEO_ARCHIVE_ID")
+val VIDEO_BROADCAST_ID = envVar("VIDEO_BROADCAST_ID")
+
 // Voice
 val VOICE_CALL_ID = envVar("VOICE_CALL_ID")
 val VOICE_TO_NUMBER = envVar("VOICE_TO_NUMBER")

src/main/kotlin/com/vonage/quickstart/kt/messages/SendMessageWithFailover.kt

@@ -0,0 +1,47 @@
+/*
+ * Copyright 2025 Vonage
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+package com.vonage.quickstart.kt.messages
+
+import com.vonage.client.kt.*
+import com.vonage.quickstart.kt.*
+
+fun main() {
+    val client = Vonage {
+        applicationId(VONAGE_APPLICATION_ID)
+        privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+    }
+
+    val messageId = client.messages.send(
+        rcsText {
+            to(MESSAGES_TO_NUMBER)
+            from(RCS_SENDER_ID)
+            text("This is an RCS text message sent using the Messages API")
+            failover(
+                smsText {
+                    to(MESSAGES_TO_NUMBER)
+                    from(SMS_SENDER_ID)
+                    text("This is an SMS sent using the Vonage Messages API.")
+                }
+            )
+        }
+    )
+}