feat: Add Conversation snippets

Author: SMadani

.env-example

@@ -19,6 +19,16 @@ ACCOUNT_SMS_CALLBACK_URL="https://example.org/webhooks/sms-status"
 # Application
 APPLICATION_NAME="My Test Application"
 
+# Conversation
+CONV_DISPLAY_NAME="Customer Chat"
+CONV_EVENT_ID="23"
+CONV_ID="CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a"
+CONV_MEMBER_ID="MEM-63f61863-4a51-4f6b-86e1-46edebio0391"
+CONV_MEMBER_STATE="invited"
+CONV_NAME="customer_chat"
+CONV_NEW_NAME="support_meeting"
+CONV_NEW_DISPLAY_NAME="Support Meeting"
+
 # Messages
 MESSAGES_TO_NUMBER="447900000001"
 MESSAGES_API_URL="https://api.nexmo.com/v1/messages"

src/main/java/com/vonage/quickstart/EnvironmentVariables.java

@@ -22,6 +22,7 @@
 package com.vonage.quickstart;
 
 import com.vonage.client.ApiRegion;
+import com.vonage.client.conversations.MemberState;
 import com.vonage.client.numbers.Feature;
 import com.vonage.client.numbers.SearchPattern;
 import com.vonage.client.numbers.Type;
