Update docs for broadcasts and messages API endpoints

Author: rowanseymour

temba/api/v2/views.py

@@ -131,6 +131,7 @@ def get_context_data(self, **kwargs):
             LabelsEndpoint.get_write_explorer(),
             LabelsEndpoint.get_delete_explorer(),
             MessagesEndpoint.get_read_explorer(),
+            MessagesEndpoint.get_write_explorer(),
             MessageActionsEndpoint.get_write_explorer(),
             ResthooksEndpoint.get_read_explorer(),
             ResthookEventsEndpoint.get_read_explorer(),
@@ -483,8 +484,14 @@ class BroadcastsEndpoint(ListAPIMixin, WriteAPIMixin, BaseEndpoint):
         {
             "urns": ["tel:+250788123123", "tel:+250788123124"],
             "contacts": ["09d23a05-47fe-11e4-bfe9-b8f6b119e9ab"],
-            "text": {"eng": "Hello @contact.name!", "spa": "Hola @contact.name!"},
-            "quick_replies": {"eng": [{"text": "Hey"}, {"text": "Hello!"}]}
+            "text": {
+                "eng": "Hello @contact.name! Burger or pizza?",
+                "spa": "Hola @contact.name! Hamburguesa o pizza?"
+            },
+            "quick_replies": {
+                "eng": [{"text": "Burger", "extra": "With cheese"}, {"text": "Pizza"}],
+                "spa": [{"text": "Hamburguesa", "extra": "Con queso"}, {"text": "Pizza"}]
+            },
             "base_language": "eng"
         }
 
@@ -495,9 +502,15 @@ class BroadcastsEndpoint(ListAPIMixin, WriteAPIMixin, BaseEndpoint):
             "urns": ["tel:+250788123123", "tel:+250788123124"],
             "contacts": [{"uuid": "09d23a05-47fe-11e4-bfe9-b8f6b119e9ab", "name": "Joe"}]
             "groups": [],
-            "text": {"eng": "Hello @contact.name!", "spa": "Hola @contact.name!"},
+            "text": {
+                "eng": "Hello @contact.name! Burger or pizza?",
+                "spa": "Hola @contact.name! Hamburguesa o pizza?"
+            },
             "attachments": {"eng": [], "spa": []},
-            "quick_replies": {"eng": [{"text": "Hey"}, {"text": "Hello!"}], "spa": []},
+            "quick_replies": {
+                "eng": [{"text": "Burger", "extra": "With cheese"}, {"text": "Pizza"}],
+                "spa": [{"text": "Hamburguesa", "extra": "Con queso"}, {"text": "Pizza"}]
+            },
             "base_language": "eng",
             "created_on": "2013-03-02T17:28:12.123456Z"
         }
@@ -2309,9 +2322,9 @@ class MessagesEndpoint(ListAPIMixin, WriteAPIMixin, BaseEndpoint):
         POST /api/v2/messages.json
         {
             "contact": "d33e9ad5-5c35-414c-abd4-e7451c69ff1d",
-            "text": "Hi Bob",
+            "text": "Burger or pizza?",
             "attachments": [],
-            "quick_repies": [{"text": "Hey"}, {"text": "Hi"}]
+            "quick_repies": [{"text": "Burger", "extra": "With cheese"}, {"text": "Pizza"}]
 
         }
 
@@ -2327,9 +2340,9 @@ class MessagesEndpoint(ListAPIMixin, WriteAPIMixin, BaseEndpoint):
             "type": "text",
             "status": "queued",
             "visibility": "visible",
-            "text": "Hi Bob",
+            "text": "Burger or pizza?",
             "attachments": [],
-            "quick_replies": [{"text": "Hey"}, {"text": "Hi"}],
+            "quick_replies": [{"text": "Burger", "extra": "With cheese"}, {"text": "Pizza"}],
             "labels": [],
             "flow": null,
             "created_on": "2023-01-06T15:33:00.813162Z",
@@ -2471,6 +2484,25 @@ def get_read_explorer(cls):
             "example": {"query": "folder=inbox&after=2014-01-01T00:00:00.000"},
         }
 
+    @classmethod
+    def get_write_explorer(cls):
+        return {
+            "method": "POST",
+            "title": "Send Messages",
+            "url": reverse("api.v2.messages"),
+            "slug": "message-write",
+            "fields": [
+                {"name": "contact", "required": True, "help": "The UUID of the contact"},
+                {"name": "text", "required": False, "help": "The text of the message (string)"},
+                {"name": "attachments", "required": False, "help": "The attachments on the message (array of strings)"},
+                {
+                    "name": "quick_replies",
+                    "required": False,
+                    "help": "The quick replies on the message (array of objects)",
+                },
+            ],
+        }
+
 
 class MessageActionsEndpoint(BulkWriteAPIMixin, BaseEndpoint):
     """