Catalyst AI Personal Shopper Extension March 22, 2024 15:01 Updated Index: Introduction About the Extension Installation and Configuration Usage Manual Demonstration of Use Terms of Use SLA Introduction The Catalyst AI Personal Shopper extension was developed by Dawntech Inc. It is currently at version 1.0 and is available in Brazilian Portuguese, Spanish, and English. With this extension, users can access a personalized product catalog generated through artificial intelligence, functioning as a personal shopper via WhatsApp! This manual aims to assist users of the Blip platform in installing, configuring, and using the Catalyst AI Personal Shopper extension. Additionally, any usage questions can be directed to contact@dawntech.dev or by contacting (51) 3557-2998. About the Extension The Catalyst AI Personal Shopper extension was developed with the goal of integrating an e-commerce flow within Blip's Builder to a specific Facebook catalog, thus making it possible to display products on published channels. The following functionalities are offered: Retrieval of WhatsApp product catalog components from a Facebook catalog, filtered by custom field and message from contacts to the chatbot, making use of the 24-hour contact conversation context. Ability to obtain PLMs (product list messages) for WhatsApp and image carousels for other channels. Various filters already available via API, as seen in the documentation. Return of personalized message according to user input and returned products. Installation and Configuration To use the Catalyst AI Personal Shopper extension, in the bot Router associated with the contract, go to the BlipStore and search for the Catalyst AI Personal Shopper extension in the Extensions tab. When you find it, activate it on that same bot. After installation, when opening the bot Router, the configuration options for the Catalyst AI Personal Shopper extension will be available: The extension configuration screen is shown in the figure below: In case of errors, the extension will alert about the inputs with issues: Usage Manual Users with administrator permission can change the extension's configuration information, as well as add specific HTTP calls to the Builder for the extension, using the aforementioned settings. To utilize the extension's features, it's necessary to configure an HTTP Request action calling the URL below, with two URL parameters: takeblip-bot-key and takeblip-tenant-id (or via headers, with the same names), being the access key of the bot where the extension was installed (bot Router) and the contract name, respectively (as illustrated in the following figure). For ease of use, the URL with these parameters is automatically generated in the Generated Information section. The extension provides two HTTP endpoints: Obtaining catalog products (POST): URL: https://api.catalyst.dwnt.store/catalyst-ai-personal-shopper/search?takeblip-tenant-id={{tenant_id}}&takeblip-bot-key={{router_api_key}}&openai-api-key={{openai_key}}. Payload (JSON): { "input": "User's free message", "phone": "Contact identifier for saving context", "filter": { "{field}": "{value}" }, // Filter can be used in conjunction with the user's input "text": { "header": "Products", "body": "Learn more by clicking here!", "footer": "Click below!", "section_name": "Products" }} Where {field} and {value} determine the filter to be applied to the Facebook catalog. For example, using {field} and {value} with the values "name" and "Blouse", respectively, will return the products in the Facebook catalog that have "Blouse" in the "name" column. The free message ("input") can be anything, such as "I need an outfit for an outdoor birthday party." The "phone" field is used for storing the conversation context of the user for more accurate responses and has a maximum storage time of 24 hours, being reset after this period. The request response comes in the following format: { "dynamic-content": { // Dynamic content for use in Builder with type application/json "type": "interactive", "interactive": { "type": "product_list", "header": { "type": "text", "text": "Products" }, "body": { "text": "Learn more by clicking here!" }, "footer": { "text": "Click below!" }, "action": { "catalog_id": "865085895408431", "sections": [ { "product_items": [ { "product_retailer_id": "ID_1" }, { "product_retailer_id": "ID_2" }, // ... { "product_retailer_id": "ID_N" } ] } ] } } }, "message": "Custom message generated by artificial intelligence according to the products found and the contact's question"} Obtaining cart summary (POST): URL: https://api.catalyst.dwnt.store/catalog-extension/cartSummary?takeblip-tenant-id={{tenant_id}}&takeblip-bot-key={{router_api_key}}. Payload (JSON): { "product_items": [ { "product_retailer_id": "<STRING>", "quantity": "<STRING (e.g.: 1)>", "item_price": "<STRING (e.g.: 1.5)>", "currency": "<STRING (e.g.: USD)>" }, ... ]} Demonstration of Use A demonstration of use is available on the official Dawntech Inc. YouTube channel, through the link youtu.be/dawntech. Terms of Use By installing this extension, you agree to the terms of use described at dawntech.dev/privacy, which also applies to the use of data collected by the extension (if/when necessary). SLA The SLA for this and other Dawntech Inc. extensions can be accessed at status.dawntech.dev. For more information, visit the discussion on the subject in our community or the videos on our channel. 😃 Related articles How to Send Notifications via the Active Campaign API (Growth) Smart Sales - Conversational Commerce Creating interactive messages in WhatsApp BLU - Blip Language Understanding Multi Product List + Cart - WhatsApp Sales