@@ -83,6 +84,12 @@ public static String envVar(String key) {
        ACCOUNT_SECRET_ID = envVar("ACCOUNT_SECRET_ID"),
        ACCOUNT_SMS_CALLBACK_URL = envVar("ACCOUNT_SMS_CALLBACK_URL"),
        APPLICATION_NAME = envVar("APPLICATION_NAME"),
+       CONV_DISPLAY_NAME = envVar("CONV_DISPLAY_NAME"),
+       CONV_ID = envVar("CONV_ID"),
+       CONV_MEMBER_ID = envVar("CONV_MEMBER_ID"),
+       CONV_NAME = envVar("CONV_NAME"),
+       CONV_NEW_NAME = envVar("CONV_NEW_NAME"),
+       CONV_NEW_DISPLAY_NAME = envVar("CONV_NEW_DISPLAY_NAME"),
        MESSAGES_TO_NUMBER = envVar("MESSAGES_TO_NUMBER"),
        MESSAGES_MESSAGE_ID = envVar("MESSAGES_MESSAGE_ID"),
        MESSAGES_IMAGE_URL = envVar("MESSAGES_IMAGE_URL"),
@@ -159,6 +166,7 @@ public static String envVar(String key) {
         VONAGE_PRIVATE_KEY_CONTENTS = envVar("VONAGE_PRIVATE_KEY_CONTENTS").getBytes();
 
    public static final int
+       CONV_EVENT_ID = Integer.parseInt(envVar("CONV_EVENT_ID")),
        VIBER_VIDEO_DURATION = Integer.parseInt(envVar("VIBER_VIDEO_DURATION")),
        VIBER_VIDEO_FILE_SIZE = Integer.parseInt(envVar("VIBER_VIDEO_FILE_SIZE")),
        VIBER_VIDEO_TTL = Integer.parseInt(envVar("VIBER_VIDEO_TTL")),
@@ -177,6 +185,9 @@ public static String envVar(String key) {
    public static final Instant
        SUBACCOUNT_START_DATE = Instant.parse(envVar("SUBACCOUNT_START_DATE"));
 
+   public static final MemberState
+       CONV_MEMBER_STATE = MemberState.fromString(envVar("CONV_MEMBER_STATE"));
+
    public static final Type
        NUMBER_TYPE = Type.fromString(envVar("NUMBER_TYPE"));
 

src/main/java/com/vonage/quickstart/conversation/CreateConversation.java

@@ -0,0 +1,43 @@
+/*
+ * 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.conversation;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.conversations.Conversation;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class CreateConversation {
+    public static void main(String[] args) throws Exception {
+        VonageClient client = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build();
+
+        var conversation = client.getConversationsClient().createConversation(
+                Conversation.builder()
+                    .name(CONV_NAME)
+                    .displayName(CONV_DISPLAY_NAME)
+                    .build()
+        );
+        System.out.println(conversation);
+    }
+}

src/main/java/com/vonage/quickstart/conversation/CreateCustomEvent.java

@@ -0,0 +1,44 @@
+/*
+ * 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.conversation;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.conversations.CustomEvent;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+import java.util.Map;
+
+public class CreateCustomEvent {
+    public static void main(String[] args) throws Exception {
+        VonageClient client = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build();
+
+        var event = client.getConversationsClient().createEvent(
+                CONV_ID, CustomEvent.builder()
+                        .from(CONV_MEMBER_ID)
+                        .body(Map.of("your", "data"))
+                        .build()
+        );
+        System.out.println(event);
+    }
+}

src/main/java/com/vonage/quickstart/conversation/CreateEvent.java

@@ -0,0 +1,44 @@
+/*
+ * 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.conversation;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.common.MessageType;
+import com.vonage.client.conversations.MessageEvent;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class CreateEvent {
+    public static void main(String[] args) throws Exception {
+        VonageClient client = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build();
+
+        var event = client.getConversationsClient().createEvent(
+                CONV_ID, MessageEvent.builder(MessageType.TEXT)
+                        .from(CONV_MEMBER_ID)
+                        .text("Hello World!")
+                        .build()
+        );
+        System.out.println(event);
+    }
+}

src/main/java/com/vonage/quickstart/conversation/CreateMember.java

@@ -0,0 +1,45 @@
+/*
+ * 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.conversation;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.common.ChannelType;
+import com.vonage.client.conversations.Member;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class CreateMember {
+    public static void main(String[] args) throws Exception {
+        VonageClient client = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build();
+
+        var member = client.getConversationsClient().createMember(
+                CONV_ID, Member.builder()
+                        .channelType(ChannelType.APP)
+                        .state(CONV_MEMBER_STATE)
+                        .user(USER_ID)
+                        .build()
+        );
+        System.out.println(member);
+    }
+}

src/main/java/com/vonage/quickstart/conversation/DeleteConversation.java

@@ -0,0 +1,36 @@
+/*
+ * 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.conversation;
+
+import com.vonage.client.VonageClient;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class DeleteConversation {
+    public static void main(String[] args) throws Exception {
+        VonageClient client = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build();
+
+        client.getConversationsClient().deleteConversation(CONV_ID);
+    }
+}

src/main/java/com/vonage/quickstart/conversation/DeleteEvent.java

@@ -0,0 +1,36 @@
+/*
+ * 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.conversation;
+
+import com.vonage.client.VonageClient;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class DeleteEvent {
+    public static void main(String[] args) throws Exception {
+        VonageClient client = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build();
+
+        client.getConversationsClient().deleteEvent(CONV_ID, CONV_EVENT_ID);
+    }
+}

src/main/java/com/vonage/quickstart/conversation/GetConversation.java

@@ -0,0 +1,37 @@
+/*
+ * 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.conversation;
+
+import com.vonage.client.VonageClient;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class GetConversation {
+    public static void main(String[] args) throws Exception {
+        VonageClient client = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build();
+
+        var conversation = client.getConversationsClient().getConversation(CONV_ID);
+        System.out.println(conversation);
+    }
+}

src/main/java/com/vonage/quickstart/conversation/GetEvent.java

@@ -0,0 +1,37 @@
+/*
+ * 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.conversation;
+
+import com.vonage.client.VonageClient;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class GetEvent {
+    public static void main(String[] args) throws Exception {
+        VonageClient client = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build();
+
+        var event = client.getConversationsClient().getEvent(CONV_ID, CONV_EVENT_ID);
+        System.out.println(event);
+    }
+}