Update opt-out-api-quickstart.md

Author: dbasantes

articles/communication-services/quickstarts/sms/opt-out-api-quickstart.md

@@ -111,245 +111,22 @@ In general, response contents are the same for all actions and contain the succe
     ]
 }
 ```
-## Sample code to use Opt-Out API
+## Next steps
 
-### C#
+In this quickstart, you learned how to send OPt-out requests.
 
-#### Prerequisites
+> [!div class="nextstepaction"]
+> [Send an SMS message](./send.md)
 
-- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
-- The .NET Core SDK version must be higher than v6 for your operating system.
-- An active Communication Services resource and connection string. See [Create a Communication Services resource](https://learn.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
-- An SMS-enabled telephone number. See [Get a phone number](https://learn.microsoft.com/azure/communication-services/quickstarts/telephony/get-phone-number) and `allowlisted` as described in the beginning of the article.
+> [!div class="nextstepaction"]
+> [Receive and reply to SMS](./receive-sms.md)
 
-```cs
-using System.Globalization;
-using System.Security.Cryptography;
-using System.Text;
+> [!div class="nextstepaction"]
+> [Enable SMS analytics](../../concepts/analytics/insights/sms-insights.md)
 
-// Sample for Add action. Replace with Check or Remove as necessary.
-async Task SendOptOutAdd(string acsResourceConnectionString, string payload)
-{
-    const string ApiPrivatePreviewVersion = "2024-12-10-preview";
-
-    const string dateHeader = "x-ms-date";
-
-    string accesskey = GetConnectionStringPart(acsResourceConnectionString, "accesskey");
-    var endpointUri = new Uri(GetConnectionStringPart(acsResourceConnectionString, "endpoint"));
-
-    using var httpClient = new HttpClient();
-    httpClient.BaseAddress = endpointUri;
-
-    string method = "POST";
-    string baseAddress = httpClient.BaseAddress.ToString().TrimEnd('/');
-    var requestUri = new Uri($"{baseAddress}/sms/optouts:add?api-version={ApiPrivatePreviewVersion }", UriKind.RelativeOrAbsolute);
-    string hashedBody = ComputeSha256Hash(payload);
-    string utcNowString = DateTimeOffset.UtcNow.ToString("r", CultureInfo.InvariantCulture);
-    string stringToSign = $"{method}\n{requestUri.PathAndQuery}\n{utcNowString};{requestUri.Host};{hashedBody}";
-    string signature = ComputeHmacSha256Hash(accesskey, stringToSign);
-    string authHeader = $"HMAC-SHA256 SignedHeaders={dateHeader};host;x-ms-content-sha256&Signature={signature}";
-
-    using HttpRequestMessage request = new();
-    request.Headers.TryAddWithoutValidation(dateHeader, utcNowString);
-    request.Headers.TryAddWithoutValidation("x-ms-content-sha256", hashedBody);
-    request.Headers.TryAddWithoutValidation("Authorization", authHeader);
-    request.RequestUri = requestUri;
-    request.Method = new HttpMethod(method);
-    request.Content = new StringContent(payload, Encoding.UTF8, "application/json");
-
-    HttpResponseMessage response = await httpClient.SendAsync(request, HttpCompletionOption.ResponseHeadersRead);
-
-    Console.WriteLine(response.StatusCode);
-    Console.WriteLine(await response.Content.ReadAsStringAsync());
-    Console.WriteLine(response.Headers.ToString());
-}
-
-string ComputeSha256Hash(string rawData)
-{
-    using SHA256 sha256Hash = SHA256.Create();
-    byte[] bytes = sha256Hash.ComputeHash(Encoding.UTF8.GetBytes(rawData));
-    return Convert.ToBase64String(bytes);
-}
-
-string ComputeHmacSha256Hash(string key, string rawData)
-{
-    using HMACSHA256 hmacSha256 = new HMACSHA256(Convert.FromBase64String(key));
-    byte[] bytes = hmacSha256.ComputeHash(Encoding.ASCII.GetBytes(rawData));
-    return Convert.ToBase64String(bytes);
-}
-
-string GetConnectionStringPart(string acsResourceConnectionString, string key)
-{
-    return acsResourceConnectionString.Split($"{key}=").Last().Split(';').First();
-}
-
-// Usage
-
-const string ConnectionString = "endpoint=https://[CONTOSO].communication.azure.com/;accesskey=******";
-var payload = System.Text.Json.JsonSerializer.Serialize(new
-{
-    from = "+15551234567", //replace with your allowed sender number
-    recipients = new[] {
-        new { to = "+15550112233" } //replace with your recipient
-    },
-});
-
-await SendOptOutAdd(ConnectionString, payload);
-
-```
-### JavaScript
-
-#### Prerequisites
-
-- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
-- Browser or Node.js Active LTS and Maintenance LTS versions (8.11.1 and 10.14.1 are recommended).
-- An active Communication Services resource and connection string. See [Create a Communication Services resource](https://learn.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
-- An SMS-enabled telephone number. See [Get a phone number](https://learn.microsoft.com/azure/communication-services/quickstarts/telephony/get-phone-number).
-- [CryptoJS](https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/crypto-js/CryptoJS%20v3.1.2.zip) is JavaScript implementations of standard and secure cryptographic algorithms.
-
-
-```html
-<script src="Scripts/CryptoJS/sha256-min.js" type="text/javascript"></script>
-<script src="Scripts/CryptoJS/hmac-sha256.js" type="text/javascript"></script>
-<script src="Scripts/CryptoJS/enc-base64-min.js" type="text/javascript"></script>
-
-```
+> [!div class="nextstepaction"]
+> [Phone number types](../../concepts/telephony/plan-solution.md)
 
-```js
-const ConnectionString = "endpoint=https://[CONTOSO].communication.azure.com/;accesskey=******";
+> [!div class="nextstepaction"]
+> [Look up operator information for a phone number](../telephony/number-lookup.md)
 
