{"id":292942,"date":"2026-04-05T17:06:30","date_gmt":"2026-04-05T17:06:30","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/brightery-woo-order-api\/"},"modified":"2026-04-05T18:16:28","modified_gmt":"2026-04-05T18:16:28","slug":"brightery-woo-order-api","status":"publish","type":"plugin","link":"https:\/\/tr.wordpress.org\/plugins\/brightery-woo-order-api\/","author":17316408,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.1","stable_tag":"1.0.1","tested":"6.9.4","requires":"5.6","requires_php":"7.4","requires_plugins":null,"header_name":"Brightery Woo-Order-Api","header_author":"Brightery","header_description":"A secure custom API to get WooCommerce order details and lists for customer service bots.","assets_banners_color":"c2baec","last_updated":"2026-04-05 18:16:28","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/www.brightery.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":40,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"brighterycom","date":"2026-04-05 18:16:28"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3499284,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3499284,"resolution":"1544x500","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.1"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1556,2364,168009,45369,286],"plugin_category":[45],"plugin_contributors":[257918],"plugin_business_model":[],"class_list":["post-292942","plugin","type-plugin","status-publish","hentry","plugin_tags-api","plugin_tags-chatbot","plugin_tags-manychat","plugin_tags-order-tracking","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-brighterycom","plugin_committers-brighterycom"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/brightery-woo-order-api\/assets\/icon-256x256.png?rev=3499284","icon_2x":"https:\/\/ps.w.org\/brightery-woo-order-api\/assets\/icon-256x256.png?rev=3499284","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Connecting WooCommerce to customer service chatbots shouldn't require exposing your entire store to complex webhook setups or granting full read\/write API access.<\/p>\n\n<p><strong>Brightery Woo-Order-Api<\/strong> acts as a secure, read-only bridge. It provides two highly specific API endpoints tailored exactly to what chatbots need: order statuses and tracking links.<\/p>\n\n<p>It is perfectly suited for developers building automated customer support flows on platforms like ManyChat, Chatfuel, Dialogflow, or custom AI agents.<\/p>\n\n<h3>Features<\/h3>\n\n<ul>\n<li><strong>Secure API Key Authentication:<\/strong> Easily generate an API key from the WordPress admin dashboard to ensure only your bot can access the data.<\/li>\n<li><strong>Targeted Data:<\/strong> Exposes only the necessary data (order status, shipping dates, courier, tracking links) without leaking sensitive customer information.<\/li>\n<li><strong>Search by Email or Phone:<\/strong> Allows bots to query a user's purchase history using their contact information.<\/li>\n<li><strong>Order Verification:<\/strong> The specific order endpoint requires the billing email to match the order ID, adding an extra layer of privacy.<\/li>\n<\/ul>\n\n<h3>API Endpoints<\/h3>\n\n<p>Base URL: <code>https:\/\/your-site.com\/wp-json\/Brightery-api\/v1<\/code><\/p>\n\n<p><strong>1. Get Specific Order (Ideal for \"Where is my order?\" flows)<\/strong>\n* <code>GET \/order\/{order_id}?email=customer@example.com<\/code><\/p>\n\n<p><strong>2. Get Customer Order History<\/strong>\n* <code>GET \/orders\/by-contact?phone=1234567890<\/code>\n* <code>GET \/orders\/by-contact?email=customer@example.com<\/code><\/p>\n\n<p><strong>Authentication:<\/strong> All requests must include the header: <code>X-Brightery-API-Key: YOUR_API_KEY<\/code><\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/brightery-woo-order-api<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress.<\/li>\n<li>Navigate to <strong>WooCommerce &gt; Bot API Settings<\/strong> in your WordPress admin menu.<\/li>\n<li>Copy the generated API Key or create your own, and click \"Save\".<\/li>\n<li>Provide the API endpoints and the API Key to your bot developer or integrate them into your chatbot platform via HTTP requests.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20require%20the%20default%20woocommerce%20rest%20api%20to%20be%20enabled%3F\"><h3>Does this require the default WooCommerce REST API to be enabled?<\/h3><\/dt>\n<dd><p>No. This plugin creates its own independent, isolated endpoints specifically for bot tracking.<\/p><\/dd>\n<dt id=\"how%20do%20i%20authenticate%20my%20bot%3F\"><h3>How do I authenticate my bot?<\/h3><\/dt>\n<dd><p>Go to WooCommerce &gt; Bot API Settings to find your API key. Pass this key in the headers of your bot's HTTP request as <code>X-Brightery-API-Key<\/code>.<\/p><\/dd>\n<dt id=\"will%20this%20expose%20customer%20credit%20card%20details%3F\"><h3>Will this expose customer credit card details?<\/h3><\/dt>\n<dd><p>Absolutely not. The API is strictly read-only and only returns the order ID, shipping company, shipping date, order status, and tracking link.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>Added endpoint to query order by ID and email.<\/li>\n<li>Added endpoint to query order history by phone or email.<\/li>\n<li>Added API key generation and header authentication for enhanced security.<\/li>\n<\/ul>","raw_excerpt":"A secure, lightweight custom REST API designed to connect WooCommerce order tracking to customer service bots (ManyChat, Dialogflow, custom AI).","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/292942","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=292942"}],"author":[{"embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/brighterycom"}],"wp:attachment":[{"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=292942"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=292942"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=292942"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=292942"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=292942"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=292942"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}