> For the complete documentation index, see [llms.txt](https://tailieu.smax.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tailieu.smax.ai/bot-auto/ham.md).

# Hàm

{% hint style="info" %}
Giải thích chức năng và hướng dẫn sử dụng các hàm trong module Bot - Auto

Bạn có thể gõ ký tự <mark style="color:purple;">**\[**</mark> để hiển thị các hàm
{% endhint %}

Hàm <mark style="color:purple;">**\[=GENDER("anh","chị","bạn")]**</mark> sẽ trả về <mark style="color:purple;">**anh**</mark> nếu giới tính Facebook khách hàng là nam, <mark style="color:purple;">**chị**</mark> nếu giới tính Facebook khách hàng là nữ hoặc <mark style="color:purple;">**bạn**</mark> nếu giới tính Facebook khách hàng không xác định

Bạn có thể thay thế <mark style="color:purple;">**anh**</mark>, <mark style="color:purple;">**chị**</mark>, <mark style="color:purple;">**bạn**</mark> bằng các từ khác như <mark style="color:purple;">**ông**</mark>, <mark style="color:purple;">**bà**</mark>, <mark style="color:purple;">**ông/bà**</mark>

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2Fg635LgBEomuWjXqWWGNW%2Fimage%201.png?alt=media&amp;token=2e1e9757-0401-4fff-a3e6-caffc98c517c" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=UPPER("string")]**</mark> sẽ viết hoa toàn bộ ký tự nằm trong cặp dấu " "

Ví dụ \[=UPPER("xin chào")] = XIN CHÀO

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2Fe15aqU3wydqUpjJSmsM3%2Fimage%201.png?alt=media&amp;token=3469f4f1-d1fe-4df5-b439-877009706957" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=LOWER("string")]**</mark> sẽ viết thường toàn bộ ký tự nằm trong cặp dấu " "

Ví dụ \[=LOWER("XIN CHÀO")] = xin chào

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FdBE4sGaVfpjMOeg5W4dr%2Fimage%201.png?alt=media&amp;token=6f861a9e-7a58-4d39-a3c5-6f71b29313fe" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=PROPER("string")]**</mark> sẽ viết hoa chữ cái đầu của các từ trong cặp dấu " "

Ví dụ \[=PROPER("xin chào")] = Xin Chào

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FIcGhAfR2bgvVwNCvliS8%2Fimage%201.png?alt=media&amp;token=c1911993-e490-44ff-8b7c-e13862bd7e26" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=SEPRATOR(number)]**</mark> sẽ tạo ra các dấu "," để ngăn cách cách chữ số hàng trăm nghìn,...

Ví dụ: \[=SEPRATOR(300000)] = 300,000

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FTnkjEpmBNgLWAMOQkJ1P%2Fimage%201.png?alt=media&amp;token=cd51ffc8-6bf6-4548-9c02-e1307e073aa2" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=TIMENOW({{timezone}},"YYYY-MM-DD HH-mm-ss")]**</mark> sẽ trả về thời gian của thời điểm hiện tại

{{timezone}} là múi giờ mà hàm nhận, mặc định sẽ lấy theo múi giờ của tài khoản Facebook khách hàng. Bạn có thể để mặc định {{timezone}} = 7 để lấy múi giờ Việt Nam

YYYY-MM-DD HH-mm-ss là định dạng thời gian hàm trả về:

* YYYY: Năm
* MM: Tháng
* DD: Ngày
* HH: Giờ
* mm: Phút
* ss: Giây

Bạn có thể để định dạng thời gian bạn muốn tạo, ví dụ DD/MM/YYYY

Ví dụ: \[=TIMENOW(7,"DD/MM/YYYY")] = 01/06/2024

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2F7K5viFU6lU9Jxg1PEBzu%2Fimage%201.png?alt=media&amp;token=838fe9f7-af96-4511-ad1d-03c0daea2928" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=FORMAT\_TIME("{{signed up}}",{{timezone}},"YYYY-MM-DD HH-mm-ss")]**</mark> sẽ định dạng lại giá trị thời gian nhận vào và trả về thời gian theo định dạng bạn muốn

Bạn có thể thay {{signed up}} bằng thuộc tính khác hoặc thời gian muốn định dạng lại, lưu ý thời gian cần định dạng phải đúng định dạng chuẩn giờ UTC

{{timezone}} và định dạng thời gian đầu ra tương tự hàm TIMENOW

Ví dụ: Khách hàng tương tác với trang lần cuối vào lúc 2024-06-06T05:02:27.020Z (giờ UTC), bạn có thể định dạng lại thời gian này theo cách sau:

\[=FORMAT\_TIME("2024-06-06T05:02:27.020Z",7,"DD/MM/YYYY")] = 06/06/2024

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FC52ejWkYgsYLcYtaXQWS%2Fimage%201.png?alt=media&amp;token=7a878aca-3cca-4f3c-9691-3ce86773a6d6" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=MOD(A,B)]**</mark> dùng để lấy số dư của phép chia số A cho số B

Ví dụ:\[=MOD(10,3)] = 1

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2Fcqcsh7W3nKeZXKQeu7l3%2Fimage%201.png?alt=media&amp;token=ce7ca0f0-fdad-4ebd-89f3-64915e3c3464" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=RANDOM(A,B)]**</mark> sẽ trả về ngẫu nhiên 1 trong 2 giá trị A hoặc B

Ví dụ: \[=RANDOM(1,2)] = 1 hoặc 2

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2Fj6fvxXF0XqiJGFwMHYcc%2Fimage%201.png?alt=media&amp;token=7c612943-0ba5-4b4d-88f4-bca42c2607c5" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=RANDOMBETWEEN(1,9)]**</mark> sẽ trả về ngẫu nhiên 1 trong các giá trị từ 1 đến 9

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2F5oWEyygVv9FvRJLweI52%2Fimage%201.png?alt=media&amp;token=055ed253-9fe8-4c19-a50f-4b1a848d63c1" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=LEFT("string",3)]**</mark> sẽ lấy 3 ký tự đầu tiên từ trái của chuỗi nằm trong cặp dấu " "

Ví dụ: \[=LEFT("Xin chào",3)] = Xin

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FnOzTlAhTe4fnNPUYPxbL%2Fimage%201.png?alt=media&amp;token=f40f95f6-9563-437c-819b-9ef71f57a0a1" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=RIGHT("string",3)]**</mark> sẽ trả về 3 ký tự đầu tiên từ phải sang của chuỗi nằm trong cặp dấu " "

Ví dụ: \[=RIGHT("Xin chào",3)] = hào

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FRLi283e7OIvQEuUhzjBf%2Fimage%201.png?alt=media&amp;token=a36bd65a-af3c-4461-9fc8-48ad4aab31e2" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=MID("string",3,2)]**</mark> sẽ lấy ra 2 ký tự tính từ ký tự thứ 3 từ trái sang của chuỗi trong cặp dấu " "

Ví dụ: \[=MID("Chào bạn",3,2)] = ào

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FTL1PuNBlYBzDMJIbwBnT%2Fimage%201.png?alt=media&amp;token=72c00de8-052b-4533-a757-ff7f96fcfad6" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=GET\_NUMBER("string")]**</mark> sẽ lấy ra các ký tự là số trong chuỗi nằm trong cặp dấu " "

Ví dụ: \[=GET\_NUMBER("Xin chào 12 tôi là 345")] = 12345

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FtQFjXOnBMpubDofrflbs%2Fimage%201.png?alt=media&amp;token=a582f987-12d3-4287-8a72-f5970bb1d57b" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=GET\_TEXT("string")]**</mark> sẽ lấy các ký tự là chữ trong chuỗi nằm trong cặp dấu " "

Ví dụ: \[=GET\_TEXT("Xin chào 12 tôi là 345")] = Xin chào tôi là

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2F8PEupousYq3zdnC1aZl5%2Fimage%201.png?alt=media&amp;token=b0ecbe2f-cf3c-4f9c-95fb-54be5d390ce9" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=GET\_PHONE("string")]**</mark> sẽ lấy ra số điện thoại trong chuỗi nằm trong cặp dấu " "

Ví dụ: \[=GET\_PHONE("Số điện thoại của tôi là 0987654321")] = 0987654321

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FWFeQFjfWA2R9QfmL1Ohs%2Fimage%201.png?alt=media&amp;token=bc4fc8d1-c825-4162-9f55-e85ccdba56ed" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=GET\_EMAIL("string")]**</mark> sẽ lấy ra email trong chuỗi nằm trong cặp dấu " "

Ví dụ: \[=GET\_EMAIL("Email của tôi là <myemail@gmail.com>")] = <myemail@gmail.com>

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FPJumXE6Tq1LGrsvRDyaq%2Fimage%201.png?alt=media&amp;token=db769066-ed4f-4992-bcbb-a8c3e28b68b4" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=TRIM("string")]**</mark> sẽ loại bỏ các khoảng trắng thừa ở trong chuỗi nằm trong cặp dấu " "

Ví dụ: \[=TRIM(" xin     chào     bạn ")] = xin chào bạn

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2Fw2kJmp0XHYZWXJ3ED4c1%2Fimage%201.png?alt=media&amp;token=1d0fb628-7b39-4e99-a9eb-4e43516f2b3f" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=LENGTH("string")]**</mark> sẽ trả về số ký tự của chuỗi nằm trong cặp dấu " "

Ví dụ: \[=LENGTH("xin chào bạn")] = 12

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2FcjXMikhYt1dk0bnqanw3%2Fimage%201.png?alt=media&amp;token=d5bdcb7e-1c13-4ec4-b7c1-4f9aec1f6a05" alt=""><figcaption></figcaption></figure>

Hàm <mark style="color:purple;">**\[=MD5("string")]**</mark> sẽ mã hóa MD5 chuỗi nằm trong cặp dấu " "

<figure><img src="https://1875681896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsr3EiPwgSuzEXI3u1tC1%2Fuploads%2F9DM0lpEwmc4nvU37zE73%2Fimage%201.png?alt=media&amp;token=41d4818f-bf82-40cb-8dc4-e8ef264ba2b3" alt=""><figcaption></figcaption></figure>
