{"info":{"_postman_id":"64be5316-28db-4f24-b733-bd9b379c8ea9","name":"BotBee WhatsApp API v1","description":"<html><head></head><body><h2 id=\"botbee-whatsapp-api-v1\">BotBee WhatsApp API v1</h2>\n<p>A complete, categorized collection covering BotBee's WhatsApp Business API: messaging (text/interactive/media), templates, conversations, bot flows, subscriber/contact management, labels, and product catalog &amp; orders.</p>\n<h3 id=\"getting-started\">Getting started</h3>\n<ol>\n<li>Select the <strong>BotBee WhatsApp API v1 - Environment</strong> in the top-right dropdown.</li>\n<li>Click the eye icon → Edit, and set:<ul>\n<li><code>api_token</code> → your BotBee API key (Settings → API in your BotBee dashboard)</li>\n<li><code>phone_number_id</code> → the WhatsApp phone number ID you want to act on</li>\n<li><code>subscriber_phone_number</code> → a test subscriber's number (country code + digits, no <code>+</code>)</li>\n<li><code>base_url</code> is already pre-filled to <code>https://app.botbee.io/api/v1</code></li>\n</ul>\n</li>\n</ol>\n<h3 id=\"automation-built-into-this-collection\">Automation built into this collection</h3>\n<ul>\n<li><strong><code>apiToken</code> is auto-injected.</strong> A collection-level <em>pre-request script</em> reads <code>api_token</code> from your environment and adds it to every request's body (POST) or query string (GET) automatically — you never need to type it into an individual request.</li>\n<li><strong>Every folder auto-validates responses.</strong> Each folder has a <em>test script</em> that runs after every request and checks: HTTP 200, valid JSON, BotBee's own <code>status</code> field indicates success, and response time is under 3s. Results show as green ✅ / red ❌ under each request, and roll up when you run the whole collection via <strong>Collection Runner</strong> or <strong>Newman</strong> (CLI).</li>\n</ul>\n<h3 id=\"notes\">Notes</h3>\n<ul>\n<li>All phone numbers, tokens, IDs, and media URLs in this collection are <strong>placeholders</strong>. Replace them with your own values before sending requests.</li>\n<li>Endpoints marked <em>(no undo)</em> modify live data — double check parameters before sending.</li>\n</ul>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"37196194","collectionId":"64be5316-28db-4f24-b733-bd9b379c8ea9","publishedId":"2sBY4VJwxX","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"25D366"},"publishDate":"2026-08-06T04:22:51.000Z"},"item":[{"name":"1. Messaging","item":[{"name":"Send Text Message","id":"ec50acc4-3123-4f26-b79e-49505b6ad9bd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"message","value":"Hello! This is a test message from BotBee.","description":"<p>Text message content</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Recipient number incl. country code, digits only</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/send","description":"<p>Sends a free-form <strong>session</strong> text message. Only works within the 24-hour customer service window opened by the subscriber's last inbound message. Outside that window, use an approved Template Message instead.</p>\n","urlObject":{"path":["whatsapp","send"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"9f39e7de-7fdb-4817-b485-b751d1fbd0c4","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"message","value":"Hello! This is a test message from BotBee.","description":"Text message content","type":"text"},{"key":"phone_number","value":"911234567890","description":"Recipient number incl. country code, digits only","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/send","description":"Sends a free-form **session** text message. Only works within the 24-hour customer service window opened by the subscriber's last inbound message. Outside that window, use an approved Template Message instead."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"wa_message_id\": \"wamid.EXAMPLE0000000000000000000000000000000000000\",\n  \"message\": \"Message sent successfully.\"\n}"}],"_postman_id":"ec50acc4-3123-4f26-b79e-49505b6ad9bd"},{"name":"Send Interactive Buttons","id":"5d01fb1b-7e2d-456d-b667-1e9309086c8a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Recipient number incl. country code</p>\n","type":"text"},{"key":"message","value":"Would you like to continue?","description":"<p>Message body shown above the buttons</p>\n","type":"text"},{"key":"buttons","value":"[{\"id\":\"buy_now\",\"title\":\"Buy Now\"},{\"id\":\"details\",\"title\":\"View Details\"}]","description":"<p>JSON array of 1–3 buttons: string or {id, title}</p>\n","type":"text"},{"key":"button_header_text","value":"Product Update","description":"<p>Optional text header (ignored if a media header is used)</p>\n","type":"text"},{"key":"button_footer_text","value":"Tap an option","description":"<p>Optional footer text</p>\n","type":"text"},{"key":"media_url","value":"","description":"<p>Public HTTPS URL for an image/video/document header (optional)</p>\n","type":"text","disabled":true},{"key":"media_id","value":"","description":"<p>WhatsApp media id from Upload Media API (optional, alt. to media_url)</p>\n","type":"text","disabled":true},{"key":"media_type","value":"","description":"<p>image | video | document — required if using media_id or extension-less media_url</p>\n","type":"text","disabled":true},{"key":"media_name","value":"","description":"<p>Filename to display when media_type=document</p>\n","type":"text","disabled":true}]},"url":"https://app.botbee.io/api/v1/whatsapp/send/interactive-buttons","description":"<p>Sends a session message with 1–3 quick-reply buttons. Optionally attaches an image, video, or document as the header via <code>media_url</code> or <code>media_id</code> (+ <code>media_type</code>). Each button title is limited to 20 characters.</p>\n","urlObject":{"path":["whatsapp","send","interactive-buttons"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"62b81d13-9cfa-4523-b5f7-8e6929f5d57d","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Recipient number incl. country code","type":"text"},{"key":"message","value":"Would you like to continue?","description":"Message body shown above the buttons","type":"text"},{"key":"buttons","value":"[{\"id\":\"buy_now\",\"title\":\"Buy Now\"},{\"id\":\"details\",\"title\":\"View Details\"}]","description":"JSON array of 1–3 buttons: string or {id, title}","type":"text"},{"key":"button_header_text","value":"Product Update","description":"Optional text header (ignored if a media header is used)","type":"text"},{"key":"button_footer_text","value":"Tap an option","description":"Optional footer text","type":"text"},{"key":"media_url","value":"","description":"Public HTTPS URL for an image/video/document header (optional)","type":"text","disabled":true},{"key":"media_id","value":"","description":"WhatsApp media id from Upload Media API (optional, alt. to media_url)","type":"text","disabled":true},{"key":"media_type","value":"","description":"image | video | document — required if using media_id or extension-less media_url","type":"text","disabled":true},{"key":"media_name","value":"","description":"Filename to display when media_type=document","type":"text","disabled":true}]},"url":"https://app.botbee.io/api/v1/whatsapp/send/interactive-buttons","description":"Sends a session message with 1–3 quick-reply buttons. Optionally attaches an image, video, or document as the header via `media_url` or `media_id` (+ `media_type`). Each button title is limited to 20 characters."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"wa_message_id\": \"wamid.EXAMPLE0000000000000000000000000000000000000\",\n  \"message\": \"Message sent successfully.\"\n}"}],"_postman_id":"5d01fb1b-7e2d-456d-b667-1e9309086c8a"},{"name":"Send File / Media","id":"24654f63-bc60-44ee-8e80-2b6d26a680a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Recipient number incl. country code</p>\n","type":"text"},{"key":"media_url","value":"https://example.com/assets/sample-image.png","description":"<p>Public HTTPS URL of the file</p>\n","type":"text"},{"key":"media_id","value":"","description":"<p>WhatsApp media id (alternative to media_url)</p>\n","type":"text","disabled":true},{"key":"media_type","value":"image","description":"<p>image | video | audio | document</p>\n","type":"text"},{"key":"media_caption_text","value":"Sample caption","description":"<p>Caption for image/video/document (not audio)</p>\n","type":"text","disabled":true}]},"url":"https://app.botbee.io/api/v1/whatsapp/send/file","description":"<p>Sends an image, video, audio, or document. Provide either <code>media_url</code> (a public HTTPS link WhatsApp can download from) <strong>or</strong> <code>media_id</code> (from Upload Media API) — at least one is required.</p>\n","urlObject":{"path":["whatsapp","send","file"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"24bc7d5e-abb2-44bc-82a2-47aaa7077ebc","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Recipient number incl. country code","type":"text"},{"key":"media_url","value":"https://example.com/assets/sample-image.png","description":"Public HTTPS URL of the file","type":"text"},{"key":"media_id","value":"","description":"WhatsApp media id (alternative to media_url)","type":"text","disabled":true},{"key":"media_type","value":"image","description":"image | video | audio | document","type":"text"},{"key":"media_caption_text","value":"Sample caption","description":"Caption for image/video/document (not audio)","type":"text","disabled":true}]},"url":"https://app.botbee.io/api/v1/whatsapp/send/file","description":"Sends an image, video, audio, or document. Provide either `media_url` (a public HTTPS link WhatsApp can download from) **or** `media_id` (from Upload Media API) — at least one is required."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"wa_message_id\": \"wamid.EXAMPLE0000000000000000000000000000000000000\",\n  \"message\": \"Message sent successfully.\"\n}"}],"_postman_id":"24654f63-bc60-44ee-8e80-2b6d26a680a2"},{"name":"Upload Media","id":"27ef890b-9ff5-496f-90df-7435feb743a1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer YOUR_BOTBEE_API_KEY","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"phone_number_id","description":"<p>WhatsApp sender phone number ID (media is scoped to this number)</p>\n","type":"text","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"},{"key":"media_file","description":"<p>The file to upload — form field name must be media_file</p>\n","type":"file","value":null}]},"url":"https://app.botbee.io/api/v1/whatsapp/upload/media","description":"<p>Uploads a local file (multipart/form-data) and returns a <code>media_id</code> + <code>media_type</code> you can then pass to <strong>Send File / Media</strong> or <strong>Send Interactive Buttons</strong> instead of a public URL. Auth can be sent as <code>apiToken</code> field or <code>Authorization: Bearer</code> header.</p>\n","urlObject":{"path":["whatsapp","upload","media"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"76cb4d53-097c-4e90-874e-40d0ad8cadc3","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer YOUR_BOTBEE_API_KEY","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"phone_number_id","description":"WhatsApp sender phone number ID (media is scoped to this number)","type":"text","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"},{"key":"media_file","description":"The file to upload — form field name must be media_file","type":"file","src":[]}]},"url":"https://app.botbee.io/api/v1/whatsapp/upload/media","description":"Uploads a local file (multipart/form-data) and returns a `media_id` + `media_type` you can then pass to **Send File / Media** or **Send Interactive Buttons** instead of a public URL. Auth can be sent as `apiToken` field or `Authorization: Bearer` header."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"media_id\": \"0000000000000000\",\n  \"media_type\": \"image\",\n  \"message\": \"Upload successful. Use media_id and media_type with the Send File API.\"\n}"}],"_postman_id":"27ef890b-9ff5-496f-90df-7435feb743a1"}],"id":"d5a9d7f0-6586-4fe6-a0f3-54ac9ecee61d","description":"<p>Send text messages, interactive button messages, and media/files via WhatsApp.</p>\n","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Auto-validates every request in this folder.","pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response is valid JSON', function () {","    pm.response.to.be.json;","});","","pm.test('BotBee status indicates success', function () {","    const json = pm.response.json();","    // BotBee returns status as \"1\", 1, or true depending on endpoint","    pm.expect([\"1\", 1, true].includes(json.status)).to.be.true;","});","","pm.test('Response time is under 3s', function () {","    pm.expect(pm.response.responseTime).to.be.below(3000);","});"],"id":"4e6ca48a-fc63-4865-8891-d567f5034f45"}}],"_postman_id":"d5a9d7f0-6586-4fe6-a0f3-54ac9ecee61d"},{"name":"2. Templates, Conversations & Status","item":[{"name":"List Message Templates","id":"53362768-8f6c-413a-adf9-89caa996c957","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://app.botbee.io/api/v1/whatsapp/template/list?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Returns all WhatsApp message templates (Marketing/Utility/Authentication) registered under the given phone number, including approval status and variable maps. Use the <code>template_name</code> in your own template-send flow.</p>\n","urlObject":{"path":["whatsapp","template","list"],"host":["https://app.botbee.io/api/v1"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"}],"variable":[]}},"response":[{"id":"7106deef-2358-4f01-9d65-3445e1946a09","name":"Sample Success Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://app.botbee.io/api/v1/whatsapp/template/list?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID","host":["https://app.botbee.io/api/v1"],"path":["whatsapp","template","list"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"}]},"description":"Returns all WhatsApp message templates (Marketing/Utility/Authentication) registered under the given phone number, including approval status and variable maps. Use the `template_name` in your own template-send flow."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": {\n    \"id\": 1001,\n    \"template_id\": \"0000000000000000\",\n    \"template_name\": \"order_confirmation\",\n    \"template_type\": \"single\",\n    \"template_category\": \"Utility\",\n    \"locale\": \"en_US\",\n    \"header_type\": \"none\",\n    \"body_content\": \"Hello {{1}}, your order has been confirmed.\",\n    \"status\": \"Approved\"\n  }\n}"}],"_postman_id":"53362768-8f6c-413a-adf9-89caa996c957"},{"name":"Get Conversation","id":"9e6a5174-0c39-4702-88d8-844bfd21baaa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://app.botbee.io/api/v1/whatsapp/get/conversation?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID&phone_number=911234567890&limit=10&offset=1","description":"<p>Fetches paginated message history (inbound + outbound) for a single subscriber, ordered by <code>conversation_time</code>.</p>\n","urlObject":{"path":["whatsapp","get","conversation"],"host":["https://app.botbee.io/api/v1"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"},{"key":"phone_number","value":"911234567890"},{"key":"limit","value":"10"},{"key":"offset","value":"1"}],"variable":[]}},"response":[{"id":"5775843d-5cf6-4820-b1fe-b7aa6e3dffea","name":"Sample Success Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://app.botbee.io/api/v1/whatsapp/get/conversation?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID&phone_number=911234567890&limit=10&offset=1","host":["https://app.botbee.io/api/v1"],"path":["whatsapp","get","conversation"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"},{"key":"phone_number","value":"911234567890"},{"key":"limit","value":"10"},{"key":"offset","value":"1"}]},"description":"Fetches paginated message history (inbound + outbound) for a single subscriber, ordered by `conversation_time`."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": [\n    {\n      \"id\": 1,\n      \"whatsapp_bot_subscriber_subscriber_id\": \"SUBSCRIBER-CHATID\",\n      \"sender\": \"user\",\n      \"message_content\": \"{\\\"text\\\":{\\\"body\\\":\\\"hi\\\"},\\\"type\\\":\\\"text\\\"}\",\n      \"conversation_time\": \"2026-01-01 10:00:00\",\n      \"wa_message_id\": \"wamid.EXAMPLE\",\n      \"message_status\": null\n    },\n    {\n      \"id\": 2,\n      \"whatsapp_bot_subscriber_subscriber_id\": \"SUBSCRIBER-CHATID\",\n      \"sender\": \"bot\",\n      \"message_content\": \"{\\\"text\\\":{\\\"body\\\":\\\"Hello! How can I help?\\\"},\\\"type\\\":\\\"text\\\"}\",\n      \"conversation_time\": \"2026-01-01 10:00:01\",\n      \"wa_message_id\": \"wamid.EXAMPLE2\",\n      \"message_status\": \"read\"\n    }\n  ]\n}"}],"_postman_id":"9e6a5174-0c39-4702-88d8-844bfd21baaa"},{"name":"Get Post Back / Bot Flow List","id":"0d77bf46-756a-44b0-aac7-43ae316a41df","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://app.botbee.io/api/v1/whatsapp/get/post-back-list?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Returns the list of postback actions / bot flow steps configured for a phone number (quick replies, flow-builder campaigns, etc). Useful for mapping <code>postback_id</code> values seen in webhook payloads back to human-readable flow names.</p>\n","urlObject":{"path":["whatsapp","get","post-back-list"],"host":["https://app.botbee.io/api/v1"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"}],"variable":[]}},"response":[{"id":"4297215c-acdd-4936-963e-175b4aae28f7","name":"Sample Success Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://app.botbee.io/api/v1/whatsapp/get/post-back-list?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID","host":["https://app.botbee.io/api/v1"],"path":["whatsapp","get","post-back-list"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"}]},"description":"Returns the list of postback actions / bot flow steps configured for a phone number (quick replies, flow-builder campaigns, etc). Useful for mapping `postback_id` values seen in webhook payloads back to human-readable flow names."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": [\n    {\n      \"id\": 1,\n      \"postback_id\": \"YES_START_CHAT_WITH_HUMAN\",\n      \"bot_name\": \"Chat with human\",\n      \"template_for\": \"chat-with-human\",\n      \"status\": \"1\",\n      \"visual_flow_type\": \"flow\",\n      \"whatsapp_bot_visual_flow_builder_campaign_id\": 100001\n    }\n  ]\n}"}],"_postman_id":"0d77bf46-756a-44b0-aac7-43ae316a41df"},{"name":"Get Delivery Message Status","id":"40874e06-ece0-4d3d-be0c-59f346e0453d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://app.botbee.io/api/v1/whatsapp/get/message-status?wa_message_id=wamid.EXAMPLE0000000000000000000000000000000000000&whatsapp_bot_id=YOUR_WHATSAPP_BOT_ID","description":"<p>Looks up the delivery status (sent / delivered / read / failed) for a previously sent <code>wa_message_id</code>.</p>\n","urlObject":{"path":["whatsapp","get","message-status"],"host":["https://app.botbee.io/api/v1"],"query":[{"key":"wa_message_id","value":"wamid.EXAMPLE0000000000000000000000000000000000000"},{"key":"whatsapp_bot_id","value":"YOUR_WHATSAPP_BOT_ID"}],"variable":[]}},"response":[{"id":"3edd78b7-4a4b-4881-ae71-19b7d8fc9c8b","name":"Sample Success Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://app.botbee.io/api/v1/whatsapp/get/message-status?wa_message_id=wamid.EXAMPLE0000000000000000000000000000000000000&whatsapp_bot_id=YOUR_WHATSAPP_BOT_ID","host":["https://app.botbee.io/api/v1"],"path":["whatsapp","get","message-status"],"query":[{"key":"wa_message_id","value":"wamid.EXAMPLE0000000000000000000000000000000000000"},{"key":"whatsapp_bot_id","value":"YOUR_WHATSAPP_BOT_ID"}]},"description":"Looks up the delivery status (sent / delivered / read / failed) for a previously sent `wa_message_id`."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": {\n    \"message_status\": \"delivered\",\n    \"delivery_status_updated_at\": \"2026-01-01 10:00:05\",\n    \"read_time\": null,\n    \"failed_time\": null,\n    \"failed_reason\": \"\"\n  }\n}"}],"_postman_id":"40874e06-ece0-4d3d-be0c-59f346e0453d"}],"id":"4c948dc2-3eb6-4548-a012-31416e3fa2b9","description":"<p>Read message templates, conversation history, postback/bot-flow definitions, and delivery status.</p>\n","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Auto-validates every request in this folder.","pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response is valid JSON', function () {","    pm.response.to.be.json;","});","","pm.test('BotBee status indicates success', function () {","    const json = pm.response.json();","    // BotBee returns status as \"1\", 1, or true depending on endpoint","    pm.expect([\"1\", 1, true].includes(json.status)).to.be.true;","});","","pm.test('Response time is under 3s', function () {","    pm.expect(pm.response.responseTime).to.be.below(3000);","});"],"id":"4fda1699-b188-4dd5-811a-5e08daed371a"}}],"_postman_id":"4c948dc2-3eb6-4548-a012-31416e3fa2b9"},{"name":"3. Bot Flow","item":[{"name":"Trigger Bot Flow","id":"5b460375-fceb-4a55-84ef-ae98560abf3f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"bot_flow_unique_id","value":"YOUR_BOT_FLOW_UNIQUE_ID","description":"<p>Unique ID of the bot flow to trigger</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Recipient number incl. country code</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/trigger-bot","description":"<p>Triggers a specific bot flow (identified by <code>bot_flow_unique_id</code>) for the given phone number, as if the subscriber had clicked the matching button/postback.</p>\n","urlObject":{"path":["whatsapp","trigger-bot"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"d7711d88-b7a7-401f-a89a-33adba26d365","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"bot_flow_unique_id","value":"YOUR_BOT_FLOW_UNIQUE_ID","description":"Unique ID of the bot flow to trigger","type":"text"},{"key":"phone_number","value":"911234567890","description":"Recipient number incl. country code","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/trigger-bot","description":"Triggers a specific bot flow (identified by `bot_flow_unique_id`) for the given phone number, as if the subscriber had clicked the matching button/postback."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Bot has been trigger successfully.\"\n}"}],"_postman_id":"5b460375-fceb-4a55-84ef-ae98560abf3f"}],"id":"b3911678-d14e-4c6a-aedd-b23aa7999c41","description":"<p>Programmatically trigger a configured bot/flow for a subscriber.</p>\n","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Auto-validates every request in this folder.","pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response is valid JSON', function () {","    pm.response.to.be.json;","});","","pm.test('BotBee status indicates success', function () {","    const json = pm.response.json();","    // BotBee returns status as \"1\", 1, or true depending on endpoint","    pm.expect([\"1\", 1, true].includes(json.status)).to.be.true;","});","","pm.test('Response time is under 3s', function () {","    pm.expect(pm.response.responseTime).to.be.below(3000);","});"],"id":"2aef0caa-ae0f-4c07-ba70-9521086f2cbb"}}],"_postman_id":"b3911678-d14e-4c6a-aedd-b23aa7999c41"},{"name":"4. Subscribers & Contacts","item":[{"name":"Get Subscriber","id":"2914ca3e-4d84-4a68-9a6f-11952efbaff8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Subscriber phone number</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/get","description":"<p>Fetches a single subscriber/contact by phone number.</p>\n","urlObject":{"path":["whatsapp","subscriber","get"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"6ea13cc4-7a2e-4782-8e4c-24d5683701c5","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Subscriber phone number","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/get","description":"Fetches a single subscriber/contact by phone number."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": [\n    {\n      \"subscriber_id\": 100001,\n      \"chat_id\": \"SUBSCRIBER-CHATID\",\n      \"first_name\": \"Jane\",\n      \"last_name\": \"Doe\",\n      \"email\": null,\n      \"gender\": null,\n      \"created_at\": \"2026-01-01 10:00:00\",\n      \"assigned_agent_id\": null,\n      \"bot_reply_label\": \"Bot Reply On\",\n      \"ai_reply_label\": \"AI Reply On\",\n      \"label_names\": null\n    }\n  ]\n}"}],"_postman_id":"2914ca3e-4d84-4a68-9a6f-11952efbaff8"},{"name":"List Subscribers","id":"fdefe326-19fb-4be6-9c13-a98baa851bde","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/list?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID&limit=10&offset=1&orderBy=0","description":"<p>Returns a paginated list of subscribers for a phone number (up to 100 per page). Set <code>orderBy=1</code> to sort by most recent message first.</p>\n","urlObject":{"path":["whatsapp","subscriber","list"],"host":["https://app.botbee.io/api/v1"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"},{"key":"limit","value":"10"},{"key":"offset","value":"1"},{"key":"orderBy","value":"0"}],"variable":[]}},"response":[{"id":"bca34c65-46a8-4766-9d65-9b473495dd85","name":"Sample Success Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://app.botbee.io/api/v1/whatsapp/subscriber/list?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID&limit=10&offset=1&orderBy=0","host":["https://app.botbee.io/api/v1"],"path":["whatsapp","subscriber","list"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"},{"key":"limit","value":"10"},{"key":"offset","value":"1"},{"key":"orderBy","value":"0"}]},"description":"Returns a paginated list of subscribers for a phone number (up to 100 per page). Set `orderBy=1` to sort by most recent message first."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": [\n    {\n      \"subscriber_id\": 100001,\n      \"chat_id\": \"SUBSCRIBER-CHATID-1\",\n      \"first_name\": \"Jane\",\n      \"last_name\": \"Doe\",\n      \"label_names\": \"VIP\",\n      \"unseen_count\": 0,\n      \"last_message_time\": \"2026-01-01 10:00:00\"\n    },\n    {\n      \"subscriber_id\": 100002,\n      \"chat_id\": \"SUBSCRIBER-CHATID-2\",\n      \"first_name\": \"John\",\n      \"last_name\": \"Smith\",\n      \"label_names\": null,\n      \"unseen_count\": 2,\n      \"last_message_time\": \"2026-01-01 11:00:00\"\n    }\n  ]\n}"}],"_postman_id":"fdefe326-19fb-4be6-9c13-a98baa851bde"},{"name":"Create Subscriber","id":"1cae9a3a-c796-4004-870a-fabf8c7a5536","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phoneNumberID","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"name","value":"Test Subscriber","description":"<p>Subscriber display name</p>\n","type":"text"},{"key":"phoneNumber","value":"911234567890","description":"<p>Subscriber phone number incl. country code, no + sign</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/create","description":"<p>Creates a new subscriber/contact under the given WhatsApp phone number.</p>\n","urlObject":{"path":["whatsapp","subscriber","create"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"8f931503-6f90-4247-aa97-8dd7ae40fd44","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phoneNumberID","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"name","value":"Test Subscriber","description":"Subscriber display name","type":"text"},{"key":"phoneNumber","value":"911234567890","description":"Subscriber phone number incl. country code, no + sign","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/create","description":"Creates a new subscriber/contact under the given WhatsApp phone number."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"WhatsApp subscriber has been created.\"\n}"}],"_postman_id":"1cae9a3a-c796-4004-870a-fabf8c7a5536"},{"name":"Update Subscriber","id":"8b8c9711-cc13-42a8-bb4c-89f95f7a0909","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Subscriber phone number</p>\n","type":"text"},{"key":"first_name","value":"Jane","description":"<p>First name</p>\n","type":"text","disabled":true},{"key":"last_name","value":"Doe","description":"<p>Last name</p>\n","type":"text","disabled":true},{"key":"gender","value":"Female","description":"<p>Gender</p>\n","type":"text","disabled":true},{"key":"label_ids","value":"","description":"<p>Comma-separated label IDs, e.g. 1,4,5</p>\n","type":"text","disabled":true}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/update","description":"<p>Updates first/last name, gender, and/or label assignments for an existing subscriber.</p>\n","urlObject":{"path":["whatsapp","subscriber","update"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"16353d9f-33d0-42cb-be84-8b73a4cec8e2","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Subscriber phone number","type":"text"},{"key":"first_name","value":"Jane","description":"First name","type":"text","disabled":true},{"key":"last_name","value":"Doe","description":"Last name","type":"text","disabled":true},{"key":"gender","value":"Female","description":"Gender","type":"text","disabled":true},{"key":"label_ids","value":"","description":"Comma-separated label IDs, e.g. 1,4,5","type":"text","disabled":true}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/update","description":"Updates first/last name, gender, and/or label assignments for an existing subscriber."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Subscriber Updated Successfully.\"\n}"}],"_postman_id":"8b8c9711-cc13-42a8-bb4c-89f95f7a0909"},{"name":"Delete Subscriber","id":"7a9f329b-0607-4958-a6ca-48a1b17a0885","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Subscriber phone number to delete</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/delete","description":"<p>Permanently deletes a subscriber and their conversation history. <strong>This cannot be undone.</strong></p>\n","urlObject":{"path":["whatsapp","subscriber","delete"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"f9e49562-2ef5-46ca-90fd-0ca6d45ccbd2","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Subscriber phone number to delete","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/delete","description":"Permanently deletes a subscriber and their conversation history. **This cannot be undone.**"},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Subscriber has been deleted successfully.\"\n}"}],"_postman_id":"7a9f329b-0607-4958-a6ca-48a1b17a0885"},{"name":"Reset User Input Flow","id":"19f8f537-22e6-44c4-a430-9fc03b072f5e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Subscriber phone number</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/reset/user-input-flow","description":"<p>Resets a subscriber out of any in-progress \"user input flow\" step, so their next message is treated as a fresh conversation entry point.</p>\n","urlObject":{"path":["whatsapp","subscriber","reset","user-input-flow"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"c89ee53b-377c-4cc1-a8fd-a138bd53c8ed","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Subscriber phone number","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/reset/user-input-flow","description":"Resets a subscriber out of any in-progress \"user input flow\" step, so their next message is treated as a fresh conversation entry point."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Reset User Input Flow successfully.\"\n}"}],"_postman_id":"19f8f537-22e6-44c4-a430-9fc03b072f5e"},{"name":"Assign Chat to Team Member","id":"17a2178c-98d0-4819-8d6b-a74bf1a93edf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Subscriber phone number</p>\n","type":"text"},{"key":"team_member_id","value":"YOUR_TEAM_MEMBER_ID","description":"<p>ID of the team member / agent to assign</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/assign-to-team-member","description":"<p>Assigns a subscriber's live chat conversation to a specific team/agent user for handling.</p>\n","urlObject":{"path":["whatsapp","subscriber","chat","assign-to-team-member"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"b32dafbd-2abd-4bdf-bc76-de2eaf185154","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Subscriber phone number","type":"text"},{"key":"team_member_id","value":"YOUR_TEAM_MEMBER_ID","description":"ID of the team member / agent to assign","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/assign-to-team-member","description":"Assigns a subscriber's live chat conversation to a specific team/agent user for handling."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Successfully Assign Agent to Conversation.\"\n}"}],"_postman_id":"17a2178c-98d0-4819-8d6b-a74bf1a93edf"},{"name":"Assign Custom Fields to Subscriber","id":"2f64c639-1dc5-4a84-a115-3a137008e343","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Subscriber phone number</p>\n","type":"text"},{"key":"custom_fields","value":"{\"customer_name\":\"Jane Doe\",\"customer_email\":\"jane@example.com\"}","description":"<p>JSON object of custom field name/value pairs</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/assign-custom-fields","description":"<p>Sets one or more custom field values on a subscriber. Pass <code>custom_fields</code> as a JSON object of <code>{field_name: value}</code> pairs (field names must already exist — see <strong>List Custom Fields</strong>).</p>\n","urlObject":{"path":["whatsapp","subscriber","chat","assign-custom-fields"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"a6361397-6cf9-42ac-bee0-ff9aa3e5925f","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Subscriber phone number","type":"text"},{"key":"custom_fields","value":"{\"customer_name\":\"Jane Doe\",\"customer_email\":\"jane@example.com\"}","description":"JSON object of custom field name/value pairs","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/assign-custom-fields","description":"Sets one or more custom field values on a subscriber. Pass `custom_fields` as a JSON object of `{field_name: value}` pairs (field names must already exist — see **List Custom Fields**)."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Subscriber changes have been saved successfully.\"\n}"}],"_postman_id":"2f64c639-1dc5-4a84-a115-3a137008e343"},{"name":"List Custom Fields","id":"ef3caac1-3afb-4f0a-bbe5-84e73b43693a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/custom-fields/list","description":"<p>Returns every custom field defined on the account (id, name, and reply_type) — use this to know which field names are valid for <strong>Assign Custom Fields to Subscriber</strong>.</p>\n","urlObject":{"path":["whatsapp","subscriber","custom-fields","list"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"3af69856-2cfd-43fd-ae4e-397f0c0dc6c7","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/custom-fields/list","description":"Returns every custom field defined on the account (id, name, and reply_type) — use this to know which field names are valid for **Assign Custom Fields to Subscriber**."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Custom fields retrieved successfully\",\n  \"data\": [\n    {\n      \"id\": 1,\n      \"name\": \"customer_name\",\n      \"reply_type\": \"text\"\n    },\n    {\n      \"id\": 2,\n      \"name\": \"customer_email\",\n      \"reply_type\": \"email\"\n    }\n  ]\n}"}],"_postman_id":"ef3caac1-3afb-4f0a-bbe5-84e73b43693a"},{"name":"Assign Labels to Subscriber","id":"dc7d610f-722d-4f45-bc22-9ede09fd3274","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Subscriber phone number</p>\n","type":"text"},{"key":"label_ids","value":"1,2","description":"<p>Comma-separated label IDs, e.g. 1,4,5</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/assign-labels","description":"<p>Attaches one or more labels to a subscriber.</p>\n","urlObject":{"path":["whatsapp","subscriber","chat","assign-labels"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"841db7e9-e5c7-4527-811b-6d894a6df33f","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Subscriber phone number","type":"text"},{"key":"label_ids","value":"1,2","description":"Comma-separated label IDs, e.g. 1,4,5","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/assign-labels","description":"Attaches one or more labels to a subscriber."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Labels have been assigned successfully.\"\n}"}],"_postman_id":"dc7d610f-722d-4f45-bc22-9ede09fd3274"},{"name":"Remove Labels from Subscriber","id":"803267a1-ceec-490f-bcb3-ddf14981e7d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Subscriber phone number</p>\n","type":"text"},{"key":"label_ids","value":"1,2","description":"<p>Comma-separated label IDs, e.g. 1,4,5</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/remove-labels","description":"<p>Removes one or more labels from a subscriber.</p>\n","urlObject":{"path":["whatsapp","subscriber","chat","remove-labels"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"5887b265-db38-45c3-8ef2-1c41f9e94ae9","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Subscriber phone number","type":"text"},{"key":"label_ids","value":"1,2","description":"Comma-separated label IDs, e.g. 1,4,5","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/remove-labels","description":"Removes one or more labels from a subscriber."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Labels have been removed successfully.\"\n}"}],"_postman_id":"803267a1-ceec-490f-bcb3-ddf14981e7d7"},{"name":"Assign Sequences to Subscriber","id":"156bf277-8fb3-4093-b586-aac89eea505e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Subscriber phone number</p>\n","type":"text"},{"key":"sequence_ids","value":"1,2","description":"<p>Comma-separated sequence campaign IDs</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/assign-sequence","description":"<p>Enrols a subscriber into one or more broadcast/drip sequences.</p>\n","urlObject":{"path":["whatsapp","subscriber","chat","assign-sequence"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"7bde6ad4-7437-45c7-91f0-910589a7aa6d","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Subscriber phone number","type":"text"},{"key":"sequence_ids","value":"1,2","description":"Comma-separated sequence campaign IDs","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/assign-sequence","description":"Enrols a subscriber into one or more broadcast/drip sequences."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Sequences have been assigned successfully.\"\n}"}],"_postman_id":"156bf277-8fb3-4093-b586-aac89eea505e"},{"name":"Remove Sequences from Subscriber","id":"90ca9f5c-e549-4bad-94f4-49b3e0250028","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Subscriber phone number</p>\n","type":"text"},{"key":"sequence_ids","value":"1,2","description":"<p>Comma-separated sequence campaign IDs</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/remove-sequence","description":"<p>Removes a subscriber from one or more sequences.</p>\n","urlObject":{"path":["whatsapp","subscriber","chat","remove-sequence"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"bd7bf90c-8859-40d9-aa65-c7ee9fceba52","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Subscriber phone number","type":"text"},{"key":"sequence_ids","value":"1,2","description":"Comma-separated sequence campaign IDs","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/remove-sequence","description":"Removes a subscriber from one or more sequences."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Sequences have been removed successfully.\"\n}"}],"_postman_id":"90ca9f5c-e549-4bad-94f4-49b3e0250028"},{"name":"Add Note to Subscriber","id":"eff5264f-2c2d-4687-947f-0e8a3693e9e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Your WhatsApp sender phone number ID</p>\n","type":"text"},{"key":"phone_number","value":"911234567890","description":"<p>Subscriber phone number</p>\n","type":"text"},{"key":"note_text","value":"Followed up via phone call.","description":"<p>Note text</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/add-notes","description":"<p>Adds an internal note to a subscriber's chat (visible to your team only, not the customer).</p>\n","urlObject":{"path":["whatsapp","subscriber","chat","add-notes"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"f183d69c-1e3e-4607-94bc-f62683391ead","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"Your WhatsApp sender phone number ID","type":"text"},{"key":"phone_number","value":"911234567890","description":"Subscriber phone number","type":"text"},{"key":"note_text","value":"Followed up via phone call.","description":"Note text","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/subscriber/chat/add-notes","description":"Adds an internal note to a subscriber's chat (visible to your team only, not the customer)."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Notes have been added successfully.\"\n}"}],"_postman_id":"eff5264f-2c2d-4687-947f-0e8a3693e9e4"}],"id":"c91217cf-2c78-450d-9a5e-93d99c4c77a3","description":"<p>Create, read, update, delete subscribers, plus manage their labels, sequences, custom fields, notes, team assignment, and input-flow state.</p>\n","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Auto-validates every request in this folder.","pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response is valid JSON', function () {","    pm.response.to.be.json;","});","","pm.test('BotBee status indicates success', function () {","    const json = pm.response.json();","    // BotBee returns status as \"1\", 1, or true depending on endpoint","    pm.expect([\"1\", 1, true].includes(json.status)).to.be.true;","});","","pm.test('Response time is under 3s', function () {","    pm.expect(pm.response.responseTime).to.be.below(3000);","});"],"id":"84fbeba4-c169-4fb4-a7fa-3a2811c9f264"}}],"_postman_id":"c91217cf-2c78-450d-9a5e-93d99c4c77a3"},{"name":"5. Labels","item":[{"name":"List Labels","id":"6ada9c7f-5fac-405d-b651-52649352d0fa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://app.botbee.io/api/v1/whatsapp/label/list?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID","description":"<p>Returns all labels configured for a phone number.</p>\n","urlObject":{"path":["whatsapp","label","list"],"host":["https://app.botbee.io/api/v1"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"}],"variable":[]}},"response":[{"id":"ae1502f6-0922-4b73-be70-14a8d9dbad84","name":"Sample Success Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://app.botbee.io/api/v1/whatsapp/label/list?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID","host":["https://app.botbee.io/api/v1"],"path":["whatsapp","label","list"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"}]},"description":"Returns all labels configured for a phone number."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": [\n    {\n      \"id\": 1,\n      \"label_name\": \"VIP\",\n      \"status\": \"1\"\n    },\n    {\n      \"id\": 2,\n      \"label_name\": \"Follow Up\",\n      \"status\": \"1\"\n    }\n  ]\n}"}],"_postman_id":"6ada9c7f-5fac-405d-b651-52649352d0fa"},{"name":"Create Label","id":"25225abf-1175-470d-9e60-a558ca585c5b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://app.botbee.io/api/v1/whatsapp/label/create?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID&label_name=New Label","description":"<p>Creates a new label under a phone number.</p>\n","urlObject":{"path":["whatsapp","label","create"],"host":["https://app.botbee.io/api/v1"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"},{"key":"label_name","value":"New Label"}],"variable":[]}},"response":[{"id":"cd21777e-945f-4a76-9b7d-2287b2e418c9","name":"Sample Success Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://app.botbee.io/api/v1/whatsapp/label/create?phone_number_id=YOUR_WHATSAPP_PHONE_NUMBER_ID&label_name=New Label","host":["https://app.botbee.io/api/v1"],"path":["whatsapp","label","create"],"query":[{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"},{"key":"label_name","value":"New Label"}]},"description":"Creates a new label under a phone number."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Label has been created successfully.\"\n}"}],"_postman_id":"25225abf-1175-470d-9e60-a558ca585c5b"}],"id":"a58d823c-defc-4ec3-abab-27a3c67918f2","description":"<p>Create and list labels used to tag/segment subscribers.</p>\n","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Auto-validates every request in this folder.","pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response is valid JSON', function () {","    pm.response.to.be.json;","});","","pm.test('BotBee status indicates success', function () {","    const json = pm.response.json();","    // BotBee returns status as \"1\", 1, or true depending on endpoint","    pm.expect([\"1\", 1, true].includes(json.status)).to.be.true;","});","","pm.test('Response time is under 3s', function () {","    pm.expect(pm.response.responseTime).to.be.below(3000);","});"],"id":"96dbcb87-fa93-4122-8432-dbc490f43af7"}}],"_postman_id":"a58d823c-defc-4ec3-abab-27a3c67918f2"},{"name":"6. Catalog & Orders","item":[{"name":"List Catalogs","id":"8aa7b29a-419c-4e55-98ab-78114ddccd4c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://app.botbee.io/api/v1/whatsapp/catalog/list","description":"<p>Returns all product catalogs connected to the account.</p>\n","urlObject":{"path":["whatsapp","catalog","list"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"85f805d3-3d17-45e8-abcc-13b63bc45f05","name":"Sample Success Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://app.botbee.io/api/v1/whatsapp/catalog/list","description":"Returns all product catalogs connected to the account."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": true,\n  \"message\": [\n    {\n      \"catalog_id\": \"0000000000000000\",\n      \"catalog_name\": \"My Store Catalog\",\n      \"catalog_url\": \"https://wa.me/c/EXAMPLE\",\n      \"checkout_settings\": {\n        \"tax_percentage\": \"5.5\",\n        \"shipping_charge\": \"20\"\n      }\n    }\n  ]\n}"}],"_postman_id":"8aa7b29a-419c-4e55-98ab-78114ddccd4c"},{"name":"Sync Catalog","id":"9e9aff5f-0d7f-49bb-a785-6314effbd64f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"whatsapp_catalog_id","value":"YOUR_WHATSAPP_CATALOG_ID","description":"<p>Your WhatsApp catalog ID</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/catalog/sync","description":"<p>Re-syncs the product catalog from its connected data source (e.g. Shopify/feed) into WhatsApp. <strong>Touches your live catalog — use with care.</strong></p>\n","urlObject":{"path":["whatsapp","catalog","sync"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"6ac28780-cb5f-4187-9563-cfca8db6de7b","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"whatsapp_catalog_id","value":"YOUR_WHATSAPP_CATALOG_ID","description":"Your WhatsApp catalog ID","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/catalog/sync","description":"Re-syncs the product catalog from its connected data source (e.g. Shopify/feed) into WhatsApp. **Touches your live catalog — use with care.**"},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": \"Catalog products have been synced successfully.\"\n}"}],"_postman_id":"9e9aff5f-0d7f-49bb-a785-6314effbd64f"},{"name":"List Catalog Orders","id":"2ba714a5-2321-4ab4-8c31-abdee8e7c242","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://app.botbee.io/api/v1/whatsapp/catalog/order/list?whatsapp_catalog_id=YOUR_WHATSAPP_CATALOG_ID","description":"<p>Returns cart/checkout orders placed through the WhatsApp catalog, optionally filtered by <code>whatsapp_catalog_id</code>.</p>\n","urlObject":{"path":["whatsapp","catalog","order","list"],"host":["https://app.botbee.io/api/v1"],"query":[{"key":"whatsapp_catalog_id","value":"YOUR_WHATSAPP_CATALOG_ID"}],"variable":[]}},"response":[{"id":"4b627623-5a8b-47e5-8715-f1985734dc53","name":"Sample Success Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":{"raw":"https://app.botbee.io/api/v1/whatsapp/catalog/order/list?whatsapp_catalog_id=YOUR_WHATSAPP_CATALOG_ID","host":["https://app.botbee.io/api/v1"],"path":["whatsapp","catalog","order","list"],"query":[{"key":"whatsapp_catalog_id","value":"YOUR_WHATSAPP_CATALOG_ID"}]},"description":"Returns cart/checkout orders placed through the WhatsApp catalog, optionally filtered by `whatsapp_catalog_id`."},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": \"1\",\n  \"message\": [\n    {\n      \"order_unique_id\": \"0000000000000000000\",\n      \"catalog_id\": \"0000000000000000\",\n      \"chat_id\": \"SUBSCRIBER-CHATID\",\n      \"catalog_name\": \"My Store Catalog\",\n      \"first_name\": \"Jane\",\n      \"cart_total\": 580,\n      \"cart_currency\": \"INR\",\n      \"cart_status_raw\": \"Pending\",\n      \"ordered_at\": \"2026-01-01 10:00:00\",\n      \"payment_method\": null\n    }\n  ]\n}"}],"_postman_id":"2ba714a5-2321-4ab4-8c31-abdee8e7c242"},{"name":"Change Catalog Order Status","id":"aa3fe805-63fe-495f-82a0-07f69ecd27c9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"order_unique_id","value":"YOUR_ORDER_UNIQUE_ID","description":"<p>Catalog order unique ID</p>\n","type":"text"},{"key":"cart_status","value":"Approved","description":"<p>Approved | Completed | Shipped | Delivered | Refunded</p>\n","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/catalog/order/status-change","description":"<p>Updates the status of a catalog order. Allowed <code>cart_status</code> values: <code>Approved</code>, <code>Completed</code>, <code>Shipped</code>, <code>Delivered</code>, <code>Refunded</code>. <strong>No undo endpoint exists — use with care.</strong></p>\n","urlObject":{"path":["whatsapp","catalog","order","status-change"],"host":["https://app.botbee.io/api/v1"],"query":[],"variable":[]}},"response":[{"id":"4e3ceb46-ccf9-4f6f-9f00-ebd952f1e49b","name":"Sample Success Response","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"order_unique_id","value":"YOUR_ORDER_UNIQUE_ID","description":"Catalog order unique ID","type":"text"},{"key":"cart_status","value":"Approved","description":"Approved | Completed | Shipped | Delivered | Refunded","type":"text"}]},"url":"https://app.botbee.io/api/v1/whatsapp/catalog/order/status-change","description":"Updates the status of a catalog order. Allowed `cart_status` values: `Approved`, `Completed`, `Shipped`, `Delivered`, `Refunded`. **No undo endpoint exists — use with care.**"},"status":"200 OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"status\": true,\n  \"message\": \"Cart status has been updated successfully\"\n}"}],"_postman_id":"aa3fe805-63fe-495f-82a0-07f69ecd27c9"}],"id":"a4366767-5be0-44a2-b469-4995467a3e03","description":"<p>Manage WhatsApp product catalogs and read/update catalog-based orders (cart checkout flow).</p>\n","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Auto-validates every request in this folder.","pm.test('Status code is 200', function () {","    pm.response.to.have.status(200);","});","","pm.test('Response is valid JSON', function () {","    pm.response.to.be.json;","});","","pm.test('BotBee status indicates success', function () {","    const json = pm.response.json();","    // BotBee returns status as \"1\", 1, or true depending on endpoint","    pm.expect([\"1\", 1, true].includes(json.status)).to.be.true;","});","","pm.test('Response time is under 3s', function () {","    pm.expect(pm.response.responseTime).to.be.below(3000);","});"],"id":"ba4d111c-4514-4460-b562-effac4b8523f"}}],"_postman_id":"a4366767-5be0-44a2-b469-4995467a3e03"}],"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["// Auto-injects apiToken into every request in this collection,","// so it doesn't need to be typed into each request's body/query.","const token = pm.variables.get('api_token');","","if (!token || token === 'YOUR_BOTBEE_API_KEY') {","    console.warn('api_token is not set — open the BotBee API environment and set it.');","}","","// GET requests: add/overwrite apiToken as a query param","if (pm.request.method === 'GET') {","    pm.request.url.query.upsert({ key: 'apiToken', value: token });","}","","// POST requests with a form body: add/overwrite apiToken as a body field","if (pm.request.body && pm.request.body.mode === 'urlencoded') {","    pm.request.body.urlencoded.upsert({ key: 'apiToken', value: token });","}","","// Multipart (Upload Media) uses an Authorization: Bearer header instead — already set on that request."],"id":"24640825-3279-47b6-a0f6-ce85b5e7ebd9"}}],"variable":[{"key":"base_url","value":"https://app.botbee.io/api/v1"},{"key":"api_token","value":"YOUR_BOTBEE_API_KEY"},{"key":"phone_number_id","value":"YOUR_WHATSAPP_PHONE_NUMBER_ID"},{"key":"subscriber_phone_number","value":"911234567890"},{"key":"wa_message_id","value":"wamid.EXAMPLE0000000000000000000000000000000000000"},{"key":"whatsapp_bot_id","value":"YOUR_WHATSAPP_BOT_ID"},{"key":"bot_flow_unique_id","value":"YOUR_BOT_FLOW_UNIQUE_ID"},{"key":"team_member_id","value":"YOUR_TEAM_MEMBER_ID"},{"key":"label_ids","value":"1,2"},{"key":"sequence_ids","value":"1,2"},{"key":"whatsapp_catalog_id","value":"YOUR_WHATSAPP_CATALOG_ID"},{"key":"order_unique_id","value":"YOUR_ORDER_UNIQUE_ID"}]}