# Gửi ZNS với Journey Token

{% hint style="info" %}
**Lưu ý:**

* Đối với các API sử dụng cho Shop thì API\_KEY: [`<api_key>`](https://docs.etelecom.vn/tich-hop-api/shop/tai-khoan#api-key). Thông tin base\_url của [Shop](https://docs.etelecom.vn/tich-hop-api/shop/tai-khoan)
* Đối với các API sử dụng cho Partner thì API\_KEY: [`<shop_key>`](https://docs.etelecom.vn/tich-hop-api/partner/su-dung#ket-noi-lan-thu-hai-tro-di). Thông tin base\_url của [Partner](https://docs.etelecom.vn/tich-hop-api/partner/tai-khoan)
{% endhint %}

{% openapi src="https://4211996220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9CUTEBoYNqJaZqxNp3Eh%2Fuploads%2FQdxUagmnrlFy7IeBcsdK%2Fswagger_partner_v2.json?alt=media&token=720b0ab3-a689-4ac8-ab28-08fcb133bf2e" path="$BASE_URL.Zalo/SendZNSJourney" method="post" %}
[swagger_partner_v2.json](https://4211996220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9CUTEBoYNqJaZqxNp3Eh%2Fuploads%2FQdxUagmnrlFy7IeBcsdK%2Fswagger_partner_v2.json?alt=media&token=720b0ab3-a689-4ac8-ab28-08fcb133bf2e)
{% endopenapi %}

**Request:**

```json
curl --location '$BASE_URL.Zalo/SendZNSJourney' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
  "journey_id": "<int64>",
  "oa_id": "<int64>",
  "phone": "<string>",
  "template_data": {
    "property1": "string",
    "property2": "string"
  },
  "template_id": "<int>",
  "tracking_id": "<string>"
}'
```

**Response:**

```json
{
    "created_at": "<dateTime>",
    "delivery_time": "<dateTime>",
    "id": "<int64>",
    "is_charged": "<boolean>",
    "journey_id": "<string>",
    "msg_id": "<string>",
    "msg_type": "journey",
    "phone": "<string>",
    "price": "<integer>",
    "sent_time": "<dateTime>",
    "template_id": "<integer>",
    "timeout": "<integer>",
    "tracking_id": "<string>",
    "updated_at": "<dateTime>"
}
```

**Cấu trúc body của request**

<table><thead><tr><th width="162.33333333333331">Tham số</th><th width="193">Kiểu dữ liệu</th><th>Mô tả</th></tr></thead><tbody><tr><td>oa_id</td><td>int64</td><td>ID của OA</td></tr><tr><td>journey_id</td><td>int64</td><td>ID journey token</td></tr><tr><td>template_id</td><td>int</td><td>ID của mẫu tin</td></tr><tr><td>phone</td><td>string</td><td>Số điện thoại người nhận</td></tr><tr><td>template_data</td><td>object</td><td><p>Các thuộc tính của mẫu tin mà bạn đã đăng ký với Zalo</p><p>Lưu ý: Cấu trúc template_data được quy định riêng ứng với từng mẫu tin</p></td></tr><tr><td>tracking_id</td><td>string</td><td>Mã số đánh dấu lần gọi API của bạn, do bạn định nghĩa. Bạn có thể dùng tracking_id để đối soát mà không phụ thuộc vào message_id của eTelecom cung cấp.</td></tr></tbody></table>

**Cấu trúc thuộc tính dữ liệu trả về**

<table><thead><tr><th width="162.33333333333331">Tham số</th><th width="201">Kiểu dữ liệu</th><th>Mô tả</th></tr></thead><tbody><tr><td>id</td><td>int64</td><td>ID tin nhắn trên hệ thống của eTelecom</td></tr><tr><td>shop_id</td><td>int64</td><td>ID cửa hàng trên hệ thống của eTelecom</td></tr><tr><td>user_id</td><td>int64</td><td>ID người gửi tin trên hệ thống của eTelecom</td></tr><tr><td>campaign_id</td><td>int64</td><td>ID của chiến dịch</td></tr><tr><td>delivery_status</td><td>string</td><td><p><mark style="color:red;"><strong><code>Unkown</code></strong></mark>: Không xác định</p><p><mark style="color:red;"><strong><code>Received</code></strong></mark>: Đã nhận <br><mark style="color:red;"><strong><code>Seen</code></strong></mark>: Đã xem </p></td></tr><tr><td>delivery_time</td><td>string&#x3C;date-time></td><td>Thời gian thiết bị của người dùng nhận được thông báo ZNS</td></tr><tr><td>error_code</td><td>int</td><td>Mã lỗi</td></tr><tr><td>error_message</td><td>string</td><td>Thông báo lỗi</td></tr><tr><td>fee_main</td><td>int</td><td>Phí chính</td></tr><tr><td>fee_token</td><td>int</td><td>Phí khởi tạo token</td></tr><tr><td>is_charged</td><td>boolean</td><td><p><mark style="color:red;"><strong><code>True</code></strong></mark>: Tin ZNS được tính phí</p><p><mark style="color:red;"><strong><code>False</code></strong></mark>: Tin ZNS không được tính phí</p></td></tr><tr><td>journey_id</td><td>string</td><td>ID của journey</td></tr><tr><td>msg_id</td><td>string</td><td>ID của thông báo ZNS</td></tr><tr><td>type</td><td>string</td><td><p><mark style="color:red;"><strong><code>template</code></strong></mark>: ZNS thường</p><p><mark style="color:red;"><strong><code>journey</code></strong></mark>: ZNS  journey</p></td></tr><tr><td>status</td><td>string</td><td>Trạng thái<br><mark style="color:red;"><strong><code>Z</code></strong></mark>: Mới tạo<br><mark style="color:red;"><strong><code>P</code></strong></mark>: Enable<br><mark style="color:red;"><strong><code>N</code></strong></mark>: Disable</td></tr><tr><td>template_data</td><td>object</td><td>Tham số tin nhắn</td></tr><tr><td>phone</td><td>string</td><td>Số điện thoại người nhận</td></tr><tr><td>sent_time</td><td>string&#x3C;date-time></td><td>Thời gian gửi thông báo ZNS</td></tr><tr><td>template_id</td><td>integer</td><td>ID của mẫu tin</td></tr><tr><td>timeout</td><td>integer</td><td>Thời gian tối đa mà hệ thống xử lý yêu cầu</td></tr><tr><td>tracking_id</td><td>string</td><td>Mã số đánh dấu lần gọi API của bạn, do bạn định nghĩa. Bạn có thể dùng tracking_id để đối soát mà không phụ thuộc vào message_id của eTelecom cung cấp.</td></tr><tr><td>updated_at</td><td>string&#x3C;date-time></td><td>Ngày cập nhật</td></tr><tr><td>created_at</td><td>string&#x3C;date-time></td><td>Ngày tạo</td></tr></tbody></table>
