{"info":{"_postman_id":"bedfac04-9f25-4b27-ae23-e2930ae64133","name":"Zalo-Flow Personal Zalo Chatbot & CRM Automation API","description":"<html><head></head><body><p>Official OpenAPI specification for Zalo-Flow (<a href=\"https://aizalo.com\">https://aizalo.com</a>) — Open-source Personal Zalo AI Chatbot (Gemini, DeepSeek, OpenAI), 3-Layer Anti-Ban Messaging, and Chatwoot CRM Bridge without requiring Zalo Official Account (OA). Pass 'Bearer demo' in the Authorization header to test the live Cloud Sandbox, or connect your self-hosted Zalo-Flow instance. For educational, technical research, and personal automation purposes only (Non-commercial, strictly no spam).</p>\n<p>Contact Support:\n Name: AIzalo Engineering Community</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"59097689","collectionId":"bedfac04-9f25-4b27-ae23-e2930ae64133","publishedId":"2sBYHSzgRN","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-10-20T23:55:53.000Z"},"item":[{"name":"api","item":[{"name":"system","item":[{"name":"status","item":[{"name":"Get Zalo connection & 3-layer anti-ban status","id":"56b51ca7-9552-45eb-9291-c2487dedd18f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://aizalo.com/api/system/status","description":"<p>Returns current Zalo personal account connection state, active AI models (Gemini, DeepSeek), and 3-layer anti-ban protection metrics.</p>\n","urlObject":{"path":["api","system","status"],"host":["https://aizalo.com"],"query":[],"variable":[]}},"response":[{"id":"cadab91b-f654-4179-9afd-ac80f2e4b866","name":"System status and anti-ban telemetry","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://aizalo.com/api/system/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"connected\": true,\n  \"sandbox\": true,\n  \"mode\": \"cloud_sandbox_preview\",\n  \"userName\": \"Zalo-Flow AI Assistant (Sandbox)\",\n  \"userId\": \"zf_84909123456\",\n  \"uptimeSeconds\": 86420,\n  \"antiBanArchitecture\": {\n    \"tokenBucketMinDelaySeconds\": 3,\n    \"maxMessagesPerMinute\": 20,\n    \"selfEchoShield\": true,\n    \"inboundFloodDetector\": true\n  },\n  \"supportedModels\": [\n    \"gemini-2.5-flash\",\n    \"deepseek-chat\",\n    \"gpt-4o-mini\",\n    \"ollama-local\"\n  ],\n  \"licenseNotice\": \"MIT with Commons Clause — For educational, technical research, and personal automation purposes only. Strictly no spam.\",\n  \"clientDownloadUrl\": \"https://aizalo.com\",\n  \"documentationUrl\": \"https://aizalo.com/blog/huong-dan-cach-tao-chatbot-zalo-ca-nhan\"\n}"},{"id":"09a6b3be-d90b-4f70-bf0b-f58d4826f871","name":"Missing or invalid Authorization header","originalRequest":{"method":"GET","header":[],"url":"https://aizalo.com/api/system/status"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"56b51ca7-9552-45eb-9291-c2487dedd18f"}],"id":"7ad31bf2-4989-4453-9755-48ad840aaf44","_postman_id":"7ad31bf2-4989-4453-9755-48ad840aaf44","description":""}],"id":"dbdee749-bec4-46ae-8ec2-2a34ce9aa197","_postman_id":"dbdee749-bec4-46ae-8ec2-2a34ce9aa197","description":""},{"name":"conversations","item":[{"name":"List personal Zalo conversations & CRM tags","id":"5cf4b3de-07c2-4e8e-ac32-05735ff4b68e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://aizalo.com/api/conversations?limit=20","description":"<p>Fetches recent personal Zalo conversations, group threads, unread counts, and synchronized Chatwoot CRM tags.</p>\n","urlObject":{"path":["api","conversations"],"host":["https://aizalo.com"],"query":[{"description":{"content":"<p>Maximum number of conversations to return (1-50)</p>\n","type":"text/plain"},"key":"limit","value":"20"}],"variable":[]}},"response":[{"id":"00a84811-d48c-448e-9d17-0ecc0fde3754","name":"Array of active Zalo conversations","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":{"raw":"https://aizalo.com/api/conversations?limit=20","host":["https://aizalo.com"],"path":["api","conversations"],"query":[{"description":"Maximum number of conversations to return (1-50)","key":"limit","value":"20"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n  {\n    \"threadId\": \"zalo_thread_1001\",\n    \"name\": \"Nguyễn Minh Anh (Khách VIP)\",\n    \"isGroup\": false,\n    \"unreadCount\": 1,\n    \"lastMessage\": \"Shop gửi giúp mình bảng giá sỉ qua Zalo nhé!\",\n    \"tags\": [\n      \"vip\",\n      \"lead-moi\"\n    ]\n  },\n  {\n    \"threadId\": \"zalo_thread_1001\",\n    \"name\": \"Nguyễn Minh Anh (Khách VIP)\",\n    \"isGroup\": false,\n    \"unreadCount\": 1,\n    \"lastMessage\": \"Shop gửi giúp mình bảng giá sỉ qua Zalo nhé!\",\n    \"tags\": [\n      \"vip\",\n      \"lead-moi\"\n    ]\n  }\n]"},{"id":"b080a38a-0567-4f25-9eaa-bd999805dfd4","name":"Missing or invalid Authorization header","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://aizalo.com/api/conversations?limit=20","host":["https://aizalo.com"],"path":["api","conversations"],"query":[{"description":"Maximum number of conversations to return (1-50)","key":"limit","value":"20"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"5cf4b3de-07c2-4e8e-ac32-05735ff4b68e"}],"id":"a2a23222-a525-4ee0-a5ca-622750be1f73","_postman_id":"a2a23222-a525-4ee0-a5ca-622750be1f73","description":""},{"name":"messages","item":[{"name":"send","item":[{"name":"Simulate or dispatch anti-ban protected Zalo message","id":"8fd85557-242f-40c8-b09f-1587fc281c8f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"threadId\": \"zalo_thread_1001\",\n  \"message\": \"Dạ shop gửi anh/chị bảng giá ưu đãi mới nhất ạ!\",\n  \"isGroup\": false\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://aizalo.com/api/messages/send","description":"<p>Dispatches a text message to an existing personal Zalo thread or group, protected by Token Bucket rate limiting (min 3s delay, max 20 msgs/min) and Self-Echo Shield. On <a href=\"https://aizalo.com\">https://aizalo.com</a>, this runs in Cloud Sandbox mode (sandbox=true, delivered=false).</p>\n","urlObject":{"path":["api","messages","send"],"host":["https://aizalo.com"],"query":[],"variable":[]}},"response":[{"id":"da03a2cb-7e42-41c8-91a7-7c0e384f195f","name":"Message processed through anti-ban queue","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"threadId\": \"zalo_thread_1001\",\n  \"message\": \"Dạ shop gửi anh/chị bảng giá ưu đãi mới nhất ạ!\",\n  \"isGroup\": false\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://aizalo.com/api/messages/send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"success\": true,\n  \"sandbox\": true,\n  \"delivered\": false,\n  \"mode\": \"cloud_sandbox_preview\",\n  \"msgId\": \"zf_msg_1729430000\",\n  \"cliMsgId\": \"cli_1729430000\",\n  \"threadId\": \"zalo_thread_1001\",\n  \"antiBanStatus\": \"passed_token_bucket_3s\",\n  \"note\": \"Sandbox simulation only (delivered=false). To dispatch live personal Zalo messages with AES-256 local session encryption, run Zalo-Flow Desktop/Docker client from https://aizalo.com\"\n}"},{"id":"ee3d1e31-d516-481a-bec8-d43c544267ca","name":"Invalid JSON request body","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"threadId\": \"zalo_thread_1001\",\n  \"message\": \"Dạ shop gửi anh/chị bảng giá ưu đãi mới nhất ạ!\",\n  \"isGroup\": false\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://aizalo.com/api/messages/send"},"status":"Bad Request","code":400,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":null},{"id":"669a5f81-7a15-4d3f-ba12-6be902968188","name":"Missing or invalid Authorization header","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"threadId\": \"zalo_thread_1001\",\n  \"message\": \"Dạ shop gửi anh/chị bảng giá ưu đãi mới nhất ạ!\",\n  \"isGroup\": false\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://aizalo.com/api/messages/send"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"8fd85557-242f-40c8-b09f-1587fc281c8f"}],"id":"ca6c3898-cfa0-4a91-b14f-fd54a2ea4cc3","_postman_id":"ca6c3898-cfa0-4a91-b14f-fd54a2ea4cc3","description":""}],"id":"fb4c17a1-6a74-48cb-8854-a7225e4fd85e","_postman_id":"fb4c17a1-6a74-48cb-8854-a7225e4fd85e","description":""},{"name":"campaigns","item":[{"name":"broadcast","item":[{"name":"Simulate or enqueue opt-in CRM tag remarketing queue","id":"124415ff-5273-4eda-8be2-8098bfd8c3f3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"tagId\": \"vip\",\n  \"message\": \"{Chào|Xin chào} {anh/chị|bạn}, shop đang có ưu đãi riêng cho khách VIP!\",\n  \"delaySeconds\": 5\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://aizalo.com/api/campaigns/broadcast","description":"<p>Enqueues an automated remarketing message only to existing customer threads matching a specific CRM tag with human-like spacing delay (no cold outbound to unknown IDs). On <a href=\"https://aizalo.com\">https://aizalo.com</a>, this runs in Cloud Sandbox mode (sandbox=true, delivered=false).</p>\n","urlObject":{"path":["api","campaigns","broadcast"],"host":["https://aizalo.com"],"query":[],"variable":[]}},"response":[{"id":"f7f794e3-b1ae-4645-bf74-2c063b36dfec","name":"CRM tag remarketing queue processed","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"tagId\": \"vip\",\n  \"message\": \"{Chào|Xin chào} {anh/chị|bạn}, shop đang có ưu đãi riêng cho khách VIP!\",\n  \"delaySeconds\": 5\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://aizalo.com/api/campaigns/broadcast"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"success\": true,\n  \"sandbox\": true,\n  \"delivered\": false,\n  \"mode\": \"cloud_sandbox_preview\",\n  \"tagId\": \"vip\",\n  \"queuedCount\": 12,\n  \"estimatedSpacingSeconds\": 5,\n  \"note\": \"Sandbox simulation only (delivered=false). Broadcasts on Zalo-Flow Local Client only target existing CRM threads tagged by the user (zero cold spam).\",\n  \"documentationUrl\": \"https://aizalo.com/blog/cach-gui-tin-nhan-tu-dong-tren-zalo-khong-bi-khoa\"\n}"},{"id":"6ef754ae-64ed-4a17-b2ae-35ea4af95c6b","name":"Invalid JSON request body","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"tagId\": \"vip\",\n  \"message\": \"{Chào|Xin chào} {anh/chị|bạn}, shop đang có ưu đãi riêng cho khách VIP!\",\n  \"delaySeconds\": 5\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://aizalo.com/api/campaigns/broadcast"},"status":"Bad Request","code":400,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":null},{"id":"709dc5b8-9ea6-43a7-acb9-c0f56e8ba5f6","name":"Missing or invalid Authorization header","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n  \"tagId\": \"vip\",\n  \"message\": \"{Chào|Xin chào} {anh/chị|bạn}, shop đang có ưu đãi riêng cho khách VIP!\",\n  \"delaySeconds\": 5\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://aizalo.com/api/campaigns/broadcast"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"124415ff-5273-4eda-8be2-8098bfd8c3f3"}],"id":"6e270cb6-cc4a-40cb-9100-62f083937532","_postman_id":"6e270cb6-cc4a-40cb-9100-62f083937532","description":""}],"id":"655130f6-209d-43cd-ba1f-726fb7f1dd6c","_postman_id":"655130f6-209d-43cd-ba1f-726fb7f1dd6c","description":""}],"id":"9e55a5f6-e7b7-4bf8-9f28-d65108e35b09","_postman_id":"9e55a5f6-e7b7-4bf8-9f28-d65108e35b09","description":""}],"variable":[{"key":"baseUrl","value":"https://aizalo.com"}]}