Mopinion | Composio Docs

Overview

SLUG: MOPINION

Description

Mopinion captures user feedback across websites and apps, providing insights, analytics, and reporting to optimize user experiences and drive conversions

Authentication Details

API Key

full

stringDefaults to https://api.mopinion.com/v1Required

generic_api_key

stringRequired

Connecting to Mopinion

Create an auth config

Use the dashboard to create an auth config for the Mopinion toolkit. This allows you to connect multiple Mopinion accounts to Composio for agents to use.

Select App

Navigate to Mopinion.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Mopinion Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 mopinion_auth_config_id = "ac_YOUR_MOPINION_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Mopinion for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, mopinion_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Mopinion toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["MOPINION"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

MOPINION_GET_DATASET_BY_ID

Tool Name: Get Dataset by ID

Description

Tool to retrieve metadata for a specific dataset by its ID. Use when you have a valid dataset ID and need its full metadata details.

Action Parameters

dataset_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

MOPINION_GET_DATASET_FEEDBACK

Tool Name: Get Dataset Feedback

Description

Tool to retrieve feedback items for a specific dataset. Use when you need paginated or filtered dataset feedback.

Action Parameters

dataset_id

integerRequired

filters

object

limit

integer

page

integer

Action Response

_meta

objectRequired

data

arrayRequired

error

string

successful

booleanRequired

MOPINION_GET_DATASET_FEEDBACK_BY_ID

Tool Name: Get Dataset Feedback By ID

Description

Tool to retrieve a single feedback item by its ID. Use after confirming dataset and feedback identifiers to fetch detailed feedback data.

Action Parameters

dataset_id

integerRequired

feedback_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

MOPINION_GET_DATASET_FIELDS

Tool Name: Get Dataset Field Definitions

Description

Tool to retrieve field definitions for a dataset. Use when you need the schema of a dataset's fields.

Action Parameters

dataset_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

MOPINION_GET_DEPLOYMENT_BY_ID

Tool Name: Get Deployment by ID

Description

Tool to get details for a specific deployment by its ID. Use when verifying when and where a feedback form is shown, its rules, and status.

Action Parameters

deployment_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

MOPINION_GET_DEPLOYMENTS

Tool Name: Get Deployments

Description

Tool to list all deployments for the authenticated Mopinion account. Use after setting up authentication.

Action Parameters

string

version

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

MOPINION_GET_DEPLOYMENT_TRIGGER_STATUS

Tool Name: Get Deployment Trigger Status

Description

Tool to request deployment trigger status. Use after initializing client-side integration to check if a feedback form should pop up.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

MOPINION_GET_REPORT_BY_ID

Tool Name: Get Report By ID

Description

Tool to retrieve basic information for a specific report by its ID. Use after obtaining the report ID.

Action Parameters

report_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

MOPINION_GET_REPORT_FEEDBACK

Tool Name: Get Report Feedback

Description

Tool to retrieve feedback items for a report. Use when you need paginated and filtered feedback entries for analysis.

Action Parameters

filters

object

limit

integer

page

integer

report_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

MOPINION_GET_REPORT_FIELDS

Tool Name: Get Report Fields

Description

Tool to retrieve field definitions for a specific report. Use when you need the schema of a report's feedback fields before constructing or analyzing forms.

Action Parameters

report_id

integerRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

MOPINION_GET_REPORTS

Tool Name: Get Reports

Description

Tool to retrieve reports. Use when you need to fetch all reports or a specific report by its ID.

Action Parameters

content_negotiation

string

query_params

object

report_id

integer

verbosity

string

version

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

MOPINION_GET_ROOT

Tool Name: Get API Root

Description

Tool to check Mopinion API health. Use when you need to verify API availability and obtain version information.

Action Parameters

custom_base_url

string

extra_path

string

include_auth_header

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

MOPINION_LIST_DATASETS

Tool Name: List Datasets

Description

Tool to list all datasets (forms) available in Mopinion. Use when you need to retrieve dataset IDs and names for further operations.

Action Parameters

force_ping

boolean

version

string

Action Response

data

objectRequired

error

string

successful

booleanRequired