qingflow_dify

Author: qing76 Version: 0.0.2 Type: tool

Qingflow Dify Tool Plugin

📖 Introduction

The Qingflow Dify Tool Plugin is a powerful integration tool that enables seamless connection and utilization of Qingflow platform data within Dify workflows. With simple configuration, you can easily retrieve application comments, application details, form data, and more to automate business processes.

✨ Actions List

🔄 Data Retrieval

• Application Comment Fetching - Automatically retrieve comments for individual data entries, with support for paginated queries.
• Form Data Processing - Query and filter Qingflow form data.
• Application Info Retrieval - Get basic application information and form details.
• Application Deletion - Delete specified Qingflow applications.
• Single Data Entry Retrieval - Fetch detailed information for individual data entries.

🛠️ Technical Features

• No-Code Integration - Connect Qingflow and Dify without writing code.
• Real-Time Data Sync - Ensure timeliness and accuracy of data.
• Secure & Reliable - Adopt HTTPS encrypted transmission to protect data security.

🚀 Quick Start

Prerequisites

• A valid Dify account.
• A Qingflow account with API access permissions.
• The accessToken for your Qingflow application.

Usage Tutorial

1. Register a user

   • Open https://qingflow.com?utm_source=dify to register a new user for free.
   • After logging in, open the Qing Mall, click OpenApi, and configure the AccessToken.
   • Create an application, add fields according to business needs, and record the application appKey.
     Reference document: https://help.qingflow.com/help-docs/?type=qingCode&docId=480cccb96428f7d50000fbb26c397e48&parentId=

2. Plugin installation and configuration

   • Install the QF Applies Intelligent Connection plugin in Dify.
   • Click the plugin and configure the AccessToken in the API KEY Authorization Configuration credential of the plugin.

3. Plugin usage

   • Create a blank application.
   • Add a node, select Tool, click QF Applies Intelligent Connection and choose the corresponding method.

Troubleshooting Guide for QF Application Smart Connection Plugin

1. AccessToken is invalid after configuration

   • Check the validity of the AccessToken.
   • Log in to the Qingflow platform and go to the configuration page: 「Qing Mall → Expansion Plugins → Third-Party Links → OpenAPI」: https://qingflow.com/center/plugin/detail/20
   • Confirm that the entered AccessToken is exactly the same as the one displayed on the page (no spaces, no case errors).
   • If the "Reset" button has been clicked recently, the original AccessToken is invalid, and you need to reconfigure with the newly generated key.

2. Error when calling the interface

   • Check if the parameters are correct. appKey: the application ID, which can be obtained from the application link.
   • Confirm that the application in Qingflow is in the published state.

3. Common error codes

   Error Code	Description	Solution
   -1	Missing Parameters	Check if all required parameters are provided.
   -2	Authentication Failed	Verify if the access_token is correct.

4. Debugging tools

   • Interface connectivity test: Use Postman or curl to directly call the Qingflow API to rule out issues with the plugin itself (prioritize verifying basic interface availability).
   • Qingflow issues: Contact Qingflow technical support.
   • Technical documentation: https://help.qingflow.com/help-docs/?type=qingCode&docId=480cccb96428f7d50000fbb26c397e48&parentId=
   • Official website: https://qingflow.com?utm_source=dify

📋 Parameter Description

Input Parameters

Parameter Name	Type	Required	Description	Example
applyId	string	✅	Qingflow Application ID	"app_123456"

Output Result

{
  "result": [
    {
      "commentId": 1418706,
      "commentMsg": "Comment information here can be retrieved via the API\n",
      "mentionUserIds": []
    },
    {
      "commentId": 1418705,
      "commentMsg": "There are many comments here",
      "mentionUserIds": []
    },
    {
      "commentId": 1418704,
      "commentMsg": "This is a comment page\n",
      "mentionUserIds": []
    },
    {
      "commentId": 1418703,
      "commentMsg": "I want to test comments\n",
      "mentionUserIds": []
    }
  ]
}

🛡️ Security & Privacy

Data Protection

• 🔒 End-to-End Encryption - All data transmission uses HTTPS.
• 🗑️ No Persistent Storage - Data is only processed temporarily in memory.
• 🔐 Secure Credential Management - Tokens are securely stored via Dify.

Privacy Commitment

• No collection of user-sensitive information.
• No sharing of data with third parties.
• No retention of historical operation records.

For detailed privacy policies, refer to PRIVACY.md.

❓ Frequently Asked Questions (FAQs)

Q: How to obtain a Qingflow access_token?

A: Log in to the Qingflow backend, then navigate to System Settings > API Management to generate an access_token.

Q: Which Qingflow data operations does the plugin support?

A: Currently, it supports retrieving basic application information, fetching specified form details, getting information for individual data entries, retrieving comments for individual data entries, fetching application data, and deleting applications.

Q: How to handle API request failures?

A: Detailed error information will be returned to facilitate troubleshooting.

🐛 Troubleshooting

Common Error Codes

Error Code	Description	Solution
-1	Missing Parameters	Check if all required parameters are provided.
-2	Authentication Failed	Verify if the access_token is correct.

Note: Before using this plugin, ensure you have read and agreed to the relevant terms of service and privacy policy of the Qingflow platform.