-// Sample for Add action. Replace with Check or Remove as necessary.
-function sendOptOutAdd(acsResourceConnectionString, payload, apiVersion = "2024-12-10-preview")
-{
-    try
-    {
-        var acsRCS = acsResourceConnectionString
-            .split(";")
-            .map(i =>
-            {
-                var p = i.indexOf("=");
-                return [i.substr(0, p), i.substr(p + 1)];
-            })
-            .reduce((a, i) => ({ ...a, [i[0]]: i[1] }), {});
-        var uri = `${trimEnd(acsRCS.endpoint, "/")}/sms/optouts:add?api-version=${apiVersion}`;
-        var url = new URL(uri);
-        var method = "POST";
-        var utcNow = new Date().toUTCString();
-        var bodyJson = JSON.stringify(payload);
-        var hashedBody = CryptoJS.SHA256(bodyJson).toString(CryptoJS.enc.Base64);
-        var stringToSign = `${method}\n${url.pathname}${url.search}\n${utcNow};${url.host};${hashedBody}`;
-        var signature = CryptoJS.HmacSHA256(stringToSign, CryptoJS.enc.Base64.parse(acsRCS.accesskey)).toString(CryptoJS.enc.Base64);
-
-        fetch(uri, {
-            method: method,
-            headers: {
-                "content-type": "application/json",
-                "x-ms-date": utcNow,
-                "x-ms-content-sha256": hashedBody,
-                Authorization: `HMAC-SHA256 SignedHeaders=x-ms-date;host;x-ms-content-sha256&Signature=${signature}`
-            },
-            body: bodyJson
-        })
-        .then(response => response.json())
-        .then(console.warn)
-        .catch(console.error);
-    }
-    catch (ex)
-    {
-        console.error(ex);
-    }
-}
-
-function trimEnd(s, c)
-{
-    while (s.slice(-1) == c)
-        s = s.slice(0, -1);
-    return s;
-}
-
-// Usage
-
-var payload = {
-    from: "+15551234567",
-    recipients: [
-        { to: "+15550112233" }
-    ],
-};
-
-sendOptOutAdd(ConnectionString, payload);
-
-```
-### Java
-
-#### Prerequisites
-
-- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
-- Java Development Kit (JDK) version 8 or above.
-- An active Communication Services resource and connection string. See [Create a Communication Services resource](https://learn.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
-- An SMS-enabled telephone number. See [Get a phone number](https://learn.microsoft.com/azure/communication-services/quickstarts/telephony/get-phone-number).
-
-
-```java
-// Sample for Add action. Replace with Check or Remove as necessary.
-public class App
-{
-    public static void main(String[] args) throws Exception
-    {
-        String connectionString = "endpoint=https://[CONTOSO].communication.azure.com/;accesskey=******";
-
-        OptOutRequest payload = new OptOutRequest();
-        payload.from = "+15551234567";
-        payload.recipients = new ArrayList<Recipient>();
-        payload.recipients.add(new Recipient("+15550112233"));
-
-        SendOptOut(connectionString, payload);
-    }
-
-    public static void SendOptOutAdd(String connectionString, OptOutRequest payload) throws Exception
-    {
-        String apiVersion = "2024-12-10-preview";
-
-        String[] arrOfStr = connectionString.split(";");
-        String endpoint = arrOfStr[0].split("=")[1];
-        String accessKey = arrOfStr[1].split("=")[1];
-        String body = new ObjectMapper().enable(SerializationFeature.INDENT_OUTPUT).writeValueAsString(payload);
-        String dateHeaderName = "x-ms-date";
-        DateTimeFormatter headerDateFormat = DateTimeFormatter.ofPattern("EEE, dd MMM yyyy HH:mm:ss z", Locale.ENGLISH).withZone(ZoneId.of("GMT"));
-        String dateHeader = headerDateFormat.format(Instant.now());
-        String verb = "POST";
-        URI uri = URI.create(endpoint + "sms/optouts:add?api-version==" + apiVersion);
-        String hostName = uri.getHost();
-        String pathAndQuery = uri.getPath() + "?" + uri.getQuery();
-        String encodedHash = Base64.getEncoder().encodeToString(MessageDigest.getInstance("SHA-256").digest(body.getBytes(StandardCharsets.UTF_8)));
-        String stringToSign = verb + '\n' + pathAndQuery + '\n' + dateHeader + ';' + hostName + ';' + encodedHash;
-        Mac mac = Mac.getInstance("HmacSHA256");
-        SecretKeySpec secretKeySpec = new SecretKeySpec(Base64.getDecoder().decode(accessKey.getBytes()), "HmacSHA256"); 
-        mac.init(secretKeySpec);
-        String signature = Base64.getEncoder().encodeToString(mac.doFinal(stringToSign.getBytes()));
-        String authHeader = "HMAC-SHA256 SignedHeaders=" + dateHeaderName + ";host;x-ms-content-sha256&Signature=" + signature;
-
-        HttpClient client = HttpClients.custom().build();
-        HttpUriRequest request = RequestBuilder
-            .post(uri)
-            .setHeader(HttpHeaders.CONTENT_TYPE, "application/json")
-            .setHeader(dateHeaderName, dateHeader)
-            .setHeader("x-ms-content-sha256", encodedHash)
-            .setHeader("Authorization", authHeader)
-            .setEntity(new StringEntity(body, "UTF-8"))
-            .build();
-        HttpResponse r = client.execute(request);
-        HttpEntity entity = r.getEntity();
-    }
-}
-
-public class OptOutRequest
-{
-    public String from;
-    public ArrayList<Recipient> recipients;
-}
-
-public class Recipient
-{
-    public String to;
-}
-```