{ "info": { "_postman_id": "47503739-11eb-4bd1-af97-ec79acb40c44", "name": "LetsBot API Documentation", "description": "\"\"\n\n# **Welcome to the LetsBot API**\n\nWant to take your business messaging to the next level? With LetsBot API, you can take advantage of the world's most popular messaging platform and create powerful applications that help you enhance customer service & communication needs. Get up and running quickly with our tutorials, reference guides and examples and start building amazing solutions today. Unlock the potential of WhatsApp Business with LetsBot API and get ready for a whole new world of business opportunities!\n\nWhatsApp has completely changed the communication landscape - it's used by an astounding 2 billion people, with 60 billion messages flying around each day! Companies also recognize this as a secure and reliable way to quickly deliver notifications and provide exceptional customer service.\n\nIncredibly easy to use and integrate, the RESTful API of this tool opens up a world of opportunities. You can now connect it to various third-party systems, programming languages, CMS, CRMs & CLI tools.\n\nYou don't need to hassle with SDKs or complex software dependencies - you can use the API right away with ease by sending HTTPS requests to the relevant endpoint.\n\n> #### [Note](https://letsbot.stoplight.io/#note)\n> \n> To access our API, you will need a LetsBot account. Already have an account? [Log in](https://letsbot.net/) now. Otherwise, create your account quickly and easily with only a few clicks - [Create an Account](https://letsbot.net/).\n\n**Send your first message today! 😍**\n\n> This guide is being regularly updated, so check back often! If you need more help or spot any mistakes while developing an application, feel free to reach out and we'll be happy to provide assistance.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "6750751" }, "item": [ { "name": "Messages", "item": [ { "name": "Media", "item": [ { "name": "send file message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/f8eb54b3-30c9-43da-a3bd-2f551c55c114.pdf", "description": "url for target file you need to send", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/file", "host": [ "{{base_url}}" ], "path": [ "send", "file" ] }, "description": "You can send file message to phone number. You just send the **URL** of the message you want to send. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **documentMessage** that contain file info (URL, mimetype of the file, file length, etc.) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "9665xxxxxxxx", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/f8eb54b3-30c9-43da-a3bd-2f551c55c114.pdf", "description": "url for target file you need to send", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/file", "host": [ "{{base_url}}" ], "path": [ "send", "file" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:14:02 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:14:02 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/f8eb54b3-30c9-43da-a3bd-2f551c55c114.pdf", "description": "url for target file you need to send", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/send/file", "host": [ "{{base_url}}" ], "path": [ "send", "file" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:13:48 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:13:48 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send Image message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://letsbot.net/resources/Gallery/221595264200_servers.png", "description": "url for image ", "type": "text" }, { "key": "caption", "value": "test send image", "description": "this caption on image", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/image", "host": [ "{{base_url}}" ], "path": [ "send", "image" ] }, "description": "You can send Image message to phone number. You just send the **URL** of the message you want to send. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **imageMessage** that contain image info (URL, mimetype of the image, caption of the message and more info) , messageTimesamp format and status of the message" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "9665xxxxxxxx", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://letsbot.net/resources/Gallery/221595264200_servers.png", "description": "url for image ", "type": "text" }, { "key": "caption", "value": "test send image", "description": "this caption on image", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/image", "host": [ "{{base_url}}" ], "path": [ "send", "image" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:56:36 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:56:36 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://letsbot.net/resources/Gallery/221595264200_servers.png", "description": "url for image ", "type": "text" }, { "key": "caption", "value": "test send image", "description": "this caption on image", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/send/image", "host": [ "{{base_url}}" ], "path": [ "send", "image" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:56:21 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:56:21 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send video message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/dc6a152f-1b27-4171-bf38-9c1e75c2fc34.mp4", "description": "url for target video you need send", "type": "text" }, { "key": "caption", "value": "test send video caption", "description": "caption on this video", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/video", "host": [ "{{base_url}}" ], "path": [ "send", "video" ] }, "description": "You can send Video message to phone number. You just send the **URL** of the message you want to send. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **videoMessage** that contain video info (URL, mimetype of the video, caption of the message and more info) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "9665xxxxxxxx", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/dc6a152f-1b27-4171-bf38-9c1e75c2fc34.mp4", "description": "url for target video you need send", "type": "text" }, { "key": "caption", "value": "test send video caption", "description": "caption on this video", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/video", "host": [ "{{base_url}}" ], "path": [ "send", "video" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:08:26 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:08:26 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/dc6a152f-1b27-4171-bf38-9c1e75c2fc34.mp4", "description": "url for target video you need send", "type": "text", "disabled": true }, { "key": "caption", "value": "test send video caption", "description": "caption on this video", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/video", "host": [ "{{base_url}}" ], "path": [ "send", "video" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:08:47 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:08:47 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send gif message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://c.tenor.com/Iqv4_poJZOYAAAAj/kju-online.gif", "description": "url for target video you need send", "type": "text" }, { "key": "caption", "value": "This is GIF", "description": "caption of gif", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/gif", "host": [ "{{base_url}}" ], "path": [ "send", "gif" ] }, "description": "You can send gif message to phone number. You just send the **URL** of the message you want to send. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **videoMessage** that contain gif info (URL, mimetype of the video, caption of the message and more info) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "9665xxxxxxxx", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://c.tenor.com/Iqv4_poJZOYAAAAj/kju-online.gif", "description": "url for target video you need send", "type": "text" }, { "key": "caption", "value": "This is GIF", "description": "caption of gif", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/gif", "host": [ "{{base_url}}" ], "path": [ "send", "gif" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:11:00 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:11:00 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://c.tenor.com/Iqv4_poJZOYAAAAj/kju-online.gif", "description": "url for target video you need send", "type": "text", "disabled": true }, { "key": "caption", "value": "This is GIF", "description": "caption of gif", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/gif", "host": [ "{{base_url}}" ], "path": [ "send", "gif" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:10:42 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:10:42 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send audio message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "audio", "value": "https://letsbot.net/public/swiftly.mp3", "description": "url for audio file you need to send", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/audio", "host": [ "{{base_url}}" ], "path": [ "send", "audio" ] }, "description": "You can send audio message to phone number. You just send the **URL** of the message you want to send. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **videoMessage** that contain audio info (URL, mimetype of the file, file length, seconds, etc.) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "9665xxxxxxxx", "description": "phone number with country code", "type": "text" }, { "key": "audio", "value": "https://letsbot.net/public/swiftly.mp3", "description": "url for audio file you need to send", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/audio", "host": [ "{{base_url}}" ], "path": [ "send", "audio" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:17:09 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:17:08 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "audio", "value": "https://letsbot.net/public/swiftly.mp3", "description": "url for audio file you need to send", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/send/audio", "host": [ "{{base_url}}" ], "path": [ "send", "audio" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:19:58 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:19:58 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send location message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "lat", "value": "30.0594885", "description": "value of Latitude", "type": "text" }, { "key": "lng", "value": "31.2584644", "description": "value of longitude", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/location", "host": [ "{{base_url}}" ], "path": [ "send", "location" ] }, "description": "You can send location message to phone number. You just send the **lat&lng** of location you want to send. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **locationMessage** that contain location info (degreesLatitude, degreesLongitude) , messageTimesamp format and status of the message. " }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "lat", "value": "30.0594885", "description": "value of Latitude", "type": "text" }, { "key": "lng", "value": "31.2584644", "description": "value of longitude", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/location", "host": [ "{{base_url}}" ], "path": [ "send", "location" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 14:35:54 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 14:35:53 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [ { "key": "CHANNELID", "value": "{{CHANNELID}}", "type": "text" }, { "key": "CHANNELTOKEN", "value": "{{CHANNELTOKEN}}", "type": "text" } ], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "lat", "value": "30.0594885", "description": "value of Latitude", "type": "text", "disabled": true }, { "key": "lng", "value": "31.2584644", "description": "value of longitude", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/send/location", "host": [ "{{base_url}}" ], "path": [ "send", "location" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 14:36:18 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 14:36:18 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send ptt (push to talk) message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://letsbot.net/public/swiftly.mp3", "description": "ppt Url", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/ptt", "host": [ "{{base_url}}" ], "path": [ "send", "ptt" ] }, "description": "You can send ppt audio message to phone number. You need to send the **URL** of the file. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **audioMessage** that contain audio info (url, mimetype, ppt, mediaKeyTimestamp, etc) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone2}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://letsbot.net/public/swiftly.mp3", "description": "ppt Url", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/ptt", "host": [ "{{base_url}}" ], "path": [ "send", "ptt" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 14:51:13 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 14:51:13 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send contact", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "contact", "value": "{{phone}}", "description": "the phone number of the contact", "type": "text" }, { "key": "name", "value": "Contact Name", "description": "name for contact will send", "type": "text" }, { "key": "description", "value": "Contact info", "description": "//optional , description of the contact", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/contact", "host": [ "{{base_url}}" ], "path": [ "send", "contact" ] }, "description": "You can send contact message to phone number. You just send the **Contact phone** number, the **name** of the contact and **description** (Optional). **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **contactMessage** that contain Contact info (displyName, vcard) , messageTimesamp format and status of the message. " }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "contact", "value": "{{phone}}", "description": "the phone number of the contact", "type": "text" }, { "key": "name", "value": "Eng Mahmoud", "description": "name for contact will send", "type": "text" }, { "key": "description", "value": "Contact info", "description": "//optional , description of the contact", "type": "text" } ] }, "url": { "raw": "{{base_url}}/send/contact", "host": [ "{{base_url}}" ], "path": [ "send", "contact" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:24:57 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:24:57 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "contact", "value": "{{phone}}", "description": "the phone number of the contact", "type": "text", "disabled": true }, { "key": "name", "value": "Eng Mahmoud", "description": "name for contact will send", "type": "text", "disabled": true }, { "key": "description", "value": "Contact info", "description": "//optional , description of the contact", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/send/contact", "host": [ "{{base_url}}" ], "path": [ "send", "contact" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:25:16 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 12:25:16 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send buttons (alias of /button)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/send/buttons", "host": [ "{{base_url}}" ], "path": [ "send", "buttons" ] }, "description": "Send a message with reply buttons. Same behaviour as `POST /button`.\n\n**Required:** `phone`, `body`, `title`, `footer`, `buttons` (array of buttons, each with `id` and `title`).\n\n**Channels:** official WhatsApp Cloud API and QR channels.", "body": { "mode": "raw", "raw": "{\n \"phone\": \"{{phone}}\",\n \"title\": \"Order #1024\",\n \"body\": \"Do you want to confirm your order?\",\n \"footer\": \"LetsBot\",\n \"buttons\": [\n {\n \"id\": \"confirm\",\n \"title\": \"Confirm\"\n },\n {\n \"id\": \"cancel\",\n \"title\": \"Cancel\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Message", "item": [ { "name": "send text message", "protocolProfileBehavior": { "disabledSystemHeaders": {} }, "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "السلام عليكم", "description": "the text message you want to send", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send", "host": [ "{{base_url}}" ], "path": [ "message", "send" ] }, "description": "You can send message text to phone number. The **Message Id is the id of key of data. remoteJid** is the whatsapp phone account. **text of extendedTextMessage** is the body of the message that sent. **messageTimestamp** is the date of the message in timestamp format." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "test", "description": "the text message you want to send", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send", "host": [ "{{base_url}}" ], "path": [ "message", "send" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:24:34 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:24:34 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "test", "description": "the text message you want to send", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/message/send", "host": [ "{{base_url}}" ], "path": [ "message", "send" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:31:56 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:31:56 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send sticker", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://img-11.stickers.cloud/packs/add9862f-fa7a-424d-91f9-8e5a1ee7b3f3/webp/6706af79-d59a-42b5-b01c-8af9b0191bcf.webp", "description": "Sticker Url", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/sticker", "host": [ "{{base_url}}" ], "path": [ "message", "send", "sticker" ] }, "description": "You can send sticker message to phone number. You need to send the **URL** of the sticker. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **stickerMessage** that contain Sticker info (url, mimetype, mediaKey, mediaKeyTimestamp, etc) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://img-11.stickers.cloud/packs/add9862f-fa7a-424d-91f9-8e5a1ee7b3f3/webp/6706af79-d59a-42b5-b01c-8af9b0191bcf.webp", "description": "Sticker Url", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/sticker", "host": [ "{{base_url}}" ], "path": [ "message", "send", "sticker" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 17:16:18 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 17:16:18 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "url", "value": "https://img-11.stickers.cloud/packs/add9862f-fa7a-424d-91f9-8e5a1ee7b3f3/webp/6706af79-d59a-42b5-b01c-8af9b0191bcf.webp", "description": "Sticker Url", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/message/send/sticker", "host": [ "{{base_url}}" ], "path": [ "message", "send", "sticker" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 17:18:03 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 17:18:03 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send reaction", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "reaction", "value": "❤️", "type": "text" }, { "key": "messageId", "value": "BAE5F2C25476F607", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/reaction", "host": [ "{{base_url}}" ], "path": [ "message", "send", "reaction" ] }, "description": "You can send sticker message to phone number. You need to send the **URL** of the sticker. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **reactionMessage** that contain Reaction info (reaction id, remoteJid, senderTimestampMs) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "reaction", "value": "❤️", "type": "text" }, { "key": "messageId", "value": "{{messageId}}", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/reaction", "host": [ "{{base_url}}" ], "path": [ "message", "send", "reaction" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 17:18:42 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 17:18:42 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "56" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/reaction", "host": [ "{{base_url}}" ], "path": [ "message", "send", "reaction" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 13:54:07 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 13:54:07 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send reply", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال رد", "description": "Content Of message", "type": "text" }, { "key": "messageId", "value": "BAE5F2C25476F607", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/reply", "host": [ "{{base_url}}" ], "path": [ "message", "send", "reply" ] }, "description": "You can send reply on message to phone number. You need to send the body of the message and the message Id that you want to reply on it. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **extended TextMessage** that contain Message reply info (text, contextInfo) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال رد", "description": "Content Of message", "type": "text" }, { "key": "messageId", "value": "{{messageId}}", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/reply", "host": [ "{{base_url}}" ], "path": [ "message", "send", "reply" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:15:50 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:15:50 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال رد", "description": "Content Of message", "type": "text" }, { "key": "messageId", "value": "{{messageId}}", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/message/send/reply", "host": [ "{{base_url}}" ], "path": [ "message", "send", "reply" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:15:18 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:15:18 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send mention", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" }, { "key": "mention", "value": "{{phone}}", "description": "The phone of person that will be mentioned ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/mention", "host": [ "{{base_url}}" ], "path": [ "message", "send", "mention" ] }, "description": "You can send mention on message to phone number or GroupId. You need to send mention phone number. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **extended TextMessage** that contain Message mention info (mentionedJid, text) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" }, { "key": "mention", "value": "{{phone}}", "description": "The phone of person that will be mentioned ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/mention", "host": [ "{{base_url}}" ], "path": [ "message", "send", "mention" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:25:45 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:25:45 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "56" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "mention", "value": "{{phone}}", "description": "The phone of person that will be mentioned ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/mention", "host": [ "{{base_url}}" ], "path": [ "message", "send", "mention" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 14:10:24 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 14:10:24 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send disappearing message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "This is a disappearing message that will disappear after X duration", "description": "Content of message", "type": "text" }, { "key": "duration", "value": "60", "description": "//(Optional)Message disappear after duration time in seconds. Default (7 days)", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/disappearing", "host": [ "{{base_url}}" ], "path": [ "message", "send", "disappearing" ] }, "description": "You can send disappearing message to phone number. You need to send body of the message and the duration of the message**(optional)** to hide after amount of time **in seconds**. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **extendedTextMessage** in message of ephemeralMessage that contain Message info (text, expiration time in seconds) , messageTimesamp format and status of the message. " }, "response": [ { "name": "Success Reponse", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "This is a disappearing message that will disappear after X duration", "description": "Content of message", "type": "text" }, { "key": "duration", "value": "60", "description": "//(Optional)Message disappear after duration time in seconds. Default (7 days)", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/disappearing", "host": [ "{{base_url}}" ], "path": [ "message", "send", "disappearing" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:31:39 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:31:39 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone2}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/send/disappearing", "host": [ "{{base_url}}" ], "path": [ "message", "send", "disappearing" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 14:21:40 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 14:21:39 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send share catalog message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "catalog", "value": "{{phone}}", "description": "Catalog share phone number", "type": "text" }, { "key": "title", "value": "This is title of catalog", "description": "//optional", "type": "text" }, { "key": "body", "value": "This is body of catalog", "description": "//optional", "type": "text" }, { "key": "description", "value": "This is desc of catalog", "description": "//optional", "type": "text" } ] }, "url": { "raw": "{{base_url}}/share/catalog", "host": [ "{{base_url}}" ], "path": [ "share", "catalog" ] }, "description": "You can share catalog message to phone number. You need to the catalog phone number to be share and you can add more additional details(optional) like title, body, and description. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **extendedTextMessage** that contain Message info (text, description, title, image if exist) , messageTimesamp format and status of the message. " }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "catalog", "value": "{{phone}}", "description": "Catalog share phone number", "type": "text" }, { "key": "title", "value": "This is title of catalog", "description": "//optional", "type": "text" }, { "key": "body", "value": "This is body of catalog", "description": "//optional", "type": "text" }, { "key": "description", "value": "This is desc of catalog", "description": "//optional", "type": "text" } ] }, "url": { "raw": "{{base_url}}/share/catalog", "host": [ "{{base_url}}" ], "path": [ "share", "catalog" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:42:15 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:42:15 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Message", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/share/catalog", "host": [ "{{base_url}}" ], "path": [ "share", "catalog" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 14:30:14 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 14:30:14 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "get message by Id", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/message/id?phone={{phone}}&messageID=BAE5690364E55771", "host": [ "{{base_url}}" ], "path": [ "message", "id" ], "query": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code" }, { "key": "messageID", "value": "BAE5690364E55771", "description": "Message Id " } ] }, "description": "Get message content info with message id in phone chat number. In the data of the response , **The body of the data response** is the message content**. The chatName** is the phone number that receive this message. messageType is the type of the message that sent. **remoteJid** is the phone whatsapp account. **Time** is the time of the message in timestamp format. **TimeFormatted** is the time of the message in Format _ Dayname, Daynumber MonthName Year Hours:Min:Sec ZoneType_. There are different types of response depend on the message type. You can see **Examples** of the response in different types below the request." }, "response": [ { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/id?phone={{phone}}&messageID=BAE5690364E55771", "host": [ "{{base_url}}" ], "path": [ "message", "id" ], "query": [ { "key": "phone", "value": "{{phone}}" }, { "key": "messageID", "value": "BAE5690364E55771" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 14:12:49 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 14:12:49 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Success Response (Text)", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "messageID", "value": "{{messageId}}", "description": "Message Id ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/id?phone={{phone}}&messageID=BAE5690364E55771", "host": [ "{{base_url}}" ], "path": [ "message", "id" ], "query": [ { "key": "phone", "value": "{{phone}}" }, { "key": "messageID", "value": "BAE5690364E55771" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:32:53 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:32:53 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Image Message Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "messageID", "value": "{{messageImageId}}", "description": "Message Id ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/id?phone={{phone}}&messageID=BAE5690364E55771", "host": [ "{{base_url}}" ], "path": [ "message", "id" ], "query": [ { "key": "phone", "value": "{{phone}}" }, { "key": "messageID", "value": "BAE5690364E55771" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:39:09 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:39:09 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Video Message Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "messageID", "value": "{{messageVideoId}}", "description": "Message Id ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/id?phone={{phone}}&messageID=BAE5690364E55771", "host": [ "{{base_url}}" ], "path": [ "message", "id" ], "query": [ { "key": "phone", "value": "{{phone}}" }, { "key": "messageID", "value": "BAE5690364E55771" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:40:48 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:40:48 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "File Message Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "messageID", "value": "{{messageFileid}}", "description": "Message Id ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/id?phone={{phone}}&messageID=BAE5690364E55771", "host": [ "{{base_url}}" ], "path": [ "message", "id" ], "query": [ { "key": "phone", "value": "{{phone}}" }, { "key": "messageID", "value": "BAE5690364E55771" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:42:25 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:42:25 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "GIF Message Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "messageID", "value": "{{messaageGifid}}", "description": "Message Id ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/id?phone={{phone}}&messageID=BAE5690364E55771", "host": [ "{{base_url}}" ], "path": [ "message", "id" ], "query": [ { "key": "phone", "value": "{{phone}}" }, { "key": "messageID", "value": "BAE5690364E55771" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:43:29 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:43:29 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Audio Message Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "messageID", "value": "{{messageAudioid}}", "description": "Message Id ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/id?phone={{phone}}&messageID=BAE5690364E55771", "host": [ "{{base_url}}" ], "path": [ "message", "id" ], "query": [ { "key": "phone", "value": "{{phone}}" }, { "key": "messageID", "value": "BAE5690364E55771" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:45:48 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:45:48 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Button Text Message Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "messageID", "value": "{{messageButtonTextid}}", "description": "Message Id ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/id?phone={{phone}}&messageID=BAE5690364E55771", "host": [ "{{base_url}}" ], "path": [ "message", "id" ], "query": [ { "key": "phone", "value": "{{phone}}" }, { "key": "messageID", "value": "BAE5690364E55771" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:47:57 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 11:47:57 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "Fetch messages", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "limit", "value": "5", "description": "//optional by defualt 25", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/message/fetch", "host": [ "{{base_url}}" ], "path": [ "message", "fetch" ] }, "description": "Get Group Meta info of the group. ID, Subject, Subject Owner, Subject Time, Size, Creation Time, Owner Phone, Description, Description Id, Restrict, Announce And Participants Phones" }, "response": [ { "name": "Fetch Messages", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/message/fetch", "host": [ "{{base_url}}" ], "path": [ "message", "fetch" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Mon, 27 Feb 2023 08:49:32 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "delete message by Id", "request": { "method": "DELETE", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "messageID", "value": "BAE509D204172AC0", "description": "Message Id ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/delete?phone={{phone}}&messageID=BAE509D204172AC0", "host": [ "{{base_url}}" ], "path": [ "message", "delete" ], "query": [ { "key": "phone", "value": "{{phone}}" }, { "key": "messageID", "value": "BAE509D204172AC0" } ] }, "description": "You can delete message for phone number. You need to send the message id. **Id of the message** in the key of the data of the response. In the data of the response you can see many options of the message (id, body, messageType, fileName if exist, author, chatName, time in timestamp format, status, etc)." }, "response": [ { "name": "Delete Message by Id", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "messageID", "value": "BAE519A31994E64E", "description": "Message Id ", "type": "text" } ] }, "url": { "raw": "{{base_url}}/message/delete?phone={{phone}}&messageID=BAE509D204172AC0", "host": [ "{{base_url}}" ], "path": [ "message", "delete" ], "query": [ { "key": "phone", "value": "{{phone}}" }, { "key": "messageID", "value": "BAE509D204172AC0" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Tue, 21 Feb 2023 14:56:11 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "forward message", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/message/send/forward/message", "host": [ "{{base_url}}" ], "path": [ "message", "send", "forward", "message" ] }, "description": "Forward a stored message to another phone number.\n\n**Required:** `phone` (recipient), `messageId` (the WhatsApp message id of a message stored in your inbox).\n\n**Channels:** QR (WhatsApp Web) channels only. On official WhatsApp Cloud API channels this request is not supported.", "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "type": "text", "description": "Recipient phone number" }, { "key": "messageId", "value": "3EB0C4F1A2B3D4E5F6", "type": "text", "description": "WhatsApp id of the stored message to forward" } ] } }, "response": [] } ] }, { "name": "Buttons", "item": [ { "name": "send buttons message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "test title", "description": "//optional title for message", "type": "text" }, { "key": "body", "value": "Content Of the Message", "description": "body for message", "type": "text" }, { "key": "footer", "value": "Footer of the button", "description": "//optional footer for message", "type": "text" }, { "key": "buttons[0][id]", "value": "1", "description": "details for buttons", "type": "text" }, { "key": "buttons[0][title]", "value": "button type 1", "description": "title of the button", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.net", "type": "text" }, { "key": "buttons[1][id]", "value": "2", "type": "text", "disabled": true }, { "key": "buttons[1][title]", "value": "button type 2", "type": "text", "disabled": true }, { "key": "buttons[1][type]", "value": "2", "type": "text", "disabled": true }, { "key": "buttons[1][extra_data]", "value": "+9665xxxxxxxx", "type": "text", "disabled": true }, { "key": "buttons[2][id]", "value": "2", "type": "text", "disabled": true }, { "key": "buttons[2][title]", "value": "button type 3", "type": "text", "disabled": true }, { "key": "buttons[2][type]", "value": "3", "type": "text", "disabled": true }, { "key": "buttons[2][extra_data]", "value": "id-like-buttons-message", "type": "text", "disabled": true }, { "key": "caption", "value": "test caption", "description": "optional", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button", "host": [ "{{base_url}}" ], "path": [ "button" ] }, "description": "You can send buttons message to phone number. You need to send the **tilte(optional), body, footer(optional), caption(optional) and buttons** of the message. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **buttonsMessage** that contain buttons info (contentText, footerText, buttons, etc) , messageTimesamp format and status of the message. " }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "test title", "description": "//optional title for message", "type": "text" }, { "key": "body", "value": "عرض حصري :fire: دبلناها وتستاهلون أكثر🫶 الباقة صارت باقتين مع الاشتراكات السنوية:star-struck::partying_face: تواصل بذكاء مع عملائك و اجعل منشأتك تنبض بالحياة:seedling:", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لاتفوت العرض", "description": "//optional footer for message", "type": "text" }, { "key": "buttons[0][id]", "value": "1", "description": "details for buttons", "type": "text" }, { "key": "buttons[0][title]", "value": "test1", "description": "title of the button", "type": "text" }, { "key": "buttons[1][id]", "value": "2", "type": "text" }, { "key": "buttons[1][title]", "value": "test 2", "type": "text" }, { "key": "caption", "value": "this is caption", "description": "//optional", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button", "host": [ "{{base_url}}" ], "path": [ "button" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:46:34 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:46:34 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "test title", "description": "//optional title for message", "type": "text" }, { "key": "body", "value": "عرض حصري :fire: دبلناها وتستاهلون أكثر🫶 الباقة صارت باقتين مع الاشتراكات السنوية:star-struck::partying_face: تواصل بذكاء مع عملائك و اجعل منشأتك تنبض بالحياة:seedling:", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لاتفوت العرض", "description": "//optional footer for message", "type": "text" }, { "key": "buttons[0][id]", "value": "1", "description": "details for buttons", "type": "text", "disabled": true }, { "key": "buttons[0][title]", "value": "test1", "description": "title of the button", "type": "text", "disabled": true }, { "key": "buttons[1][id]", "value": "2", "type": "text", "disabled": true }, { "key": "buttons[1][title]", "value": "test 2", "type": "text", "disabled": true }, { "key": "caption", "value": "this is caption", "description": "//optional", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button", "host": [ "{{base_url}}" ], "path": [ "button" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 14:49:00 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 14:49:00 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send button with image message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "Image caption", "description": "caption for image", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" }, { "key": "image", "value": "https://letsbot.net/resources/Gallery/221595264200_servers.png", "description": "Images URL", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/image", "host": [ "{{base_url}}" ], "path": [ "button", "image" ] }, "description": "You can send buttons with image message to phone number. You need to send the  **caption, footer(optional), images(array) and buttons(array)** of the message. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **buttonsMessage** that contain buttons info (imageMessage info, contenText, footerText, buttons, etc) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "Image caption", "description": "caption for image", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" }, { "key": "image[0]", "value": "https://letsbot.net/resources/Gallery/221595264200_servers.png", "description": "Images URL", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/image", "host": [ "{{base_url}}" ], "path": [ "button", "image" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:52:31 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:52:31 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "Image caption", "description": "caption for image", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" }, { "key": "image[0]", "value": "https://letsbot.net/resources/Gallery/221595264200_servers.png", "description": "Images URL", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/button/image", "host": [ "{{base_url}}" ], "path": [ "button", "image" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:53:59 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:53:59 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send buttons with video message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "video caption", "description": "caption for video", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "video", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/dc6a152f-1b27-4171-bf38-9c1e75c2fc34.mp4'", "description": "Videos URL", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/video", "host": [ "{{base_url}}" ], "path": [ "button", "video" ] }, "description": "You can send buttons with video message to phone number. You need to send the **caption, footer(optional), video(array) and buttons(array)** of the message. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **buttonsMessage** that contain buttons info (videoMessage info, contenText, footerText, buttons, etc) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "video caption", "description": "caption for video", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" }, { "key": "video[0]", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/dc6a152f-1b27-4171-bf38-9c1e75c2fc34.mp4'", "description": "Videos URL", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/video", "host": [ "{{base_url}}" ], "path": [ "button", "video" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:55:38 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:55:38 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Message", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "video caption", "description": "caption for video", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" }, { "key": "video", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/dc6a152f-1b27-4171-bf38-9c1e75c2fc34.mp4'", "description": "Videos URL", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/video", "host": [ "{{base_url}}" ], "path": [ "button", "video" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Mon, 05 Dec 2022 16:18:34 GMT" }, { "key": "Date", "value": "Mon, 05 Dec 2022 16:18:34 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send buttons with location message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "location scaption", "description": "caption for location", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "lat", "value": "21", "description": "Latitude Location", "type": "text" }, { "key": "lng", "value": "23", "description": "Longtiude Location", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/location", "host": [ "{{base_url}}" ], "path": [ "button", "location" ] }, "description": "You can send buttons with location message to phone number. You need to send the **caption, footer(optional), lat, lng and buttons(array)** of the message. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **buttonsMessage** that contain buttons info (locationMessage info, contenText, footerText, buttons, etc) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "location scaption", "description": "caption for location", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" }, { "key": "lat", "value": "21", "description": "Latitude Location", "type": "text" }, { "key": "lng", "value": "23", "description": "Longtiude Location", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/location", "host": [ "{{base_url}}" ], "path": [ "button", "location" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:56:45 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 18:56:45 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "location scaption", "description": "caption for location", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/location", "host": [ "{{base_url}}" ], "path": [ "button", "location" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Mon, 05 Dec 2022 16:24:52 GMT" }, { "key": "Date", "value": "Mon, 05 Dec 2022 16:24:52 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send buttons with document message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "This is Document", "description": "caption for document", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "document", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/f8eb54b3-30c9-43da-a3bd-2f551c55c114.pdf", "description": "Documents url", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/document", "host": [ "{{base_url}}" ], "path": [ "button", "document" ] }, "description": "You can send message templates via whatsapp with this api" }, "response": [ { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "This is Document", "description": "caption for document", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" }, { "key": "document", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/f8eb54b3-30c9-43da-a3bd-2f551c55c114.pdf", "description": "Documents url", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/document", "host": [ "{{base_url}}" ], "path": [ "button", "document" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Mon, 05 Dec 2022 16:05:25 GMT" }, { "key": "Date", "value": "Mon, 05 Dec 2022 16:05:25 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "success response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "caption", "value": "This is Document", "description": "caption for document", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "document", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/f8eb54b3-30c9-43da-a3bd-2f551c55c114.pdf", "description": "Documents url", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/document", "host": [ "{{base_url}}" ], "path": [ "button", "document" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Tue, 28 Feb 2023 10:13:09 GMT" }, { "key": "Server", "value": "Apache" }, { "key": "Access-Control-Allow-Origin", "value": "*" }, { "key": "Access-Control-Allow-Methods", "value": "*" }, { "key": "Access-Control-Allow-Headers", "value": "*" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Set-Cookie", "value": "oats_loob_go_session=MtbfaKBpTQsUd6cz6ZKPWqPYl6wYLo1Si0CIY99A; expires=Tue, 28 Feb 2023 12:13:09 GMT; Max-Age=7200; path=/; httponly; samesite=lax" }, { "key": "Vary", "value": "Authorization" }, { "key": "Connection", "value": "close" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "send carousel (Messenger / Instagram)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/carousel", "host": [ "{{base_url}}" ], "path": [ "carousel" ] }, "description": "Send a card carousel to a Facebook Messenger or Instagram conversation.\n\n**Required:** `recipient` (the Messenger PSID or Instagram IGSID), `cards` (1–10 cards, each with a `title`).\n\n**Optional:** `platform` (`messenger` default, or `instagram`); per card `subtitle`, `image_url`, `url` and up to 3 `buttons`.\n\n**Channels:** Messenger and Instagram channels only; not WhatsApp.", "body": { "mode": "raw", "raw": "{\n \"recipient\": \"1234567890123456\",\n \"platform\": \"messenger\",\n \"cards\": [\n {\n \"title\": \"Epoxy kit 5 kg\",\n \"subtitle\": \"Clear, UV resistant\",\n \"image_url\": \"https://example.com/kit-5.jpg\",\n \"url\": \"https://example.com/kit-5\"\n },\n {\n \"title\": \"Epoxy kit 20 kg\",\n \"subtitle\": \"Best value\",\n \"image_url\": \"https://example.com/kit-20.jpg\",\n \"url\": \"https://example.com/kit-20\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [] } ] }, { "name": "Buttons Templates", "item": [ { "name": "send buttons template message", "protocolProfileBehavior": { "disabledSystemHeaders": {} }, "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "hello title", "description": "title for message", "type": "text" }, { "key": "body", "value": "hello body", "description": "body for message", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "type": "text" }, { "key": "buttons[0][title]", "value": ":star:Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "description": "1,2,3", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.com", "description": "link,number,btn id", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/template", "host": [ "{{base_url}}" ], "path": [ "button", "template" ] }, "description": "You can send buttons _**Template**_ message to phone number. You need to send the **title(optional), footer(optional), body and buttons(array , exp format in body)** of the message. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **templateMessage** that contain buttons info (hydratedButtons, displayText, url index, etc) , messageTimesamp format and status of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "hello title", "description": "title for message", "type": "text" }, { "key": "body", "value": "hello body", "description": "body for message", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "type": "text" }, { "key": "buttons[0][title]", "value": ":star:Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/template", "host": [ "{{base_url}}" ], "path": [ "button", "template" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 31 Dec 2022 13:53:48 GMT" }, { "key": "Date", "value": "Sat, 31 Dec 2022 13:53:48 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send buttons template with image message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "This is title", "description": "//optional", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال ازرار تفاعلية", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لا تفوت العرض", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" }, { "key": "image", "value": "https://letsbot.net/resources/Gallery/221595264200_servers.png", "description": "Image URL", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/image/template", "host": [ "{{base_url}}" ], "path": [ "button", "image", "template" ] }, "description": "You can send buttons _**Template**_ **with image** message to phone number. You need to send the **title(optional), footer(optional), body and buttons(array , exp format in body)** of the message. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **templateMessage** that contain buttons info (hydratedButtons, displayText, url index, etc) , messageTimesamp format and status of the message." }, "response": [ { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "hello title", "description": "title for message", "type": "text" }, { "key": "body", "value": "hello body", "description": "body for message", "type": "text" }, { "key": "footer", "value": "test footer", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/image/template", "host": [ "{{base_url}}" ], "path": [ "button", "image", "template" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 11:27:46 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 11:27:46 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "success response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "This is title", "description": "//optional", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال ازرار تفاعلية", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لا تفوت العرض", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" }, { "key": "image", "value": "https://letsbot.net/resources/Gallery/221595264200_servers.png", "description": "Image URL", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/image/template", "host": [ "{{base_url}}" ], "path": [ "button", "image", "template" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Mon, 27 Feb 2023 13:22:58 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "send buttons template with document message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "title", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال ازرار تفاعلية", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لا تفوت العرض", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "buttons[1][id]", "value": "5", "type": "text" }, { "key": "buttons[1][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[1][type]", "value": "1", "type": "text" }, { "key": "buttons[1][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "document", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/f8eb54b3-30c9-43da-a3bd-2f551c55c114.pdf", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/document/template", "host": [ "{{base_url}}" ], "path": [ "button", "document", "template" ] }, "description": "You can send buttons _**Template**_ **with document** message to phone number. You need to send the **title(optional), footer(optional), body and buttons(array , exp format in body)** of the message. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **templateMessage** that contain buttons info (hydratedButtons, displayText, url index, etc) , messageTimesamp format and status of the message." }, "response": [ { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال ازرار تفاعلية", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لا تفوت العرض", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/document/template", "host": [ "{{base_url}}" ], "path": [ "button", "document", "template" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 11:42:31 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 11:42:31 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "success response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "title", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال ازرار تفاعلية", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لا تفوت العرض", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "buttons[1][id]", "value": "5", "type": "text" }, { "key": "buttons[1][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[1][type]", "value": "1", "type": "text" }, { "key": "buttons[1][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "document", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/f8eb54b3-30c9-43da-a3bd-2f551c55c114.pdf", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/document/template", "host": [ "{{base_url}}" ], "path": [ "button", "document", "template" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Mon, 27 Feb 2023 13:23:46 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "send buttons template with video messag", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "title", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال ازرار تفاعلية", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لا تفوت العرض", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "video", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/dc6a152f-1b27-4171-bf38-9c1e75c2fc34.mp4", "description": "Video Url", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/video/template", "host": [ "{{base_url}}" ], "path": [ "button", "video", "template" ] }, "description": "You can send buttons _**Template**_ **with video** message to phone number. You need to send the **title(optional), footer(optional), body and buttons(array , exp format in body)** of the message. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **templateMessage** that contain buttons info (hydratedButtons, displayText, url index, etc) , messageTimesamp format and status of the message." }, "response": [ { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [ { "key": "CHANNELID", "value": "{{CHANNELID}}", "type": "text" }, { "key": "CHANNELTOKEN", "value": "{{CHANNELTOKEN}}", "type": "text" } ], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "title", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال ازرار تفاعلية", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لا تفوت العرض", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/video/template", "host": [ "{{base_url}}" ], "path": [ "button", "video", "template" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:09:42 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:09:42 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "success response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "title", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال ازرار تفاعلية", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لا تفوت العرض", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "video", "value": "https://letsbot.net/public/uploads/78986064-893d-4f65-895c-edb2875e4038/chats/dc6a152f-1b27-4171-bf38-9c1e75c2fc34.mp4", "description": "Video Url", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/video/template", "host": [ "{{base_url}}" ], "path": [ "button", "video", "template" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Mon, 27 Feb 2023 13:24:12 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "send buttons template with location messag", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "title", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال ازرار تفاعلية", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لا تفوت العرض", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "lat", "value": "23", "type": "text" }, { "key": "lng", "value": "21", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/location/template", "host": [ "{{base_url}}" ], "path": [ "button", "location", "template" ] }, "description": "You can send buttons _**Template**_ **with location** message to phone number. You need to send the **title(optional), footer(optional), body and buttons(array , exp format in body)** of the message. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see **templateMessage** that contain buttons info (hydratedButtons, displayText, url index, etc) , messageTimesamp format and status of the message." }, "response": [ { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "title", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال ازرار تفاعلية", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لا تفوت العرض", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://final.letsbot.net/login", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/location/template", "host": [ "{{base_url}}" ], "path": [ "button", "location", "template" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:21:25 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:21:25 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "success response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "title", "value": "title", "type": "text" }, { "key": "body", "value": "اهلا بك فى ليتس بوت تجربة ارسال ازرار تفاعلية", "description": "body for message", "type": "text" }, { "key": "footer", "value": "لا تفوت العرض", "description": "footer for message // optional", "type": "text" }, { "key": "buttons[0][id]", "value": "4", "description": "details for buttons you need send", "type": "text" }, { "key": "buttons[0][title]", "value": "⭐Star LetsBot on GitHub!", "type": "text" }, { "key": "buttons[0][type]", "value": "1", "type": "text" }, { "key": "buttons[0][extra_data]", "value": "https://example.net/login", "type": "text" }, { "key": "lat", "value": "23", "type": "text" }, { "key": "lng", "value": "21", "type": "text" } ] }, "url": { "raw": "{{base_url}}/button/location/template", "host": [ "{{base_url}}" ], "path": [ "button", "location", "template" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Mon, 27 Feb 2023 13:24:38 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] } ] }, { "name": "Send List Message", "item": [ { "name": "send list message", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "Body of message", "description": "body for message", "type": "text" }, { "key": "title", "value": "Tilte of message", "description": "//optional title for message", "type": "text" }, { "key": "footer", "value": "Footer of message", "description": "footer for message", "type": "text" }, { "key": "buttonText", "value": "Required, text on the button to view the list", "description": "text on the button to view the list", "type": "text" }, { "key": "sections[0][title]", "value": "Section 1 Text", "description": "details for sections", "type": "text" }, { "key": "sections[0][rows][0][title]", "value": "Option 1", "type": "text" }, { "key": "sections[0][rows][0][rowId]", "value": "Option1", "type": "text" }, { "key": "sections[0][rows][0][description]", "value": "This is description", "type": "text" }, { "key": "sections[0][rows][1][title]", "value": "Option 2", "type": "text" }, { "key": "sections[0][rows][1][rowId]", "value": "Option2", "type": "text" } ] }, "url": { "raw": "{{base_url}}/list/message", "host": [ "{{base_url}}" ], "path": [ "list", "message" ] }, "description": "You can send list message select to phone number. You need to send the **body, footer, title(optional), buttonText and sections(array)** of the message. Every section array has two index which is title and rows , for every rows has title, rowid and description(optional).You can see the result of the sections in image below. **Id of the message** in the key of the data of the response. In the **Message of the data of the response** , You can see listMessage that contain list message info (title, description, buttonText, listType, sections, etc) , messageTimesamp format and status of the message. " }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "Body of message", "description": "body for message", "type": "text" }, { "key": "title", "value": "Tilte of message", "description": "//optional title for message", "type": "text" }, { "key": "footer", "value": "Footer of message", "description": "footer for message", "type": "text" }, { "key": "buttonText", "value": "Required, text on the button to view the list", "description": "text on the button to view the list", "type": "text" }, { "key": "sections[0][title]", "value": "Section 1 Text", "description": "details for sections", "type": "text" }, { "key": "sections[0][rows][0][title]", "value": "Option 1", "type": "text" }, { "key": "sections[0][rows][0][rowId]", "value": "Option1", "type": "text" }, { "key": "sections[0][rows][0][description]", "value": "This is description", "type": "text" }, { "key": "sections[0][rows][1][title]", "value": "Option 2", "type": "text" }, { "key": "sections[0][rows][1][rowId]", "value": "Option2", "type": "text" } ] }, "url": { "raw": "{{base_url}}/list/message", "host": [ "{{base_url}}" ], "path": [ "list", "message" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 19:00:18 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 19:00:18 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "body", "value": "Body of message", "description": "body for message", "type": "text" }, { "key": "title", "value": "Tilte of message", "description": "//optional title for message", "type": "text" }, { "key": "footer", "value": "Footer of message", "description": "footer for message", "type": "text" }, { "key": "buttonText", "value": "Required, text on the button to view the list", "description": "text on the button to view the list", "type": "text" }, { "key": "sections[0][title]", "value": "Section 1 Text", "description": "details for sections", "type": "text", "disabled": true }, { "key": "sections[0][rows][0][title]", "value": "Option 1", "type": "text", "disabled": true }, { "key": "sections[0][rows][0][rowId]", "value": "Option1", "type": "text", "disabled": true }, { "key": "sections[0][rows][0][description]", "value": "This is description", "type": "text", "disabled": true }, { "key": "sections[0][rows][1][title]", "value": "Option 2", "type": "text", "disabled": true }, { "key": "sections[0][rows][1][rowId]", "value": "Option2", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/list/message", "host": [ "{{base_url}}" ], "path": [ "list", "message" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sat, 10 Dec 2022 19:07:50 GMT" }, { "key": "Date", "value": "Sat, 10 Dec 2022 19:07:49 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] } ] } ], "description": "In this folder, you can send different types of message in Whatsapp with different options.", "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "" ] } }, { "listen": "test", "script": { "type": "text/javascript", "exec": [ "" ] } } ] }, { "name": "group", "item": [ { "name": "Invite to group", "item": [ { "name": "generate Invite code", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "jid", "value": "120363057244685240@g.us", "description": "Group Id", "type": "text" } ] }, "url": { "raw": "{{base_url}}/invite/code", "host": [ "{{base_url}}" ], "path": [ "invite", "code" ] }, "description": "Get invite code by group id. **Data of the response** is the **invitation code**." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" } ] }, "url": { "raw": "{{base_url}}/invite/code", "host": [ "{{base_url}}" ], "path": [ "invite", "code" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:23:39 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:23:39 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "revoke Invite code", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "jid", "value": "120363057244685240@g.us", "description": "Group Id", "type": "text" } ] }, "url": { "raw": "{{base_url}}/invite/revoke/code", "host": [ "{{base_url}}" ], "path": [ "invite", "revoke", "code" ] }, "description": "Revoke Group invite code by group Id. **Data of the response** is the **New** invite code." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [ { "key": "CHANNELID", "value": "{{CHANNELID}}", "type": "text" }, { "key": "CHANNELTOKEN", "value": "{{CHANNELTOKEN}}", "type": "text" } ], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" } ] }, "url": { "raw": "{{base_url}}/invite/revoke/code", "host": [ "{{base_url}}" ], "path": [ "invite", "revoke", "code" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:29:46 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:29:46 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "send invite link", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "to", "value": "{{phone}}", "description": "Phone number", "type": "text" }, { "key": "jid", "value": "120363057244685240@g.us", "description": "Group Id", "type": "text" } ] }, "url": { "raw": "{{base_url}}/invite/send/link", "host": [ "{{base_url}}" ], "path": [ "invite", "send", "link" ] }, "description": "Send invite group link to phone number. The **data** response is the **link for invitation**" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "to", "value": "{{phone}}", "description": "Phone number", "type": "text" }, { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" } ] }, "url": { "raw": "{{base_url}}/invite/send/link", "host": [ "{{base_url}}" ], "path": [ "invite", "send", "link" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:35:38 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:35:38 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "proup get Invite Info", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/invite/get/info?code=KXDixa04zE73bgj5LIWhJ7", "host": [ "{{base_url}}" ], "path": [ "invite", "get", "info" ], "query": [ { "key": "code", "value": "KXDixa04zE73bgj5LIWhJ7" } ] }, "description": "Get Group info by **valid** invite Code. **Data of the response** is the group id." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "code", "value": "{{code}}", "description": "Group Id", "type": "text" } ] }, "url": { "raw": "{{base_url}}/invite/get/info?code=KXDixa04zE73bgj5LIWhJ7", "host": [ "{{base_url}}" ], "path": [ "invite", "get", "info" ], "query": [ { "key": "code", "value": "KXDixa04zE73bgj5LIWhJ7" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:49:49 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:49:49 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Content-Type", "value": "application/json", "name": "Content-Type", "description": "", "type": "text" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response (Invaild Code)", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "code", "value": "InvaildCode", "description": "Invite Code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/invite/get/info?code=KXDixa04zE73bgj5LIWhJ7", "host": [ "{{base_url}}" ], "path": [ "invite", "get", "info" ], "query": [ { "key": "code", "value": "KXDixa04zE73bgj5LIWhJ7" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 14:18:22 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 14:18:22 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Content-Type", "value": "application/json", "name": "Content-Type", "description": "", "type": "text" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] } ] }, { "name": "Group Participant", "item": [ { "name": "demote group participant", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "jid", "value": "120363057244685240@g.us", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone}}", "description": "List of phone numbers to Demote in group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/demote/participant", "host": [ "{{base_url}}" ], "path": [ "group", "demote", "participant" ] }, "description": "You can demote list of phone numbers in the group. The **Jid** of the response is the Whatsapp account of the participant you demoted." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone2}}", "description": "List of phone numbers to Demote in group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/demote/participant", "host": [ "{{base_url}}" ], "path": [ "group", "demote", "participant" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:05:59 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:05:58 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone}}", "description": "List of phone numbers to add in group", "type": "text", "disabled": true }, { "key": "phones[1]", "value": "{{phone}}", "type": "text", "disabled": true }, { "key": "phones", "value": "{{phone}}", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/demote/participant", "host": [ "{{base_url}}" ], "path": [ "group", "demote", "participant" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:52:52 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:52:52 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "add group participant", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "jid", "value": "120363057244685240@g.us", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone2}}", "description": "List of phone numbers to add in group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/add/participant", "host": [ "{{base_url}}" ], "path": [ "group", "add", "participant" ] }, "description": "You can add participants to the group by passing the **group id** (response of create group) and list of phone numbers**(array)** to add. The **Jid** of the response is the Whatsapp account of the participant you added." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone2}}", "description": "List of phone numbers to add in group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/add/participant", "host": [ "{{base_url}}" ], "path": [ "group", "add", "participant" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:01:10 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:01:10 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone}}", "description": "List of phone numbers to add in group", "type": "text" }, { "key": "phones[1]", "value": "{{phone}}", "type": "text" }, { "key": "phones", "value": "{{phone}}", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/add/participant", "host": [ "{{base_url}}" ], "path": [ "group", "add", "participant" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:52:52 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:52:52 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "remove group participant", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "jid", "value": "120363057244685240@g.us", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone2}}", "description": "List of phone numbers to remove from group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/remove/participant", "host": [ "{{base_url}}" ], "path": [ "group", "remove", "participant" ] }, "description": "You can remove list of phone numbers in the group. The **Jid** of the response is the Whatsapp account of the participant you removed." }, "response": [ { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone}}", "description": "List of phone numbers to add in group", "type": "text", "disabled": true }, { "key": "phones[1]", "value": "{{phone}}", "type": "text", "disabled": true }, { "key": "phones", "value": "{{phone}}", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/remove/participant", "host": [ "{{base_url}}" ], "path": [ "group", "remove", "participant" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:52:52 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:52:52 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Success Respoonse", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone2}}", "description": "List of phone numbers to remive from group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/remove/participant", "host": [ "{{base_url}}" ], "path": [ "group", "remove", "participant" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:56:14 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:56:14 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Content-Type", "value": "application/json", "name": "Content-Type", "description": "", "type": "text" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "promote group participant", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "jid", "value": "120363057244685240@g.us", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone2}}", "description": "List of phone numbers to Promote in group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/promote/participant", "host": [ "{{base_url}}" ], "path": [ "group", "promote", "participant" ] }, "description": "You can promote list of phone numbers in the group. The **Jid** of the response is the Whatsapp account of the participant you promoted." }, "response": [ { "name": "Success Respose", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone2}}", "description": "List of phone numbers to Promote in group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/promote/participant", "host": [ "{{base_url}}" ], "path": [ "group", "promote", "participant" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:04:41 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:04:41 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "phones[0]", "value": "{{phone}}", "description": "List of phone numbers to add in group", "type": "text", "disabled": true }, { "key": "phones[1]", "value": "{{phone}}", "type": "text", "disabled": true }, { "key": "phones", "value": "{{phone}}", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/promote/participant", "host": [ "{{base_url}}" ], "path": [ "group", "promote", "participant" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:52:52 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:52:52 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] } ] }, { "name": "group settings", "item": [ { "name": "get display picture", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/group/display/picture?jid=120363061829425867@g.us", "host": [ "{{base_url}}" ], "path": [ "group", "display", "picture" ], "query": [ { "key": "jid", "value": "120363061829425867@g.us" } ] }, "description": "get group image by `jid` parameter value must be group id" }, "response": [ { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/display/picture?jid=120363061829425867@g.us", "host": [ "{{base_url}}" ], "path": [ "group", "display", "picture" ], "query": [ { "key": "jid", "value": "120363061829425867@g.us" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 13:36:21 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 13:36:21 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "success response", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/group/display/picture?jid=120363061829425867@g.us", "host": [ "{{base_url}}" ], "path": [ "group", "display", "picture" ], "query": [ { "key": "jid", "value": "120363061829425867@g.us" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Mon, 27 Feb 2023 13:35:42 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "set display picture", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "image", "value": "https://letsbot.net/resources/Gallery/221595264200_servers.png", "type": "text" }, { "key": "jid", "value": "120363061829425867@g.us", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/set/display/picture", "host": [ "{{base_url}}" ], "path": [ "group", "set", "display", "picture" ] }, "description": "put this `jid` key, it will modify the image of the group" }, "response": [ { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [ { "key": "CHANNELID", "value": "{{CHANNELID}}", "type": "text" }, { "key": "CHANNELTOKEN", "value": "{{CHANNELTOKEN}}", "type": "text" } ], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/set/display/picture", "host": [ "{{base_url}}" ], "path": [ "group", "set", "display", "picture" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 13:36:21 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 13:36:21 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "success response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "image", "value": "https://letsbot.net/resources/Gallery/221595264200_servers.png", "type": "text" }, { "key": "jid", "value": "120363061829425867@g.us", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/set/display/picture", "host": [ "{{base_url}}" ], "path": [ "group", "set", "display", "picture" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Mon, 27 Feb 2023 13:36:02 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "rename group", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "jid", "value": "120363057244685240@g.us", "description": "Group Id", "type": "text" }, { "key": "subject", "value": "Test Group 2", "description": "The name of the group wil be changed", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/rename", "host": [ "{{base_url}}" ], "path": [ "group", "rename" ] }, "description": "You can rename group chat by passing the group id and the new subject of the group." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "subject", "value": "Test Group 2", "description": "The name of the group wil be changed", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/rename", "host": [ "{{base_url}}" ], "path": [ "group", "rename" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:09:25 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:09:25 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "subject", "value": "Test Group 2", "description": "The name of the group wil be changed", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/group/rename", "host": [ "{{base_url}}" ], "path": [ "group", "rename" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:09:48 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:09:48 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "set group description", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "jid", "value": "120363057244685240@g.us", "description": "Group Id", "type": "text" }, { "key": "description", "value": "This is test group", "description": "Description of the group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/set/description", "host": [ "{{base_url}}" ], "path": [ "group", "set", "description" ] }, "description": "You can set group description by passing group id and description." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [ { "key": "CHANNELID", "value": "{{CHANNELID}}", "type": "text" }, { "key": "CHANNELTOKEN", "value": "{{CHANNELTOKEN}}", "type": "text" } ], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "description", "value": "This is test group", "description": "Description of the group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/set/description", "host": [ "{{base_url}}" ], "path": [ "group", "set", "description" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "html", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:49:49 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:49:49 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Content-Type", "value": "text/html; charset=UTF-8" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "description", "value": "This is test group", "description": "Description of the group", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/group/set/description", "host": [ "{{base_url}}" ], "path": [ "group", "set", "description" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:11:47 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:11:47 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "change group settings", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "jid", "value": "120363057244685240@g.us", "description": "Group Id", "type": "text" }, { "key": "settings", "value": "not_announcement", "description": "//announcement, not_announcement, locked, unlocked", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/settings", "host": [ "{{base_url}}" ], "path": [ "group", "settings" ] }, "description": "You can change group settings by passing group id and the settings option. There are **exactly 4 options** in the settings. - **unlocked** (This group settings to allow all participants to edit their information). - **announcement** (This group settings to allow only admins to send messages to this group.) - **not_announcement** (This group settings to allow all participants to send messages to this group). - **locked**(This group settings are for admins only to edit its information)." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "settings", "value": "unlocked", "description": "//announcement, not_announcement, locked, unlocked", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/settings", "host": [ "{{base_url}}" ], "path": [ "group", "settings" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:12:23 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:12:23 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Invaild Settings", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "settings", "value": "invaild", "description": "//announcement, not_announcement, locked, unlocked", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/settings", "host": [ "{{base_url}}" ], "path": [ "group", "settings" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:42:54 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:42:54 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" }, { "key": "settings", "value": "announcement ", "description": "//announcement, not_announcement, locked, unlocked", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/group/settings", "host": [ "{{base_url}}" ], "path": [ "group", "settings" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:21:41 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:21:41 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] } ] }, { "name": "get group list", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/group/list", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "group", "list" ] }, "description": "Get groups list of your phone number. Data of the response contain : - participants array of numbers. - id of the group. - name of the group. - conversationTimestamp. - etc...." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/group/list", "host": [ "{{base_url}}" ], "path": [ "group", "list" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:36:14 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:36:14 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "get group conversation", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/group/conversation?jid={{jid1}}", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "group", "conversation" ], "query": [ { "key": "jid", "value": "{{jid1}}" } ] }, "description": "Get group conversation of your phone number by passing **jid** of the phone number. The data of the response contain : - Id of the mesage. - body. - caption. - messageType(text, file, image, etc). - author. - chatName (Phone number). - time in timestamp. - status of the message. - payload.imageMessage.url (if message is image). - body.content. - etc" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "jid", "value": "{{jid1}}", "description": "Whatsapp account number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/conversation?jid={{jid1}}", "host": [ "{{base_url}}" ], "path": [ "group", "conversation" ], "query": [ { "key": "jid", "value": "{{jid1}}" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:42:38 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:42:38 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "jid", "value": "", "description": "Phone number", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/group/conversation?jid={{jid1}}", "host": [ "{{base_url}}" ], "path": [ "group", "conversation" ], "query": [ { "key": "jid", "value": "{{jid1}}" } ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 13:15:12 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 13:15:12 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "get group metadata", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/group/meta/data?jid={{jid}}", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "group", "meta", "data" ], "query": [ { "key": "jid", "value": "{{jid}}" } ] }, "description": "Get Group Meta info of the group. - ID : of the group. - Subject : name of the group. - Subject Owner : owner Whatsapp account. - Subject Time : timestamp of the subject updated. - Size : number of the participants. - Creation : timestamp of the group creation. - Owner Phone : owner account number. - Description : description of the group. - Description Id : id of the description. - Restrict and announce. - Participants info ( id, admin) if not admin the value is null." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{GROUP_TEST}}", "description": "Group Id", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/meta/data?jid={{jid}}", "host": [ "{{base_url}}" ], "path": [ "group", "meta", "data" ], "query": [ { "key": "jid", "value": "{{jid}}" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:30:10 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:30:10 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "create group", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phones[0]", "value": "{{phone}}", "description": "List of phone numbers", "type": "text" }, { "key": "phones[1]", "value": "{{phone}}", "type": "text" }, { "key": "subject", "value": "Test Group", "description": "The name of the group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/create", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "group", "create" ] }, "description": "You can create group in Whatsapp by passing subject of the group and phone numbers (array). **The id of the data of the response** is the **id** of the group." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phones[0]", "value": "{{phone}}", "description": "List of phone numbers", "type": "text" }, { "key": "phones[1]", "value": "{{phone}}", "type": "text" }, { "key": "subject", "value": "Test Group", "description": "The name of the group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/create", "host": [ "{{base_url}}" ], "path": [ "group", "create" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:58:02 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:58:02 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phones", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "subject", "value": "Test Group", "description": "The name of the group", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/create", "host": [ "{{base_url}}" ], "path": [ "group", "create" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:32:13 GMT" }, { "key": "Date", "value": "Tue, 06 Dec 2022 13:32:13 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "join group", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "code", "value": "{{code}}", "description": "Invite Code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/join", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "group", "join" ] }, "description": "Join Group by **valid** invite Code. **Data of the response** is the group id." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "code", "value": "{{code}}", "description": "Invite Code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/join", "host": [ "{{base_url}}" ], "path": [ "group", "join" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:28:54 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:28:54 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "code", "value": "invalidcode", "description": "Invite Code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/group/join", "host": [ "{{base_url}}" ], "path": [ "group", "join" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:28:36 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 12:28:36 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] } ] }, { "name": "Chat", "item": [ { "name": "get chat list for phone", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/chat/list", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "list" ] }, "description": "Get the chat list for your phone number. Each chat in the response contains:\n\n- **id** — the WhatsApp account the chat is with.\n- **lastMessageRecvTimestamp** — timestamp of the last message received.\n- **messages.0.message.message.conversation** — content of the last message.\n- **messages.0.message.reactions** — reactions received on that message.\n- **messages.0.message.key.id** — the message ID.\n- **messages.0.message.key.remoteJid** — the WhatsApp account of the message." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/chat/list", "host": [ "{{base_url}}" ], "path": [ "chat", "list" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:05:24 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:05:24 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "get chat conversation for phone", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/chat/conversation?phone={{phone2}}&limit=25&cursorId=REDACTED&cursorFromMe=true", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "conversation" ], "query": [ { "key": "phone", "value": "{{phone2}}" }, { "key": "limit", "value": "25" }, { "key": "cursorId", "value": "REDACTED" }, { "key": "cursorFromMe", "value": "true" } ] }, "description": "Get the conversation with one phone number from the WhatsApp session, newest first. Page with `limit`, then pass the last message's id as `cursorId` and its direction as `cursorFromMe`.\n\n**Channels:** QR (WhatsApp Web) channels only. On official WhatsApp Cloud API channels this request is not supported.\n\nTo read stored messages by date on any channel, use **Message Archive → Get messages by date**." }, "response": [ { "name": "success response", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/chat/conversation?phone={{phone2}}&limit=25&cursorId=REDACTED&cursorFromMe=true", "host": [ "{{base_url}}" ], "path": [ "chat", "conversation" ], "query": [ { "key": "phone", "value": "{{phone2}}" }, { "key": "limit", "value": "25" }, { "key": "cursorId", "value": "REDACTED" }, { "key": "cursorFromMe", "value": "true" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 13:03:31 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "get contacts", "protocolProfileBehavior": { "disabledSystemHeaders": {} }, "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/contacts", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "contacts" ] }, "description": "You can get your contacts list. The data of the response contain: - Id is the Whatsapp account number. - name is the name of the contact. - image of the person if exist. - notify is the nick name." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/contacts", "host": [ "{{base_url}}" ], "path": [ "contacts" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:27:58 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:27:58 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "56" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "set typing", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{phone}}", "description": "phone number or chat id", "type": "text" }, { "key": "chat", "value": "{{GROUP_TEST}}", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/chat/typing", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "typing" ] }, "description": "You can show you are typing to the phone number or chat by passing in the chat form-data." }, "response": [ { "name": "Success Respose", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{phone}}", "description": "phone number or chat id", "type": "text" }, { "key": "chat", "value": "{{GROUP_TEST}}", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/chat/typing", "host": [ "{{base_url}}" ], "path": [ "chat", "typing" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:11:04 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:11:04 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "set recording", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{phone}}", "description": "phone number or group id", "type": "text" }, { "key": "chat", "value": "{{GROUP_TEST}}", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/chat/recording", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "recording" ] }, "description": "You can set you are recording by passing phone number or group id." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "chat", "value": "{{phone}}", "description": "phone number or group id", "type": "text" }, { "key": "chat", "value": "{{GROUP_TEST}}", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/chat/recording", "host": [ "{{base_url}}" ], "path": [ "chat", "recording" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:26:07 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:26:07 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "read chat", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/read", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "read" ] }, "description": "You can read chat messages to phone number. Before After" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/read", "host": [ "{{base_url}}" ], "path": [ "chat", "read" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:17:38 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:17:38 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "unread chat", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/unread", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "unread" ] }, "description": "You can un read phone chat number." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/unread", "host": [ "{{base_url}}" ], "path": [ "chat", "unread" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:18:13 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:18:13 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "archive chat", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/archive", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "archive" ] }, "description": "You can archive chat phone number." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/archive", "host": [ "{{base_url}}" ], "path": [ "chat", "archive" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:57:00 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:56:59 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "unarchive chat", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" }, { "key": "", "value": "", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/chat/unarchive", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "unarchive" ] }, "description": "You can un archive chat phone number." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" }, { "key": "", "value": "", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/chat/unarchive", "host": [ "{{base_url}}" ], "path": [ "chat", "unarchive" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:20:17 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:20:17 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "mute chat", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" }, { "key": "duration", "value": "60", "description": "Duration of mute chat in seconds", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/mute", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "mute" ] }, "description": "You can mute chat phone number with duration time in **seconds.**" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" }, { "key": "duration", "value": "60", "description": "Duration of mute chat in seconds", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/mute", "host": [ "{{base_url}}" ], "path": [ "chat", "mute" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:21:56 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:21:56 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/mute", "host": [ "{{base_url}}" ], "path": [ "chat", "mute" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 12:00:43 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 12:00:43 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "unmute chat", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/unmute", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "unmute" ] }, "description": "You can un mute phone chat number." }, "response": [ { "name": "success response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/unmute", "host": [ "{{base_url}}" ], "path": [ "chat", "unmute" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 13:06:36 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "pin chat", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number or Group id", "type": "text" }, { "key": "phone", "value": "{{GROUP_TEST}}", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/chat/pin", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "pin" ] }, "description": "You can pin phone chat number or group chat(passing group id)." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number or Group id", "type": "text" }, { "key": "phone", "value": "{{GROUP_TEST}}", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/chat/pin", "host": [ "{{base_url}}" ], "path": [ "chat", "pin" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:23:38 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:23:38 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "unpin chat", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number or Group id", "type": "text" }, { "key": "phone", "value": "{{GROUP_TEST}}", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/unpin", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "chat", "unpin" ] }, "description": "You can un pin phone chat number or group chat(passing group id)." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number or Group id", "type": "text" }, { "key": "phone", "value": "{{GROUP_TEST}}", "type": "text" } ] }, "url": { "raw": "{{base_url}}/chat/unpin", "host": [ "{{base_url}}" ], "path": [ "chat", "unpin" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:25:25 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 11:25:25 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "check phone on WhatsApp", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/check/phone", "host": [ "{{base_url}}" ], "path": [ "check", "phone" ] }, "description": "Check whether a phone number has a WhatsApp account.\n\n**Required:** `phone` (international format, digits).\n\n**Channels:** QR (WhatsApp Web) channels only. On official WhatsApp Cloud API channels this request is not supported.", "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "type": "text", "description": "Phone number to check" } ] } }, "response": [] } ] }, { "name": "Users", "item": [ { "name": "presence user", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/presence", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "user", "presence" ] }, "description": "Get user presence status." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/presence", "host": [ "{{base_url}}" ], "path": [ "user", "presence" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:02:30 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:02:30 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Content-Type", "value": "application/json", "name": "Content-Type", "description": "", "type": "text" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "failed response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/user/presence", "host": [ "{{base_url}}" ], "path": [ "user", "presence" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 13:32:59 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "56" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "disply picture by user", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/display/picture?phone={{phone}}", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "user", "display", "picture" ], "query": [ { "key": "phone", "value": "{{phone}}" } ] }, "description": "Display user picture by phone number. **Data of the response is the picture link.**" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/display/picture?phone={{phone}}", "host": [ "{{base_url}}" ], "path": [ "user", "display", "picture" ], "query": [ { "key": "phone", "value": "{{phone}}" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:27:08 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:27:08 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "failed response", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/user/display/picture?phone={{phone}}", "host": [ "{{base_url}}" ], "path": [ "user", "display", "picture" ], "query": [ { "key": "phone", "value": "{{phone}}" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 13:33:30 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "block number", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone2}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/block", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "user", "block" ] }, "description": "Block phone number by passing the number in form-data." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone2}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/block", "host": [ "{{base_url}}" ], "path": [ "user", "block" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:27:32 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:27:32 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "unblock number", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone2}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/unblock", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "user", "unblock" ] }, "description": "un block phone number by passing the number in form-data." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone2}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/unblock", "host": [ "{{base_url}}" ], "path": [ "user", "unblock" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:28:04 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:28:04 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "user business profile", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/business", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "user", "business" ] }, "description": "You can get info of user business profile by passing phone number. The data of the response contain : - wid Whatsapp phone account. - description of the business. - website business. - category of the business. - business working hours if exist. - address of the business. - email of the business. - etc." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/business", "host": [ "{{base_url}}" ], "path": [ "user", "business" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:31:40 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:31:40 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "failed response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/business", "host": [ "{{base_url}}" ], "path": [ "user", "business" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 13:35:18 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "set profile name", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone2}}", "description": "phone number with country code", "type": "text" }, { "key": "name", "value": "Profile Name", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/set/name", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "user", "set", "name" ] }, "description": "You can set profile name of phone number." }, "response": [ { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "", "value": "", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/user/set/name", "host": [ "{{base_url}}" ], "path": [ "user", "set", "name" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:16:36 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:16:36 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone2}}", "description": "phone number with country code", "type": "text" }, { "key": "name", "value": "Profile Name", "type": "text" } ] }, "url": { "raw": "{{base_url}}/user/set/name", "host": [ "{{base_url}}" ], "path": [ "user", "set", "name" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:32:56 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:32:56 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "get user status", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/user/status", "host": [ "{{base_url}}" ], "path": [ "user", "status" ] }, "description": "Get the WhatsApp \"about\" text of a phone number.\n\n**Required:** `phone`.\n\n**Channels:** QR (WhatsApp Web) channels only. On official WhatsApp Cloud API channels this request is not supported.", "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "type": "text", "description": "Phone number" } ] } }, "response": [] }, { "name": "set my status", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/user/set/status", "host": [ "{{base_url}}" ], "path": [ "user", "set", "status" ] }, "description": "Set the WhatsApp \"about\" text of your connected number.\n\n**Required:** `status`.\n\n**Channels:** QR (WhatsApp Web) channels only. On official WhatsApp Cloud API channels this request is not supported.", "body": { "mode": "formdata", "formdata": [ { "key": "status", "value": "Available 9:00–18:00", "type": "text", "description": "New about text" } ] } }, "response": [] }, { "name": "set my display picture", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/user/set/display/picture", "host": [ "{{base_url}}" ], "path": [ "user", "set", "display", "picture" ] }, "description": "Set the profile picture of your connected number.\n\n**Required:** `phone`, `image` (a public image URL).\n\n**Channels:** QR (WhatsApp Web) channels only. On official WhatsApp Cloud API channels this request is not supported.", "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "type": "text", "description": "Your connected number" }, { "key": "image", "value": "https://example.com/logo.jpg", "type": "text", "description": "Public URL of the image" } ] } }, "response": [] } ] }, { "name": "Live Chat", "description": "Contacts, labels and team assignment in the LetsBot inbox. These read and write your LetsBot data and work on every channel type.", "item": [ { "name": "get contact", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/live_chat/contact?phone={{phone}}", "host": [ "{{base_url}}" ], "path": [ "live_chat", "contact" ], "query": [ { "key": "phone", "value": "{{phone}}", "description": "Contact phone number" } ] }, "description": "Get a contact with its labels and assigned team members. If the phone number is not a contact yet, it is created.\n\n**Required:** `phone`.\n\n**Response:** `data` = `{id, phone, labels[], moderators[]}`.\n\nValidation errors return HTTP 422 `{\"message\": \"error\", \"data\": \"\"}`." }, "response": [] }, { "name": "list team members", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/live_chat/moderators", "host": [ "{{base_url}}" ], "path": [ "live_chat", "moderators" ] }, "description": "List the team members who can be assigned to conversations.\n\n**Response:** `data[]` = `{id, name, email, phone, image}`." }, "response": [] }, { "name": "assign team member to contact", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/live_chat/set-moderator", "host": [ "{{base_url}}" ], "path": [ "live_chat", "set-moderator" ] }, "description": "Assign a team member to a contact. Existing assignments are kept.\n\n**Required:** `phone`, `moderator_id` (an `id` from *list team members*).\n\nValidation errors return HTTP 422 `{\"message\": \"error\", \"data\": \"\"}`.", "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "type": "text", "description": "Contact phone number" }, { "key": "moderator_id", "value": "3", "type": "text", "description": "Team member id" } ] } }, "response": [] }, { "name": "list labels", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/live_chat/labels", "host": [ "{{base_url}}" ], "path": [ "live_chat", "labels" ] }, "description": "List contact labels.\n\n**Response:** `data[]` = `{id, name, name_translations, color}`." }, "response": [] }, { "name": "add label to contact", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/live_chat/set-label", "host": [ "{{base_url}}" ], "path": [ "live_chat", "set-label" ] }, "description": "Add a label to a contact. Existing labels are kept.\n\n**Required:** `phone`, `label_id` (an `id` from *list labels*).\n\nValidation errors return HTTP 422 `{\"message\": \"error\", \"data\": \"\"}`.", "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "type": "text", "description": "Contact phone number" }, { "key": "label_id", "value": "5", "type": "text", "description": "Label id" } ] } }, "response": [] } ] }, { "name": "Instances", "item": [ { "name": "status", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "url", "value": "https://letsbot.net/resources/Gallery/221595264200_servers.png", "type": "text", "disabled": true } ] }, "url": { "raw": "{{base_url}}/instance/status", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "instance", "status" ] }, "description": "You can set status of your phone number by passing status field." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "status", "value": "Test Status", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/status", "host": [ "{{base_url}}" ], "path": [ "instance", "status" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:38:06 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:38:05 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/instance/status", "host": [ "{{base_url}}" ], "path": [ "instance", "status" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:27:38 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:27:38 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "set status", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "status", "value": "343434", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/set/status", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "instance", "set", "status" ] }, "description": "You can set status of your phone number by passing status field." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "status", "value": "Test Status", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/set/status", "host": [ "{{base_url}}" ], "path": [ "instance", "set", "status" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:38:06 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:38:05 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/instance/set/status", "host": [ "{{base_url}}" ], "path": [ "instance", "set", "status" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:27:38 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:27:38 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "set Settings", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "markOnlineOnConnect", "value": "1", "description": "//1 for true, 0 for false", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/set/settings", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "instance", "set", "settings" ] }, "description": "Set setting of the phone when mark online on connect to be true or false(1 or 0)." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "markOnlineOnConnect", "value": "1", "description": "//1 for true, 0 for false", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/set/settings", "host": [ "{{base_url}}" ], "path": [ "instance", "set", "settings" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:39:36 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:39:36 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "", "value": "", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/set/settings", "host": [ "{{base_url}}" ], "path": [ "instance", "set", "settings" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:30:20 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:30:20 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "set presence", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "presence", "value": "available", "description": "unavailable,available,composing,recording,paused", "type": "text" }, { "key": "mixed", "value": "{{phone}}", "description": "put phone or group jid", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/set/presence", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "instance", "set", "presence" ] }, "description": "if you want to set presence you may should to use `mixed` parameter to set by phone or group jid mixed=xxxxxxx@g.us OR mixed=966xxxxxxx" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "markOnlineOnConnect", "value": "1", "description": "//1 for true, 0 for false", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/set/presence", "host": [ "{{base_url}}" ], "path": [ "instance", "set", "presence" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:39:36 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:39:36 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "", "value": "", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/set/presence", "host": [ "{{base_url}}" ], "path": [ "instance", "set", "presence" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:30:20 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:30:20 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] }, { "name": "pending query broadcast", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "broadcast", "value": "test", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/query/broadcast", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "instance", "query", "broadcast" ] }, "description": "Set setting of the phone when mark online on connect to be true or false(1 or 0)." }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "markOnlineOnConnect", "value": "1", "description": "//1 for true, 0 for false", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/query/broadcast", "host": [ "{{base_url}}" ], "path": [ "instance", "query", "broadcast" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:39:36 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:39:36 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "Failed Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "", "value": "", "type": "text" } ] }, "url": { "raw": "{{base_url}}/instance/query/broadcast", "host": [ "{{base_url}}" ], "path": [ "instance", "query", "broadcast" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:30:20 GMT" }, { "key": "Date", "value": "Fri, 09 Dec 2022 15:30:20 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] } ] }, { "name": "product", "item": [ { "name": "get products", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "product" ] }, "description": "Get products of phone number. products of the data from response is the details for all products. Details like: - id of the product. - iamgeUrls. - reviewStauts from whatsapp exp(APPROVED(. - avaiability. - name. - description. - price. - currency - isHidden(Boolean). - etc" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product", "host": [ "{{base_url}}" ], "path": [ "product" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:35:04 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:35:04 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "failed response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product", "host": [ "{{base_url}}" ], "path": [ "product" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 13:53:56 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "get products by id", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [], "body": { "mode": "formdata", "formdata": [] }, "url": { "raw": "{{base_url}}/product/id?phone={{phone}}&productId=6198355910228429", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "product", "id" ], "query": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code" }, { "key": "productId", "value": "6198355910228429" } ] }, "description": "Get products of phone number. products of the data from response is the details for all products. Details like: - id of the product. - iamgeUrls. - reviewStauts from whatsapp exp(APPROVED(. - avaiability. - name. - description. - price. - currency - isHidden(Boolean). - etc" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product/id?phone={{phone}}&productId=6198355910228429", "host": [ "{{base_url}}" ], "path": [ "product", "id" ], "query": [ { "key": "phone", "value": "{{phone}}" }, { "key": "productId", "value": "6198355910228429" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:35:04 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:35:04 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "failed response", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/product/id?phone={{phone}}&productId=6198355910228429", "host": [ "{{base_url}}" ], "path": [ "product", "id" ], "query": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code" }, { "key": "productId", "value": "6198355910228429" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 13:54:58 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "create products", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "name", "value": "product name", "type": "text" }, { "key": "description", "value": "product description", "type": "text" }, { "key": "price", "value": "1000", "type": "text" }, { "key": "currency", "value": "EGP", "type": "text" }, { "key": "isHidden", "value": "0", "type": "text" }, { "key": "images[0][url]", "value": "https://letsbot.net/public/uploads/8fe87007-20f4-4730-96e9-f6a9bc806dbc/groupMessages/60/soca-company-112923571820220811041023AM.jpg", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product/create", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "product", "create" ] }, "description": "Get products of phone number. products of the data from response is the details for all products. Details like: - id of the product. - iamgeUrls. - reviewStauts from whatsapp exp(APPROVED(. - avaiability. - name. - description. - price. - currency - isHidden(Boolean). - etc" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product/create", "host": [ "{{base_url}}" ], "path": [ "product", "create" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:35:04 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:35:04 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "failed response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "name", "value": "product name", "type": "text" }, { "key": "description", "value": "product description", "type": "text" }, { "key": "price", "value": "3460", "type": "text" }, { "key": "currency", "value": "EGP", "type": "text" }, { "key": "isHidden", "value": "0", "type": "text" }, { "key": "images[0][url]", "value": "https://letsbot.net/public/uploads/8fe87007-20f4-4730-96e9-f6a9bc806dbc/groupMessages/60/soca-company-112923571820220811041023AM.jpg", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product/create", "host": [ "{{base_url}}" ], "path": [ "product", "create" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 14:03:41 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "57" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "get order", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "orderID", "value": "456", "type": "text" }, { "key": "orderToken", "value": "", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product/get/order", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "product", "get", "order" ] }, "description": "Get products of phone number. products of the data from response is the details for all products. Details like: - id of the product. - iamgeUrls. - reviewStauts from whatsapp exp(APPROVED(. - avaiability. - name. - description. - price. - currency - isHidden(Boolean). - etc" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product/get/order", "host": [ "{{base_url}}" ], "path": [ "product", "get", "order" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:35:04 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:35:04 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" }, { "name": "failed response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" }, { "key": "orderID", "value": "456", "type": "text" }, { "key": "orderToken", "value": "", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product/get/order", "host": [ "{{base_url}}" ], "path": [ "product", "get", "order" ] } }, "status": "Accepted", "code": 202, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 14:03:58 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "56" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "get collections", "request": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product/get/collections", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "product", "get", "collections" ] }, "description": "Get products of phone number. products of the data from response is the details for all products. Details like: - id of the product. - iamgeUrls. - reviewStauts from whatsapp exp(APPROVED(. - avaiability. - name. - description. - price. - currency - isHidden(Boolean). - etc" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [], "body": { "mode": "formdata", "formdata": [ { "key": "phone", "value": "{{phone}}", "description": "phone number with country code", "type": "text" } ] }, "url": { "raw": "{{base_url}}/product/get/collections", "host": [ "{{base_url}}" ], "path": [ "product", "get", "collections" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Host", "value": "localhost:8000" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:35:04 GMT" }, { "key": "Date", "value": "Sun, 11 Dec 2022 13:35:04 GMT" }, { "key": "Connection", "value": "close" }, { "key": "X-Powered-By", "value": "PHP/8.1.4" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "Content-Type", "value": "application/json" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Access-Control-Allow-Origin", "value": "*" } ], "cookie": [], "body": "" } ] } ] }, { "name": "QR", "item": [ { "name": "qr", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/qr", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "qr" ] }, "description": "here you can query check your QRCode" }, "response": [ { "name": "success response", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/qr", "host": [ "{{base_url}}" ], "path": [ "qr" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 14:05:03 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] } ] }, { "name": "Sessions", "item": [ { "name": "find session", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/session/find", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "session", "find" ] }, "description": "in this query you can find your session" }, "response": [ { "name": "success response", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/session/find", "host": [ "{{base_url}}" ], "path": [ "session", "find" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 14:07:11 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" }, { "name": "failed response", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/session/find", "host": [ "{{base_url}}" ], "path": [ "session", "find" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 14:07:11 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] }, { "name": "session status", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/session/status", "protocol": "https", "host": [ "letsbot", "net" ], "path": [ "api", "v1", "session", "status" ] }, "description": "use this link to check your session is authenticated" }, "response": [ { "name": "success response", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/session/status", "host": [ "{{base_url}}" ], "path": [ "session", "status" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 14:07:57 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "58" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" }, { "name": "failed response", "originalRequest": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/session/status", "host": [ "{{base_url}}" ], "path": [ "session", "status" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Date", "value": "Sun, 26 Feb 2023 14:08:57 GMT" }, { "key": "Server", "value": "Apache/2.4.46 (Unix) mod_fastcgi/mod_fastcgi-SNAP-0910052141 OpenSSL/1.0.2u mod_wsgi/3.5 Python/2.7.13" }, { "key": "X-Powered-By", "value": "PHP/8.1.0" }, { "key": "Cache-Control", "value": "no-cache, private" }, { "key": "X-RateLimit-Limit", "value": "60" }, { "key": "X-RateLimit-Remaining", "value": "59" }, { "key": "Keep-Alive", "value": "timeout=5, max=100" }, { "key": "Connection", "value": "Keep-Alive" }, { "key": "Transfer-Encoding", "value": "chunked" }, { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "" } ] } ] }, { "name": "Templates (Official API)", "description": "WhatsApp Template Messages API endpoints. These endpoints allow sending pre-approved WhatsApp template messages through the official Meta WhatsApp Business API.\n\n**Important Notes:**\n- Templates must be pre-approved in WhatsApp Business Manager before sending\n- Only works with official WhatsApp Business API channels\n- Supports all template types: text, image, document, video, and location headers", "item": [ { "name": "Send Template Message (Full Featured)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"phone\": \"{{phone}}\",\n \"template_name\": \"added_to_course\",\n \"template_language\": \"ar\",\n \"components\": {\n \"header\": {\n \"type\": \"text\",\n \"parameters\": [\n {\"type\": \"text\", \"text\": \"تأكيد التسجيل\"}\n ]\n },\n \"body\": [\n \"أحمد\",\n \"دورة البرمجة المتقدمة\"\n ],\n \"buttons\": [\n {\n \"index\": 0,\n \"sub_type\": \"url\",\n \"parameters\": [{\"type\": \"text\", \"text\": \"app/course/123\"}]\n },\n {\n \"index\": 1,\n \"sub_type\": \"url\",\n \"parameters\": [{\"type\": \"text\", \"text\": \"store/app/456\"}]\n }\n ]\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/template/send", "host": [ "{{base_url}}" ], "path": [ "template", "send" ] }, "description": "Send any WhatsApp template message with full component support.\n\n**Supports:**\n- Header: text, image, document, video, location\n- Body: text parameters (variables)\n- Buttons: URL buttons, Quick Reply buttons\n\n**Example for `added_to_course` template:**\n- Header with confirmation title\n- Body with customer name and course name\n- URL buttons for iOS and Android app download" }, "response": [ { "name": "Success Response", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"phone\": \"966500000000\",\n \"template_name\": \"added_to_course\",\n \"template_language\": \"ar\",\n \"components\": {\n \"body\": [\"أحمد\", \"دورة البرمجة\"]\n }\n}" }, "url": { "raw": "{{base_url}}/template/send", "host": [ "{{base_url}}" ], "path": [ "template", "send" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"success\": true,\n \"message\": \"The message has been successfully sent.\",\n \"data\": {\n \"key\": {\n \"remoteJid\": \"966500000000@s.whatsapp.net\",\n \"fromMe\": true,\n \"id\": \"wamid.HBgLMTIzNDU2Nzg5MBUTQ\"\n },\n \"messageTimestamp\": 1706900000,\n \"status\": \"PENDING\"\n }\n}" } ] }, { "name": "Send Simple Template (Body Only)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"phone\": \"{{phone}}\",\n \"template_name\": \"order_confirmation\",\n \"template_language\": \"ar\",\n \"components\": {\n \"body\": [\n \"أحمد\",\n \"ORD-12345\",\n \"150 ريال\"\n ]\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/template/simple", "host": [ "{{base_url}}" ], "path": [ "template", "simple" ] }, "description": "Send a simple template message with only body parameters.\n\nIdeal for templates that only contain text variables in the body section, such as order confirmations, appointment reminders, etc." }, "response": [] }, { "name": "Send Template with Image Header", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"phone\": \"{{phone}}\",\n \"template_name\": \"product_promotion\",\n \"template_language\": \"ar\",\n \"components\": {\n \"header\": {\n \"type\": \"image\",\n \"image\": {\n \"link\": \"https://example.com/product-image.jpg\"\n }\n },\n \"body\": [\n \"خصم 50%\",\n \"المنتج الجديد\"\n ]\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/template/image", "host": [ "{{base_url}}" ], "path": [ "template", "image" ] }, "description": "Send a template message with an image header.\n\nPerfect for promotional templates, product announcements, or any template that includes a visual image at the top." }, "response": [] }, { "name": "Send Template with Document Header", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"phone\": \"{{phone}}\",\n \"template_name\": \"invoice_template\",\n \"template_language\": \"ar\",\n \"components\": {\n \"header\": {\n \"type\": \"document\",\n \"document\": {\n \"link\": \"https://example.com/invoice.pdf\",\n \"filename\": \"فاتورة_12345.pdf\"\n }\n },\n \"body\": [\n \"ORD-12345\",\n \"500 ريال\"\n ]\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/template/document", "host": [ "{{base_url}}" ], "path": [ "template", "document" ] }, "description": "Send a template message with a document/PDF header.\n\nIdeal for sending invoices, contracts, receipts, or any template that includes a downloadable document." }, "response": [] }, { "name": "Send Template with Video Header", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"phone\": \"{{phone}}\",\n \"template_name\": \"course_preview\",\n \"template_language\": \"ar\",\n \"components\": {\n \"header\": {\n \"type\": \"video\",\n \"video\": {\n \"link\": \"https://example.com/course-preview.mp4\"\n }\n },\n \"body\": [\n \"دورة البرمجة\",\n \"30 يوم\"\n ]\n }\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{base_url}}/template/video", "host": [ "{{base_url}}" ], "path": [ "template", "video" ] }, "description": "Send a template message with a video header.\n\nPerfect for course previews, product demonstrations, or any template that includes a video at the top." }, "response": [] } ] }, { "name": "Message Archive (read by date)", "description": "Read stored WhatsApp conversations by date, in both directions. Works for official (Cloud API) and QR channels. Outgoing replies can also be received in real time with a `message_notification` webhook (panel → API → Webhooks), which covers new messages only.", "item": [ { "name": "Get messages by date", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/messages?date_from=2026-09-09&date_to=2026-09-09&timezone=Europe/Kyiv&from_me=1", "host": [ "{{base_url}}" ], "path": [ "messages" ], "query": [ { "key": "date_from", "value": "2026-09-09", "description": "Required. Start of the range. `YYYY-MM-DD` covers the whole day; a full ISO-8601 datetime (e.g. `2026-09-09T08:00:00+03:00`) is an exact, inclusive bound." }, { "key": "date_to", "value": "2026-09-09", "description": "Required. End of the range. `YYYY-MM-DD` covers the whole day (`date_from=date_to` is one full day); a full ISO-8601 datetime is an exact, inclusive bound. Must not be before `date_from`." }, { "key": "timezone", "value": "Europe/Kyiv", "description": "Optional, default `UTC`. IANA timezone used to read bare dates and to format every `message_date` (always returned with its offset)." }, { "key": "from_me", "value": "1", "description": "Optional. `1`/`true` = outgoing only, `0`/`false` = incoming only. Omit for both directions." }, { "key": "sent_by", "value": "live_chat", "description": "Optional. Only messages from this source: `live_chat`, `bot`, `api`, `mcp`, `send_bulk`, `zapier`, `salla`, `zid`, `woocommerce`, `shopify`, `hubspot`, `pipedrive`, `stripe`, `magento`, `agent`.", "disabled": true }, { "key": "phone", "value": "{{phone}}", "description": "Optional. Only messages with this customer (international format, digits; a leading `+` is accepted).", "disabled": true }, { "key": "limit", "value": "50", "description": "Optional. Page size, default 50, maximum 200.", "disabled": true }, { "key": "cursor", "value": "", "description": "Optional. Pass `next_cursor` from the previous response, unchanged, to get the next page. A `null` `next_cursor` means there are no more pages.", "disabled": true } ] }, "description": "Read the message archive by date — **incoming and outgoing**, including replies your team types in Live Chat.\n\n**Authentication:** `Authorization: Bearer {{lb_api_key}}` (the collection's bearer auth). The key is in the panel → API → Authentication data (visible to the account owner). Requires an active subscription with the API Access add-on (or an active trial). This is **not** the Zapier key (`lbz_...`).\n\n**Pagination:** results are ordered oldest first by `message_date`, then `id`. When `next_cursor` is not `null`, repeat the same request adding `cursor=` until it is `null`. Rows that share a timestamp are never skipped or repeated across pages.\n\n**Each message**\n- `from_me` — `true` for messages you sent, `false` for messages from the customer.\n- `sent_by` — where an outgoing message came from (`live_chat`, `bot`, `api`, ...); `null` for incoming.\n- `agent` — `{id, name}` of the team member who typed the message; `null` for automated and incoming messages. Use this, not `sent_by`, to identify human replies.\n- `contact` — `{id, phone, chat_id, name}` of the customer, or `null`.\n- `type` — `text`, `image`, `video`, `audio`, `file`, `template_text`, ...\n- `status` / `status_text` — the last status we recorded for the message (Pending, Sent, Delivered, Viewed, FAILED). It is not proof of delivery on every channel.\n- `message_date` — ISO-8601 with offset, in the requested `timezone`.\n\nInternal notes, reactions, system lines and deleted messages are not returned.\n\n**Response-time analytics:** pair each incoming message with the next outgoing message for the same `contact.phone` whose `agent` is not `null`.\n\n**Errors:** `422` with `{\"Status\": false, \"Message\": \"...\"}` for invalid parameters; `401` for a missing or wrong key; `402` when the subscription or API add-on is not active.\n\n**Example**\n```\ncurl -G \"https://letsbot.net/api/v1/messages\" \\\n -H \"Authorization: Bearer YOUR_LB_API_KEY\" \\\n -H \"Accept: application/json\" \\\n --data-urlencode \"date_from=2026-09-09\" \\\n --data-urlencode \"date_to=2026-09-09\" \\\n --data-urlencode \"from_me=1\" \\\n --data-urlencode \"timezone=Europe/Kyiv\"\n```" }, "response": [ { "name": "200 — outgoing Live Chat replies for one day (Kyiv time)", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/messages?date_from=2026-09-09&date_to=2026-09-09&timezone=Europe/Kyiv&from_me=1", "host": [ "{{base_url}}" ], "path": [ "messages" ], "query": [ { "key": "date_from", "value": "2026-09-09", "description": "Required. Start of the range. `YYYY-MM-DD` covers the whole day; a full ISO-8601 datetime (e.g. `2026-09-09T08:00:00+03:00`) is an exact, inclusive bound." }, { "key": "date_to", "value": "2026-09-09", "description": "Required. End of the range. `YYYY-MM-DD` covers the whole day (`date_from=date_to` is one full day); a full ISO-8601 datetime is an exact, inclusive bound. Must not be before `date_from`." }, { "key": "timezone", "value": "Europe/Kyiv", "description": "Optional, default `UTC`. IANA timezone used to read bare dates and to format every `message_date` (always returned with its offset)." }, { "key": "from_me", "value": "1", "description": "Optional. `1`/`true` = outgoing only, `0`/`false` = incoming only. Omit for both directions." }, { "key": "sent_by", "value": "live_chat", "description": "Optional. Only messages from this source: `live_chat`, `bot`, `api`, `mcp`, `send_bulk`, `zapier`, `salla`, `zid`, `woocommerce`, `shopify`, `hubspot`, `pipedrive`, `stripe`, `magento`, `agent`.", "disabled": true }, { "key": "phone", "value": "{{phone}}", "description": "Optional. Only messages with this customer (international format, digits; a leading `+` is accepted).", "disabled": true }, { "key": "limit", "value": "50", "description": "Optional. Page size, default 50, maximum 200.", "disabled": true }, { "key": "cursor", "value": "", "description": "Optional. Pass `next_cursor` from the previous response, unchanged, to get the next page. A `null` `next_cursor` means there are no more pages.", "disabled": true } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"Status\": true,\n \"timezone\": \"Europe/Kyiv\",\n \"data\": [\n {\n \"id\": 4812,\n \"message_id\": \"wamid.HBgMMzgwOTM1MDAwMDAxFQIAERgSN0Y0QjM2QjI5RjA1MDFEQjQ4AA==\",\n \"from_me\": true,\n \"sent_by\": \"live_chat\",\n \"agent\": {\n \"id\": 3,\n \"name\": \"Olena (Sales)\"\n },\n \"contact\": {\n \"id\": 127,\n \"phone\": \"380935000001\",\n \"chat_id\": \"380935000001@s.whatsapp.net\",\n \"name\": \"Customer name\"\n },\n \"group_id\": null,\n \"type\": \"text\",\n \"body\": \"Good afternoon! The 20 kg epoxy kit ships tomorrow.\",\n \"caption\": null,\n \"attachment\": null,\n \"status\": 3,\n \"status_text\": \"Viewed\",\n \"message_date\": \"2026-09-09T12:45:49+03:00\"\n },\n {\n \"id\": 4815,\n \"message_id\": \"wamid.HBgMMzgwOTM1MDAwMDAxFQIAERgSQzE5RDA4NjM0MzhFRkY3M0Q1AA==\",\n \"from_me\": true,\n \"sent_by\": \"live_chat\",\n \"agent\": {\n \"id\": 3,\n \"name\": \"Olena (Sales)\"\n },\n \"contact\": {\n \"id\": 127,\n \"phone\": \"380935000001\",\n \"chat_id\": \"380935000001@s.whatsapp.net\",\n \"name\": \"Customer name\"\n },\n \"group_id\": null,\n \"type\": \"image\",\n \"body\": null,\n \"caption\": \"Colour sample\",\n \"attachment\": {\n \"url\": \"https://example.com/media/sample.jpg\",\n \"mimetype\": \"image/jpeg\"\n },\n \"status\": 2,\n \"status_text\": \"Delivered\",\n \"message_date\": \"2026-09-09T13:14:51+03:00\"\n }\n ],\n \"next_cursor\": \"eyJkIjoiMjAyNi0wOS0wOSAxMzoxNDo1MSIsImkiOjQ4MTV9\"\n}" }, { "name": "422 — date_to before date_from", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/messages?date_from=2026-09-09&date_to=2026-09-08&timezone=Europe/Kyiv&from_me=1", "host": [ "{{base_url}}" ], "path": [ "messages" ], "query": [ { "key": "date_from", "value": "2026-09-09", "description": "Required. Start of the range. `YYYY-MM-DD` covers the whole day; a full ISO-8601 datetime (e.g. `2026-09-09T08:00:00+03:00`) is an exact, inclusive bound." }, { "key": "date_to", "value": "2026-09-08", "description": "Required. End of the range. `YYYY-MM-DD` covers the whole day (`date_from=date_to` is one full day); a full ISO-8601 datetime is an exact, inclusive bound. Must not be before `date_from`." }, { "key": "timezone", "value": "Europe/Kyiv", "description": "Optional, default `UTC`. IANA timezone used to read bare dates and to format every `message_date` (always returned with its offset)." }, { "key": "from_me", "value": "1", "description": "Optional. `1`/`true` = outgoing only, `0`/`false` = incoming only. Omit for both directions." }, { "key": "sent_by", "value": "live_chat", "description": "Optional. Only messages from this source: `live_chat`, `bot`, `api`, `mcp`, `send_bulk`, `zapier`, `salla`, `zid`, `woocommerce`, `shopify`, `hubspot`, `pipedrive`, `stripe`, `magento`, `agent`.", "disabled": true }, { "key": "phone", "value": "{{phone}}", "description": "Optional. Only messages with this customer (international format, digits; a leading `+` is accepted).", "disabled": true }, { "key": "limit", "value": "50", "description": "Optional. Page size, default 50, maximum 200.", "disabled": true }, { "key": "cursor", "value": "", "description": "Optional. Pass `next_cursor` from the previous response, unchanged, to get the next page. A `null` `next_cursor` means there are no more pages.", "disabled": true } ] } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"Status\": false,\n \"Message\": \"The date to must not be before the date from.\",\n \"errors\": {}\n}" }, { "name": "422 — date_from missing", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/messages?date_to=2026-09-09&timezone=Europe/Kyiv&from_me=1", "host": [ "{{base_url}}" ], "path": [ "messages" ], "query": [ { "key": "date_from", "value": "2026-09-09", "description": "Required. Start of the range. `YYYY-MM-DD` covers the whole day; a full ISO-8601 datetime (e.g. `2026-09-09T08:00:00+03:00`) is an exact, inclusive bound.", "disabled": true }, { "key": "date_to", "value": "2026-09-09", "description": "Required. End of the range. `YYYY-MM-DD` covers the whole day (`date_from=date_to` is one full day); a full ISO-8601 datetime is an exact, inclusive bound. Must not be before `date_from`." }, { "key": "timezone", "value": "Europe/Kyiv", "description": "Optional, default `UTC`. IANA timezone used to read bare dates and to format every `message_date` (always returned with its offset)." }, { "key": "from_me", "value": "1", "description": "Optional. `1`/`true` = outgoing only, `0`/`false` = incoming only. Omit for both directions." }, { "key": "sent_by", "value": "live_chat", "description": "Optional. Only messages from this source: `live_chat`, `bot`, `api`, `mcp`, `send_bulk`, `zapier`, `salla`, `zid`, `woocommerce`, `shopify`, `hubspot`, `pipedrive`, `stripe`, `magento`, `agent`.", "disabled": true }, { "key": "phone", "value": "{{phone}}", "description": "Optional. Only messages with this customer (international format, digits; a leading `+` is accepted).", "disabled": true }, { "key": "limit", "value": "50", "description": "Optional. Page size, default 50, maximum 200.", "disabled": true }, { "key": "cursor", "value": "", "description": "Optional. Pass `next_cursor` from the previous response, unchanged, to get the next page. A `null` `next_cursor` means there are no more pages.", "disabled": true } ] } }, "status": "Unprocessable Entity", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"Status\": false,\n \"Message\": \"The date from field is required.\",\n \"errors\": {\n \"date_from\": [\n \"The date from field is required.\"\n ]\n }\n}" }, { "name": "401 — wrong or missing lb_api_key", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/messages?date_from=2026-09-09&date_to=2026-09-09&timezone=Europe/Kyiv&from_me=1", "host": [ "{{base_url}}" ], "path": [ "messages" ], "query": [ { "key": "date_from", "value": "2026-09-09", "description": "Required. Start of the range. `YYYY-MM-DD` covers the whole day; a full ISO-8601 datetime (e.g. `2026-09-09T08:00:00+03:00`) is an exact, inclusive bound." }, { "key": "date_to", "value": "2026-09-09", "description": "Required. End of the range. `YYYY-MM-DD` covers the whole day (`date_from=date_to` is one full day); a full ISO-8601 datetime is an exact, inclusive bound. Must not be before `date_from`." }, { "key": "timezone", "value": "Europe/Kyiv", "description": "Optional, default `UTC`. IANA timezone used to read bare dates and to format every `message_date` (always returned with its offset)." }, { "key": "from_me", "value": "1", "description": "Optional. `1`/`true` = outgoing only, `0`/`false` = incoming only. Omit for both directions." }, { "key": "sent_by", "value": "live_chat", "description": "Optional. Only messages from this source: `live_chat`, `bot`, `api`, `mcp`, `send_bulk`, `zapier`, `salla`, `zid`, `woocommerce`, `shopify`, `hubspot`, `pipedrive`, `stripe`, `magento`, `agent`.", "disabled": true }, { "key": "phone", "value": "{{phone}}", "description": "Optional. Only messages with this customer (international format, digits; a leading `+` is accepted).", "disabled": true }, { "key": "limit", "value": "50", "description": "Optional. Page size, default 50, maximum 200.", "disabled": true }, { "key": "cursor", "value": "", "description": "Optional. Pass `next_cursor` from the previous response, unchanged, to get the next page. A `null` `next_cursor` means there are no more pages.", "disabled": true } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"Status\": false,\n \"Message\": \"lb_api_key Incorrect\"\n}" }, { "name": "402 — API add-on not active", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" } ], "url": { "raw": "{{base_url}}/messages?date_from=2026-09-09&date_to=2026-09-09&timezone=Europe/Kyiv&from_me=1", "host": [ "{{base_url}}" ], "path": [ "messages" ], "query": [ { "key": "date_from", "value": "2026-09-09", "description": "Required. Start of the range. `YYYY-MM-DD` covers the whole day; a full ISO-8601 datetime (e.g. `2026-09-09T08:00:00+03:00`) is an exact, inclusive bound." }, { "key": "date_to", "value": "2026-09-09", "description": "Required. End of the range. `YYYY-MM-DD` covers the whole day (`date_from=date_to` is one full day); a full ISO-8601 datetime is an exact, inclusive bound. Must not be before `date_from`." }, { "key": "timezone", "value": "Europe/Kyiv", "description": "Optional, default `UTC`. IANA timezone used to read bare dates and to format every `message_date` (always returned with its offset)." }, { "key": "from_me", "value": "1", "description": "Optional. `1`/`true` = outgoing only, `0`/`false` = incoming only. Omit for both directions." }, { "key": "sent_by", "value": "live_chat", "description": "Optional. Only messages from this source: `live_chat`, `bot`, `api`, `mcp`, `send_bulk`, `zapier`, `salla`, `zid`, `woocommerce`, `shopify`, `hubspot`, `pipedrive`, `stripe`, `magento`, `agent`.", "disabled": true }, { "key": "phone", "value": "{{phone}}", "description": "Optional. Only messages with this customer (international format, digits; a leading `+` is accepted).", "disabled": true }, { "key": "limit", "value": "50", "description": "Optional. Page size, default 50, maximum 200.", "disabled": true }, { "key": "cursor", "value": "", "description": "Optional. Pass `next_cursor` from the previous response, unchanged, to get the next page. A `null` `next_cursor` means there are no more pages.", "disabled": true } ] } }, "status": "Payment Required", "code": 402, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"Status\": false,\n \"Message\": \"API access is not included in your current subscription. Please upgrade your plan or add the API addon.\",\n \"error_code\": \"API_ADDON_REQUIRED\"\n}" } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{lb_api_key}}", "type": "string" } ] }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "" ] } }, { "listen": "test", "script": { "type": "text/javascript", "exec": [ "" ] } } ], "variable": [ { "key": "base_url", "value": "https://letsbot.net/api/v1", "type": "string" }, { "key": "phone", "value": "9665xxxxxxxx", "type": "string" }, { "key": "lb_api_key", "value": "", "type": "string" } ] }