Installation

Getting started with Opineeo is quick and easy. Follow these simple steps to add surveys to your website.

Quick Start

1. Include the Script

Add the Opineeo script to your HTML page. Place it in the <head> section or before the closing </body> tag:

<script src="https://app.opineeo.com/opineeo-0.0.1.min.js"></script>

That's it! The Opineeo widget is now available on your page.

Integration Methods

Opineeo offers multiple integration methods. Choose the one that best fits your needs:

Bubble Plugin (No-Code)

Perfect for Bubble.io applications - no coding required!

Visit the Bubble Plugin documentation for complete installation and usage instructions.

Quick Start:

Install the plugin from the Bubble marketplace
Add the Opineeo Survey Widget element to your page
Configure with your Survey ID and API Token
Done! Start collecting feedback

For detailed instructions, see the Bubble Plugin guide.

JavaScript Class

Use the JavaScript class for programmatic control:

<!DOCTYPE html>
<html>
<head>
    <title>My Website</title>
    <script src="https://app.opineeo.com/opineeo-0.0.1.min.js"></script>
</head>
<body>
    <div id="survey-container"></div>
    
    <script>
        const surveyWidget = window.initSurveyWidget({
            surveyId: 'your-survey-id',
            token: 'your-api-token',
            onComplete: function(data) {
                console.log('Survey completed:', data);
            }
        });
        
        surveyWidget.mount('survey-container');
    </script>
</body>
</html>

Web Component

Use the custom HTML element for declarative integration:

<!DOCTYPE html>
<html>
<head>
    <title>My Website</title>
    <script src="https://app.opineeo.com/opineeo-0.0.1.min.js"></script>
</head>
<body>
    <opineeo-survey 
        survey-id="your-survey-id"
        token="your-api-token"
        auto-close="3000">
    </opineeo-survey>
    
    <script>
        document.querySelector('opineeo-survey')
            .addEventListener('complete', function(event) {
                console.log('Survey completed:', event.detail);
            });
    </script>
</body>
</html>

Getting Your Credentials

To use Opineeo, you'll need:

Survey ID: The unique identifier for your survey
API Token: Your authentication token

How to Get Credentials

Sign up for a free account at app.opineeo.com
Create a new survey in the dashboard
Copy your Survey ID and API Token from the integration page

NPM Installation (React)

For React applications, we provide a dedicated npm package for seamless integration:

npm install opineeo-widget

Or with yarn:

yarn add opineeo-widget

Usage with React

After installing the package, you can use the React components in your application:

import { OpineeoSurvey } from 'opineeo-widget'

function App() {
  return (
    <OpineeoSurvey 
      surveyId="your-survey-id"
      token="your-api-token"
      onComplete={(data) => console.log('Survey completed:', data)}
    />
  )
}

For more details on React integration, visit the NPM package documentation.

Next Steps

Now that you have Opineeo installed, learn how to configure your surveys to match your needs.

Troubleshooting

Script Not Loading

If the script isn't loading, check:

Your internet connection
Browser console for errors
Whether your domain is whitelisted (for paid plans)

Widget Not Appearing

If the widget doesn't appear:

Verify your Survey ID and API Token are correct
Check that the script is fully loaded before initializing
Ensure there are no JavaScript errors in the console

Need help? Contact our support team at contact@opineeo.com.