> For the complete documentation index, see [llms.txt](https://apidoc.ants.co.th/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.ants.co.th/thai-v1.0.0/api-sms-1/api-sms.md).

# Send Message

    ใช้สำหรับส่ง SMS ในรูปแบบที่หลากหลาย และมีความยืนหยุ่นในการใช้งาน functions ต่าง ๆ เช่น ส่งเลขหมายปลายทางได้หลายเบอร์ ตั้งเวลาการส่งล่วงหน้าได้ การกำหนดระยะเวลาที่จะให้พยายามส่งข้อความ การกำหนด custom bulkId และ messageID เป็นต้น      

### Sequence Diagram

![](/files/-M27YBmjuu2aLSyFPJdX)

{% tabs %}
{% tab title="Request" %}

#### **ผู้ใช้งานสามารถเริ่มสร้าง HTTP ตามรายละเอียดดังนี้**

| **หัวข้อ**          | **รายละเอียด**                                                                                             |
| ------------------- | ---------------------------------------------------------------------------------------------------------- |
| HTTP Request (URL): | <https://api-service.ants.co.th/sms/send>                                                                  |
| HTTP Headers        | <p>Content-Type: application/json</p><p>Authorization: (Basic Auth) Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==</p> |
| HTTP Methods        | POST                                                                                                       |

#### ผู้ใช้งานสามารถระบุ Request body ด้วย Parameter ดังนี้

| **Parameter**                                      | **ประเภท**      | **รายละเอียด**                                                                                                                                                                                                                           |
| -------------------------------------------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>bulkId</p><p><em>(optional)</em></p>            | String (50)     | รหัสของแต่ละ Request ที่ไม่ซ้ำกัน                                                                                                                                                                                                        |
| messages                                           | Array           | ชุดข้อมูลที่ต้องการส่งข้อความ                                                                                                                                                                                                            |
| from                                               | String (11)     | <p>เป็นการกำหนดค่าชื่อผู้ส่ง (Sender Name) <br>สามารถระบุเป็นตัวหนังสือ ตัวเลข หรือตัวเลข<br>ปนตัวหนังสือได้ สูงสุดไม่เกิน 11 ตัวอักษร<br>และไม่สามารถเว้นวรรคได้ เช่น ANTS เป็นต้น</p>                                                  |
| destinations                                       | Array (500)     | <p>ชุดข้อมูลหมายเลขที่ต้องการส่งข้อความ </p><p><em>\*แนะนำ สูงสุด 500 หมายเลย ต่อ 1 bulk request</em></p>                                                                                                                                |
| to                                                 | Strings         | <p>หมายเลขปลายทาง ต้องเป็น international format <br>(ตัวอย่าง: 66639393544)</p>                                                                                                                                                          |
| <p> messageId  </p><p><em>(optional)</em></p>      | String(200)     | เป็นรหัสที่ไม่ซ้ำกันบ่งบอกการส่งของแต่ละข้อความ                                                                                                                                                                                          |
| text                                               | String(1600)    | ข้อความที่ต้องการจะส่งหาหมายเลขผู้รับ                                                                                                                                                                                                    |
| <p>shorturl <br><em>(optional)</em>   </p>         | String (y or n) | กำหนดให้ใช้งานฟังก์ชั่นย่อ URL ในข้อความด้วยค่า "y"                                                                                                                                                                                      |
| <p>notifyUrl</p><p><em>(optional)</em></p>         | String (150)    | <p>ท่านสามารถกำหนด URL บน callback server ที่ต้องการ</p><p>ให้ส่งรายงานผล (Delivery report) โดยสามารถกำหนด API <br>สำหรับรับ Callback ตามลิ้งค์นี้ <a href="/pages/-M1dmGmrI7GQBcR_K6Tn"><em><strong>Send Callback</strong></em></a></p> |
| <p>notifyContentType</p><p><em>(optional)</em></p> | String (50)     | <p>กำหนด content type ของ รายงานผล Delivery </p><p>report เป็น application/json</p>                                                                                                                                                      |
| <p>sendAt</p><p><em>(optional)</em></p>            | DateTime        | <p>วันที่และเวลาที่ต้องการให้ข้อความถูกส่ง สามารถใช้</p><p>สำหรับตั้งเวลาการส่งล่วงหน้า รูปแบบ Date Time </p><p>Format: 01/01/2020 09:00</p>                                                                                             |
| <p>callbackData</p><p><em>(optional)</em></p>      | String (1000)   | ระบุค่าที่ต้องการส่งกลับ เมื่อระบุ notifyUrl จะส่งค่า callbackData นี้กลับไป                                                                                                                                                             |

#### ตัวอย่าง Request JSON

```
{
    "bulkId": "75108ada-ffa3-4577-8ff1-db2a4690ccbd",
    "messages": [
        {
            "from": "ANTS",
            "destinations": [
                {
                    "to": "66123456789",
                    "messageId": "25501288135972440649"
                }
            ],
            "text": "สวัสดี Hello Word",
            "shorturl" : "n",
            "notifyUrl": "https://testSend",
            "notifyContentType": "application/json",
            "sendAt": "01/01/2020 09:00",
            "callbackData":"ANTS Data"
        }
    ]
 }

```

{% endtab %}

{% tab title="Response" %}
**Response ตอบกลับผู้ใช้งาน ดังนี้**

| **ชุดข้อมูลผลลัพธ์** | **ประเภทข้อมูล** | **รายละเอียด**                                |
| -------------------- | ---------------- | --------------------------------------------- |
| bulkId               | String           | รหัสการส่งในแต่ละครั้ง                        |
| detail               | Array            | ชุดค่าการตอบกลับ                              |
| messageId            | String           | รหัสอ้างอิงของแต่ละหมายเลข ในการส่งแต่ละครั้ง |
| to                   | String           | หมายเลขที่ได้รับข้อความ                       |
| from                 | String           | Sender name ที่ส่ง                            |
| credit               | Decimal          | จำนวน credit ที่ใช้                           |
| shorturl             | String           | ใช้งานฟังก์ชั่นย่อ URL ในข้อความ              |
| status               | Object           | ชุดข้อมูลสถานะ                                |
| code                 | String           | รหัสสถานะการตอบกลับ                           |
| name                 | String           | ชื่อสถานะการตอบกลับ                           |
| description          | String           | รายละเอียดสถานะการตอบกลับ                     |

**ตัวอย่าง Response JSON**

```
{
    "bulkid": "75108ada-ffa3-4577-8ff1-db2a4690ccbd",
    "detail": [
        {
            "messageId": "25501288135972440649",
            "to": "66123456789",
            "from": "ANTS",
            "credit": 1.00,
            "shorturl": "N",
            "status": {
                "code": "101",
                "name": "PENDING",
                "description": "Pending -Message has been accepted by the system"
            }
        }
    ]
}

```

{% endtab %}
{% endtabs %}