Merge pull request TwilioDevEd#966 from TwilioDevEd/sdk-samples

new js and ts sdk samples

Author: anabenites

conversations/add-participant/addParticipant.js

@@ -0,0 +1,17 @@
+/* Adding Participants (chat and non-chat) */
+
+// add chat participant to the conversation by its identity
+await conversation.add("identity");
+
+// add a non-chat participant to the conversation
+const proxyAddress = "+11222333";
+const address = "+12345678";
+await conversation.addNonChatParticipant(proxyAddress, address);
+
+// adds yourself as a conversations sdk user to this conversation
+// use after creating the conversation from the SDK
+await conversation.join();
+
+conversation.on("participantJoined", (participant) => {
+    // fired when a participant has joined the conversation
+});

conversations/add-participant/addParticipant.ts

@@ -0,0 +1,18 @@
+/* Adding Participants (chat and non-chat) */
+import {Participant} from "@twilio/conversations";
+
+// add chat participant to the conversation by its identity
+await conversation.add("identity");
+
+// add a non-chat participant to the conversation
+const proxyAddress: string = "+11222333";
+const address: string = "+12345678";
+await conversation.addNonChatParticipant(proxyAddress, address);
+
+// adds yourself as a conversations sdk user to this conversation
+// use after creating the conversation from the SDK
+await conversation.join();
+
+conversation.on("participantJoined", (participant: Participant) => {
+    // fired when a participant has joined the conversation
+});

conversations/attributes/attributes.js

@@ -0,0 +1,24 @@
+/* Using Attributes */
+
+// add attributes to a message
+const message = await conversation.prepareMessage().setBody("message text");
+
+await conversation.setAttributes("attribute");
+await conversation.setAttributes(2);
+await conversation.setAttributes(true);
+await conversation.setAttributes({attributeKey: "attributeValue"});
+await conversation.setAttributes(["attribute", "anotherAttribute"]);
+
+// get the attributes
+const messageAttributes = message.attributes;
+
+// add participant to the conversation with attributes
+await conversation.add("identity", "attribute");
+await conversation.add("identity", 2);
+await conversation.add("identity", true);
+await conversation.add("identity", {attributeKey: "attributeValue"});
+await conversation.add("identity", ["attribute", "anotherAttribute"]);
+
+// get the attributes
+const participant = await conversation.getParticipantByIdentity("identity");
+const participantAttributes = participant.attributes;

conversations/attributes/attributes.ts

@@ -0,0 +1,26 @@
+/* Using Attributes */
+
+import {MessageBuilder, Participant, JSONValue} from "@twilio/conversations";
+
+// add attributes to a message
+const message: MessageBuilder = await conversation.prepareMessage().setBody("message text");
+
+await conversation.setAttributes("attribute");
+await conversation.setAttributes(2);
+await conversation.setAttributes(true);
+await conversation.setAttributes({attributeKey: "attributeValue"});
+await conversation.setAttributes(["attribute", "anotherAttribute"]);
+
+// get the attributes
+const messageAttributes: JSONValue = message.attributes;
+
+// add participant to the conversation with attributes
+await conversation.add("identity", "attribute");
+await conversation.add("identity", 2);
+await conversation.add("identity", true);
+await conversation.add("identity", {attributeKey: "attributeValue"});
+await conversation.add("identity", ["attribute", "anotherAttribute"]);
+
+// get the attributes
+const participant: Participant = await conversation.getParticipantByIdentity("identity");
+const participantAttributes: JSONValue = participant.attributes;

conversations/create-conversation/createConversation.js

@@ -0,0 +1,8 @@
+/* Creating Conversation */
+
+// create new conversation, all the parameters are optional
+await client.createConversation({
+    attributes: {},
+    friendlyName: "new conversation",
+    uniqueName: "new conversation",
+});

conversations/create-conversation/createConversation.ts

