Documentation

Table of Contents
Getting Started
Before integrating BunnōIQ, ensure you have the following requirements met.

Prerequisites

  • A verified Enterprise or Premium account
  • API access credentials (found in your admin dashboard)
  • Access to your domain/CRM/web app for integration

💡 Tip: To access your developer dashboard, log into your account and go to:
Settings → Developer Tools → API Keys & Webhooks

SDK Integration
BunnōIQ provides lightweight SDKs for multiple languages and frameworks.

Installation

npm install @bunnoiq/sdk

Quick Start Examples

main.js
import BunnoIQ from '@bunnoiq/sdk'

const bunno = new BunnoIQ({
  apiKey: 'YOUR_API_KEY',
  userId: 'current-user-id',
  environment: 'production'
})

// Track page views
bunno.trackPageView()

// Launch a survey
bunno.launchSurvey('survey-id', {
  userEmail: 'john@example.com',
  metadata: {
    plan: 'premium',
    region: 'EMEA',
    source: 'web-app'
  }
})
Embedding Surveys into Web Pages
You can embed surveys directly into your application, landing pages, or in-app flows.

iFrame Embed

<iframe 
  src="https://survey.bunnoiq.com/embed/{survey_id}" 
  width="100%" 
  height="600px" 
  frameborder="0" 
  allowfullscreen>
</iframe>

React Component

Premium Only
import { BunnoSurvey } from '@bunnoiq/sdk'

<BunnoSurvey
  surveyId="your-survey-id"
  user={{
    id: "user_123",
    email: "user@example.com"
  }}
  onComplete={(responses) => {
    console.log('Survey completed:', responses)
  }}
/>

💡 Tip: Use conditional rendering to trigger post-transaction or exit-intent surveys for better response rates.

Email Integration
Send surveys via email to collect feedback from your users.

Email Template

<html>
<body>
                          <h1>We value your feedback!</h1>
                          <p>Hi {user.first_name},</p>
                          <p>We'd love to hear your thoughts on your recent experience with us.</p>
                          <a href="{survey_link}" style="background-color: #4CAF50; color: white; padding: 10px 20px; text-decoration: none; border-radius: 5px;">Take the survey</a>
                          <p>Thank you!</p>
                          <p>The BunnōIQ Team</p>
</body>
</html>

Sending Emails

import { BunnoIQ } from '@bunnoiq/sdk'
const bunno = new BunnoIQ({ apiKey: 'YOUR_API_KEY' });

// Send a survey email
bunno.sendSurveyEmail({
  surveyId: 'customer-satisfaction',
  recipient: 'customer@example.com',
  variables: {
    firstName: 'John',
    lastName: 'Doe'
  }
})
Webhooks
Receive real-time notifications about survey events via webhooks.

Webhook Setup

POST https://yourdomain.com/webhooks/bunnoiq
Content-Type: application/json

{
  "event": "survey.completed",
  "data": {
    "survey_id": "customer-satisfaction",
    "user_id": "user_123",
    "responses": [...]
  }
}

Note: Secure your webhook endpoint and verify payload signatures.

FAQ

How do I reset my API key?

Go to your dashboard, navigate to Developer Tools, and click "Reset API Key".

Can I export survey results?

Yes, survey results can be exported as CSV or JSON from the analytics dashboard.