Pull request #40: Add remaining Messaging actions

jmartinez-telesign · jmartinez-telesign · commit fd6db1bb6558 · 2026-03-13T15:13:19.000Z
Merge in SDK/java_telesign_enterprise from feature/EOA8407 to developer

Squashed commit of the following:

commit f84d7ad1a9beddddc98d61ed777a8ea9e968aa95
Author: Juan Camilo Martinez &lt;jmartinez@telesign.com&gt;
Date:   Thu Mar 12 09:11:59 2026 -0500

    Add remaining Messaging actions
diff --git a/RELEASE.md b/RELEASE.md
@@ -1,3 +1,6 @@
+4.1.0
+- Add remaining Messaging actions.
+
 4.0.1
 - Fix endpoint for making requests in ScoreClient
 
diff --git a/build.gradle b/build.gradle
@@ -7,7 +7,7 @@ plugins {
 }
 
 group = 'com.telesign.enterprise'
-version = '4.0.1'
+version = '4.1.0'
 
 sourceCompatibility = JavaVersion.VERSION_1_8
 targetCompatibility = JavaVersion.VERSION_1_8
@@ -120,7 +120,7 @@ publishing {
 
             groupId = 'com.telesign.enterprise'
             artifactId = 'telesignenterprise'
-            version = '4.0.1'
+            version = '4.1.0'
 
             pom {
                 name = 'TeleSign Enterprise SDK'
diff --git a/src/main/java/com/telesign/enterprise/MessagingClient.java b/src/main/java/com/telesign/enterprise/MessagingClient.java
@@ -4,10 +4,13 @@
 import java.net.Proxy;
 import java.security.GeneralSecurityException;
 import java.util.Map;
+import java.util.HashMap;
 
 public class MessagingClient extends com.telesign.MessagingClient {
 
     private static final String OMNI_MESSAGING_RESOURCE = "/v1/omnichannel";
+    private static final String TEMPLATES_RESOURCE = OMNI_MESSAGING_RESOURCE + "/templates";
+    private static final String CAPABILITY_RESOURCE = "/capability";
     private static final String SDK_VERSION = MessagingClient.class.getPackage().getImplementationVersion();
     private static final String SDK_SOURCE = "java_telesign_enterprise";
     private static final String SDK_VERSION_DEPENDENCY = com.telesign.RestClient.class.getPackage().getImplementationVersion();
@@ -43,4 +46,94 @@ public MessagingClient(String customerId,
     public TelesignResponse omniMessage(Map<String, Object> params) throws IOException, GeneralSecurityException {
         return this.post(OMNI_MESSAGING_RESOURCE, params, JSON_CONTENT_TYPE);
     }
+
+    /**
+     * Use this action to check capability of a phone number to use the specified channel.
+     * <p>
+     * See https://developer.telesign.com/enterprise/reference/checkphonenumberchannelcapability for detailed API documentation.
+     * </p>
+     */
+    public TelesignResponse checkChannelCapability(String channel, String phoneNumber) throws IOException, GeneralSecurityException {
+        return this.get(CAPABILITY_RESOURCE + "/"+ channel +"/"+ phoneNumber, new HashMap<>());
+    }
+
+    /**
+     * Use this action to check capability of a phone number to receive messages from the specified RBM agent.
+     * <p>
+     * See https://developer.telesign.com/enterprise/reference/checkphonenumberrbmcapability for detailed API documentation.
+     * </p>
+     */
+    public TelesignResponse checkCapabilityRBMAgent(String phoneNumber, String agentId) throws IOException, GeneralSecurityException {
+        return this.get(CAPABILITY_RESOURCE + "/rcs/" + phoneNumber + "/" + agentId, new HashMap<>());
+    }
+
+    /**
+     *
+     * Get delivery status and other details for a Telesign Messaging transaction that you have created.
+     * Get transaction status can be used for all Messaging API transactions.
+     * Also use this endpoint to complete verification, if Telesign generated your code.
+     * <p>
+     * See https://developer.telesign.com/enterprise/reference/getmessagingstatus for detailed API documentation.
+     * </p>
+     */
+    public TelesignResponse getMsgStatus(String referenceId) throws IOException, GeneralSecurityException {
+        return getMsgStatus(referenceId, null);
+    }
+
+
+    public TelesignResponse getMsgStatus(String referenceId, String verifyCode) throws IOException, GeneralSecurityException {
+        StringBuilder url = new StringBuilder(OMNI_MESSAGING_RESOURCE).append("/").append(referenceId);
+
+        if (verifyCode != null && !verifyCode.trim().isEmpty()) {
+            url.append("?verify_code=").append(verifyCode);
+        }
+        return this.get(url.toString(), new HashMap<>());
+    }
+
+    /**
+     *
+     * Use this action to create a Telesign Messaging template.
+     * <p>
+     * See https://developer.telesign.com/enterprise/reference/createmsgtemplate for detailed API documentation.
+     * </p>
+     */
+    public TelesignResponse createMsgTemplate(Map<String, Object> params) throws IOException, GeneralSecurityException {
+        return this.post(TEMPLATES_RESOURCE, params, JSON_CONTENT_TYPE);
+    }
+
+    /**
+     *
+     * Use this action to get details for the specified Telesign Messaging template.
+     *
+     * <p>
+     * See https://developer.telesign.com/enterprise/reference/getmsgtemplate for detailed API documentation.
+     * </p>
+     */
+    public TelesignResponse getMsgTemplate(String channel, String templateName) throws IOException, GeneralSecurityException {
+        return this.get(TEMPLATES_RESOURCE + "/" + channel + "/" + templateName, new HashMap<>());
+    }
+
+    /**
+     *
+     * Use this action to get details for all Telesign Messaging templates associated with this Customer ID.
+     *
+     * <p>
+     * See https://developer.telesign.com/enterprise/reference/getallmsgtemplates for detailed API documentation.
+     * </p>
+     */
+    public TelesignResponse getAllMsgTemplates() throws IOException, GeneralSecurityException {
+        return this.get(TEMPLATES_RESOURCE, new HashMap<>());
+    }
+
+    /**
+     *
+     * Use this action to delete a Telesign Messaging template.
+     *
+     * <p>
+     * See https://developer.telesign.com/enterprise/reference/deletemsgtemplate for detailed API documentation.
+     * </p>
+     */
+    public TelesignResponse deleteMsgTemplate(String channel, String templateName) throws IOException, GeneralSecurityException {
+        return this.delete(TEMPLATES_RESOURCE + "/" + channel + "/" + templateName, new HashMap<>());
+    }
 }
diff --git a/src/test/java/com/telesign/enterprise/MessagingClientTest.java b/src/test/java/com/telesign/enterprise/MessagingClientTest.java
@@ -8,6 +8,8 @@
 import java.text.SimpleDateFormat;
 import java.util.ArrayList;
 import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
 import java.util.concurrent.TimeUnit;
 
 public class MessagingClientTest extends TestCase {
@@ -16,6 +18,7 @@ public class MessagingClientTest extends TestCase {
 
     private String customerId;
     private String apiKey;
+    private String phoneNumber;
 
     private SimpleDateFormat rfc2616 = new SimpleDateFormat("EEE, dd MMM yyyy HH:mm:ss 'GMT'");
 
@@ -25,13 +28,17 @@ public void setUp() throws Exception {
 
         this.customerId = System.getenv("CUSTOMER_ID");
         this.apiKey = System.getenv("API_KEY");
+        this.phoneNumber = System.getenv("PHONE_NUMBER");
 
         if (this.customerId == null) {
             this.customerId = "FFFFFFFF-EEEE-DDDD-1234-AB1234567890";
         }
         if (this.apiKey == null) {
             this.apiKey = "EXAMPLE----TE8sTgg45yusumoN6BYsBVkh+yRJ5czgsnCehZaOYldPJdmFh6NeX8kunZ2zU1YWaUw/0wV6xfw==";
         }
+        if (this.phoneNumber == null) {
+            this.phoneNumber = "11234567890";
+        }
 
         mockServer = new MockWebServer();
         mockServer.start();
@@ -222,6 +229,207 @@ public void testMessagingStatus() throws Exception {
                 request.getHeader("x-ts-auth-method"));
     }
 
+    public void testCheckChannelCapability() throws Exception {
+
+        this.mockServer.enqueue(new MockResponse().setBody("{}"));
+
+        MessagingClient client = new MessagingClient(this.customerId,
+                this.apiKey,
+                this.mockServer.url("").toString().replaceAll("/$", ""));
+
+        String channel = "rcs";
+        client.checkChannelCapability(channel, phoneNumber);
+
+        RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
+
+        assertEquals("method is not as expected", "GET", request.getMethod());
+        assertEquals("path is not as expected", "/capability/" + channel + "/" + this.phoneNumber, request.getPath());
+        assertEquals("body is not as expected", "", request.getBody().readUtf8());
+        assertEquals("Content-Type header is not as expected", "",
+                request.getHeader("Content-Type"));
+        assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
+                request.getHeader("x-ts-auth-method"));
+    }
+
+    public void testCheckCapabilityRBMAgent() throws Exception {
+
+        this.mockServer.enqueue(new MockResponse().setBody("{}"));
+
+        MessagingClient client = new MessagingClient(this.customerId,
+                this.apiKey,
+                this.mockServer.url("").toString().replaceAll("/$", ""));
+
+        client.checkCapabilityRBMAgent(phoneNumber, "my_rbm_id");
+
+        RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
+
+        assertEquals("method is not as expected", "GET", request.getMethod());
+        assertEquals("path is not as expected", "/capability/rcs/" + this.phoneNumber + "/my_rbm_id", request.getPath());
+        assertEquals("body is not as expected", "", request.getBody().readUtf8());
+        assertEquals("Content-Type header is not as expected", "",
+                request.getHeader("Content-Type"));
+        assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
+                request.getHeader("x-ts-auth-method"));
+    }
+
+
+    public void testGetMsgStatus() throws Exception {
+
+        this.mockServer.enqueue(new MockResponse().setBody("{}"));
+
+        MessagingClient client = new MessagingClient(this.customerId,
+                this.apiKey,
+                this.mockServer.url("").toString().replaceAll("/$", ""));
+
+        String referenceId = "FakeReferenceId";
+        String verifyCode = "123456";
+
+        client.getMsgStatus(referenceId, verifyCode);
+
+        RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
+
+        assertEquals("method is not as expected", "GET", request.getMethod());
+        assertEquals("path is not as expected", "/v1/omnichannel/" + referenceId + "?verify_code=" + verifyCode, request.getPath());
+        assertEquals("body is not as expected", "", request.getBody().readUtf8());
+        assertEquals("Content-Type header is not as expected", "",
+                request.getHeader("Content-Type"));
+        assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
+                request.getHeader("x-ts-auth-method"));
+    }
+
+    public void testGetMsgStatusWithoutVerifyCode() throws Exception {
+
+        this.mockServer.enqueue(new MockResponse().setBody("{}"));
+
+        MessagingClient client = new MessagingClient(this.customerId,
+                this.apiKey,
+                this.mockServer.url("").toString().replaceAll("/$", ""));
+
+        String referenceId = "FakeReferenceId";
+
+        client.getMsgStatus(referenceId);
+
+        RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
+
+        assertEquals("method is not as expected", "GET", request.getMethod());
+        assertEquals("path is not as expected", "/v1/omnichannel/" + referenceId, request.getPath());
+        assertEquals("body is not as expected", "", request.getBody().readUtf8());
+        assertEquals("Content-Type header is not as expected", "",
+                request.getHeader("Content-Type"));
+        assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
+                request.getHeader("x-ts-auth-method"));
+    }
+
+    public void testCreateMsgTemplate() throws Exception {
+
+        this.mockServer.enqueue(new MockResponse().setBody("{}"));
+
+        MessagingClient client = new MessagingClient(this.customerId,
+                this.apiKey,
+                this.mockServer.url("").toString().replaceAll("/$", ""));
+
+        Map<String, Object> params = new HashMap<>();
+
+        params.put("type", "standard");
+        params.put("channel", "whatsapp");
+        params.put("name", "wa_bogo");
+
+        // body map
+        Map<String, Object> body = new HashMap<>();
+        body.put("type", "text");
+        body.put("text", "Buy one get one free!");
+
+        // content item
+        Map<String, Object> contentItem = new HashMap<>();
+        contentItem.put("body", body);
+
+        // content list
+        List<Map<String, Object>> content = new ArrayList<>();
+        content.add(contentItem);
+
+        params.put("content", content);
+
+        client.createMsgTemplate(params);
+
+        RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
+
+        assertEquals("method is not as expected", "POST", request.getMethod());
+        assertEquals("path is not as expected", "/v1/omnichannel/templates", request.getPath());
+        assertEquals("body is not as expected", "{\"channel\":\"whatsapp\",\"name\":\"wa_bogo\",\"type\":\"standard\",\"content\":[{\"body\":{\"text\":\"Buy one get one free!\",\"type\":\"text\"}}]}", request.getBody().readUtf8());
+        assertEquals("Content-Type header is not as expected", "application/json",
+                request.getHeader("Content-Type"));
+        assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
+                request.getHeader("x-ts-auth-method"));
+    }
+
+    public void testGetMsgTemplate() throws Exception {
+
+        this.mockServer.enqueue(new MockResponse().setBody("{}"));
+
+        MessagingClient client = new MessagingClient(this.customerId,
+                this.apiKey,
+                this.mockServer.url("").toString().replaceAll("/$", ""));
+
+        String channel = "whatsapp";
+        String templateName = "wa_bogo";
+
+        client.getMsgTemplate(channel, templateName);
+
+        RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
+
+        assertEquals("method is not as expected", "GET", request.getMethod());
+        assertEquals("path is not as expected", "/v1/omnichannel/templates/" + channel + "/" + templateName, request.getPath());
+        assertEquals("body is not as expected", "", request.getBody().readUtf8());
+        assertEquals("Content-Type header is not as expected", "",
+                request.getHeader("Content-Type"));
+        assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
+                request.getHeader("x-ts-auth-method"));
+    }
+
+    public void testGetAllMsgTemplates() throws Exception {
+
+        this.mockServer.enqueue(new MockResponse().setBody("{}"));
+
+        MessagingClient client = new MessagingClient(this.customerId,
+                this.apiKey,
+                this.mockServer.url("").toString().replaceAll("/$", ""));
+
+        client.getAllMsgTemplates();
+
+        RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
+
+        assertEquals("method is not as expected", "GET", request.getMethod());
+        assertEquals("path is not as expected", "/v1/omnichannel/templates", request.getPath());
+        assertEquals("body is not as expected", "", request.getBody().readUtf8());
+        assertEquals("Content-Type header is not as expected", "",
+                request.getHeader("Content-Type"));
+        assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
+                request.getHeader("x-ts-auth-method"));
+    }
+
+    public void testDeleteMsgTemplate() throws Exception {
+
+        this.mockServer.enqueue(new MockResponse().setBody("{}"));
+
+        MessagingClient client = new MessagingClient(this.customerId,
+                this.apiKey,
+                this.mockServer.url("").toString().replaceAll("/$", ""));
+
+        String channel = "whatsapp";
+        String templateName = "wa_bogo";
+
+        client.deleteMsgTemplate(channel, templateName);
+
+        RecordedRequest request = this.mockServer.takeRequest(1, TimeUnit.SECONDS);
+
+        assertEquals("method is not as expected", "DELETE", request.getMethod());
+        assertEquals("path is not as expected", "/v1/omnichannel/templates/" + channel + "/" + templateName, request.getPath());
+        assertEquals("body is not as expected", "", request.getBody().readUtf8());
+        assertEquals("Content-Type header is not as expected", "",
+                request.getHeader("Content-Type"));
+        assertEquals("x-ts-auth-method header is not as expected", "HMAC-SHA256",
+                request.getHeader("x-ts-auth-method"));
+    }
 
 }
 

-Original file line number
+Diff line change
@@ @@ -1,3 +1,6 @@ @@
 +4.1.0
 +- Add remaining Messaging actions.
++
 .0.1
 - Fix endpoint for making requests in ScoreClient