@@ -0,0 +1,8 @@
+/* Creating Conversation */
+
+// create new conversation, all the parameters are optional
+await client.createConversation({
+    attributes: {},
+    friendlyName: "new conversation",
+    uniqueName: "new conversation",
+});

conversations/deleting/deleting.js

@@ -0,0 +1,16 @@
+/* Deleting and updating Conversations/Messages/Participants */
+
+/* Conversations */
+
+// destroys the conversation, with all its messages and attached media and removes all participants
+await conversation.delete();
+
+/* Messages */
+
+// remove a message from the conversation, destroying any attached media
+await message.remove();
+
+/* Participants */
+
+// remove participant from the conversation
+await participant.remove();

conversations/deleting/deleting.ts

@@ -0,0 +1,16 @@
+/* Deleting Conversations/Messages/Participants */
+
+/* Conversations */
+
+// destroys the conversation, with all its messages and attached media and removes all participants
+await conversation.delete();
+
+/* Messages */
+
+// remove a message from the conversation, destroying any attached media
+await message.remove();
+
+/* Participants */
+
+// remove participant from the conversation
+await participant.remove();

conversations/delivery-receipt-error/deliveryReceiptError.js

@@ -0,0 +1,29 @@
+/* Checking delivery receipts for errors */
+
+// get the list of aggregated delivery receipts
+const aggregatedDeliveryReceipt = message.aggregatedDeliveryReceipt;
+
+// retrieve delivery receipt status
+if (aggregatedDeliveryReceipt.failed !== "none" || aggregatedDeliveryReceipt.undelivered !== "none") {
+    // handle error
+}
+
+// get the list of delivery receipts
+const detailedDeliveryReceipts = await message.getDetailedDeliveryReceipts();
+
+detailedDeliveryReceipts.map((detailedDeliveryReceipt) => {
+    // check delivery receipt status
+    if (!detailedDeliveryReceipt.status === "undelivered" && !detailedDeliveryReceipt.status === "failed") {
+        return;
+    }
+
+    // handle error. the error codes page: https://www.twilio.com/docs/sms/api/message-resource#delivery-related-errors
+    if (detailedDeliveryReceipt.errorCode === 30006) {
+        alert("The destination number is unable to receive this message.");
+        return;
+    }
+
+    if (detailedDeliveryReceipt.errorCode === 30007) {
+        alert("Your message was flagged as objectionable by the carrier.");
+    }
+});

conversations/delivery-receipt-error/deliveryReceiptError.ts

@@ -0,0 +1,31 @@
+/* Checking delivery receipts for errors */
+
+// get the list of aggregated delivery receipts
+import {AggregatedDeliveryReceipt, DetailedDeliveryReceipt} from "@twilio/conversations";
+
+const aggregatedDeliveryReceipt: AggregatedDeliveryReceipt = message.aggregatedDeliveryReceipt;
+
+// retrieve delivery receipt status
+if (aggregatedDeliveryReceipt.failed !== "none" || aggregatedDeliveryReceipt.undelivered !== "none") {
+    // handle error
+}
+
+// get the list of delivery receipts
+const detailedDeliveryReceipts: DetailedDeliveryReceipt[] = await message.getDetailedDeliveryReceipts();
+
+detailedDeliveryReceipts.map((detailedDeliveryReceipt: DetailedDeliveryReceipt) => {
+    // check delivery receipt status
+    if (!detailedDeliveryReceipt.status === "undelivered" && !detailedDeliveryReceipt.status === "failed") {
+        return;
+    }
+
+    // handle error. the error codes page: https://www.twilio.com/docs/sms/api/message-resource#delivery-related-errors
+    if (detailedDeliveryReceipt.errorCode === 30006) {
+        alert("The destination number is unable to receive this message.");
+        return;
+    }
+
+    if (detailedDeliveryReceipt.errorCode === 30007) {
+        alert("Your message was flagged as objectionable by the carrier.");
+    }
+});