Documentation

What is Business Yatch?

Business Yatch is a product intelligence platform that combines feedback collection, product updates, surveys, and a lightweight CRM into one tool. It replaces multiple SaaS subscriptions with a single, developer-friendly API.

Quick Setup

1. Create an account at businessyatch.com/signup
2. Go to Dashboard → API Keys and create a new key
3. Add the widget to your site or use the API directly
4. Start collecting feedback and publishing updates

Widget Installation

Add this script tag to your website:

<script src="https://businessyatch.com/widget.js?key=YOUR_API_KEY"></script>

Navigating the Dashboard

After logging in, you'll see the sidebar with all main sections:

• Home - Overview with action items and recent activity
• Updates & Polls - Create and manage product announcements
• Feedback - View and respond to user feedback
• Surveys - Create and analyze surveys
• Contacts - Manage your customer database
• Analytics - View trends and insights
• API Keys - Generate keys for API access

Action Items

The Home page shows action items that need your attention - unresolved bugs, pending feature requests, and unanswered questions. Click any item to view details and respond.

Creating an Update

1. Go to Updates & Polls in the sidebar
2. Click New Update
3. Enter a title and description (supports markdown)
4. Select a type: Feature, Fix, Improvement, or Announcement
5. Click Publish to make it live

Update Types

• Feature - New functionality you've added
• Fix - Bug fixes and patches
• Improvement - Enhancements to existing features
• Announcement - General news or information

Creating a Poll

Polls let you gather quick feedback from users:

1. Go to Updates & Polls
2. Click New Poll
3. Enter your question and add options
4. Publish and share the link or embed in your app

Viewing Feedback

Go to Feedback in the sidebar to see all submissions.

• Filter by type (bug, feature, question, complaint, praise)
• Filter by status (open, resolved)
• Search by keyword or email
• Sort by newest or oldest

Responding to Feedback

1. Click on any feedback item to view details
2. Add internal notes (only visible to your team)
3. Mark as resolved when addressed
4. If email was provided, you can follow up directly

Feedback Types Explained

• Bug - Something isn't working correctly
• Feature - Request for new functionality
• Question - User needs help or clarification
• Complaint - User is frustrated or unhappy
• Praise - Positive feedback and compliments

Collecting Feedback

There are multiple ways to collect feedback:

• Widget - Embed the feedback widget on your site
• API - Submit feedback programmatically
• Dashboard - Manually add feedback on behalf of users

Creating a Survey

1. Go to Surveys in the sidebar
2. Click New Survey
3. Add a title and description
4. Add questions using the question builder
5. Preview your survey
6. Publish and share the link

Question Types

• NPS (0-10) - Net Promoter Score: "How likely are you to recommend us?"
• Rating (1-5) - Star rating for satisfaction
• Text - Open-ended written response
• Multiple Choice - Select one option from a list
• Yes/No - Simple binary choice

Viewing Results

Click on any survey to see:

• Total responses and completion rate
• Breakdown of answers per question
• NPS score calculation (Promoters - Detractors)
• Individual response details
• Export responses as CSV

How Contacts Are Created

Contacts are automatically created when:

• A user submits feedback with their email
• A user completes a survey with their email
• You manually add a contact

Managing Contacts

1. Go to Contacts in the sidebar
2. Click on any contact to view their profile
3. See all feedback and survey responses from that user
4. Add internal notes about the contact
5. Add tags to organize (e.g., VIP, Lead, Churned)

Tags

Use tags to segment your contacts:

• Create custom tags that fit your workflow
• Filter contacts by tag
• Common examples: VIP, Lead, Active, Churned, Beta Tester

Contact Profile

Each contact profile shows:

• Email and name (if provided)
• First seen and last activity dates
• All feedback submitted by this contact
• Survey responses
• Your internal notes
• Applied tags

Accessing Analytics

Go to Analytics in the sidebar. You can also access feedback-specific analytics from Feedback → Analytics.

Feedback Analytics

Understand your feedback trends:

• Volume over time - How much feedback you're receiving daily/weekly/monthly
• By type - Breakdown of bugs vs features vs questions
• Resolution rate - Percentage of feedback marked as resolved
• Average response time - How quickly you respond

Survey Analytics

• Response rate - How many people complete your surveys
• NPS trend - Track Net Promoter Score over time
• Average ratings - Mean scores across rating questions

Date Ranges

Filter all analytics by date range:

• Last 7 days
• Last 30 days
• Last 90 days
• Custom date range

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer by_live_xxxxxxxxxxxx

Endpoints

{
  "type": "feature",    // bug, feature, question, complaint, praise
  "message": "Feedback text here",
  "email": "[email protected]",  // optional
  "name": "User Name",          // optional
  "rating": 4                   // optional, 1-5
}

Code Examples

const response = await fetch('https://businessyatch.com/api/v1/updates', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await response.json();

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://businessyatch.com/api/v1/updates

Is there a free tier?

Yes. You can create an account and use all features for free. No credit card required.

Do I need to code?

No. You can use the dashboard for everything. The API is optional for advanced integrations.

Can I use this with mobile apps?

Yes. Use the REST API to integrate with iOS, Android, React Native, Flutter, or any platform.

Can I customize the widget?

Yes. You can customize colors, position, and which elements to display.