SynergizeFlow Onboarding & Core Client for Laravel

The official Laravel client package for SynergizeFlow. It provides seamless integration between your Laravel application, the SynergizeFlow SaaS platform, and automated n8n AI workflows.

Features

• Automated Onboarding Audits: Exposes API endpoints for SynergizeFlow to analyze your website, landing pages, and business context.
• Multiple Page Scanning (scan_urls): Configure specific landing pages (/about, /pricing, /features) for the AI to scan.
• Flexible Content Mapping (BYOB - Bring Your Own Blog): Map your application's existing Eloquent models (Posts, Categories, Users) into SynergizeFlow's standard schema.
• AI Content Insertion Action: Receive AI-generated blog posts directly into your database via custom Action classes.
• Timing-Safe Token Authentication: Protected routes using a static license key (SYNERGIZEFLOW_SECURITY_KEY) to bypass session and CSRF guards.

Requirements

• PHP: ^8.1 or higher
• Laravel Framework: ^10.0, ^11.0, ^12.0, or ^13.0

1. Installation

Install the package via Composer into your Laravel application:

composer require synergizeflow/laravel-onboarding

The package uses Laravel's package auto-discovery, so its service provider will automatically register.

2. Publish the Configuration

Run the following Artisan command to publish the synergizeflow.php configuration file to your config/ directory:

php artisan vendor:publish --tag="synergizeflow-config"

This creates config/synergizeflow.php.

3. Environment Configuration

Add your SynergizeFlow domain license key to your .env file:

# Your domain license key from the SynergizeFlow Dashboard
SYNERGIZEFLOW_SECURITY_KEY=your_license_key_here

# (Optional) Custom website description for AI context
SYNERGIZEFLOW_SITE_DESC="A modern SaaS platform for team collaboration"

Important: All incoming API requests from SynergizeFlow must include this key in the X-SynergizeFlow-Key header or request body. If the key is not configured, the endpoints will fail closed with a 500 Server Error.

4. Configuring config/synergizeflow.php

Open config/synergizeflow.php to customize your application's settings:

A. Define Pages to Scan (scan_urls)

If your application does not have a blog, or if you want SynergizeFlow to scan multiple landing pages for rich onboarding context, specify them in scan_urls:

'scan_urls' => [
    '/',
    '/about',
    '/features',
    '/pricing',
    '/services',
],

You can also use an associative array to provide descriptive page titles:

'scan_urls' => [
    '/' => 'Homepage',
    '/about-us' => 'About Our Company',
    '/pricing' => 'Pricing & Plans',
],

Relative paths (e.g. /about) will automatically be resolved to full URLs using your application's APP_URL / website_url.

B. Map Existing Eloquent Models (content_providers)

If your Laravel app already has a blog, authors, or categories, map them so SynergizeFlow can ingest existing articles for AI style training and populate dropdown options in the SaaS dashboard:

'content_providers' => [
    // Map your existing Blog Post model (optional)
    'blog' => [
        'name' => 'Blog Posts',
        'model' => \App\Models\Post::class,
        'fields' => [
            'id' => 'id',
            'title' => 'title',
            'content' => 'content',
            'slug' => 'slug',
        ],
        'limit' => 5,
    ],

    // Map your Categories model (optional)
    'category' => [
        'model' => \App\Models\Category::class,
        'fields' => [
            'id' => 'id',
            'name' => 'name',
        ],
    ],

    // Map your Authors/Users model (defaults to App\Models\User)
    'author' => [
        'model' => \App\Models\User::class,
        'fields' => [
            'id' => 'id',
            'name' => 'name',
        ],
    ],
],

C. Configure AI Blog Insertion (actions.insert_blog)

Out of the box, SynergizeFlow provides a plug-and-play DefaultInsertBlogAction that automatically saves incoming articles directly to the model mapped under content_providers.blog.

No custom code is required for 90% of use cases!

However, if your application has custom requirements (e.g. multi-tenancy, translations with spatie/laravel-translatable, or dispatching custom events), you can override it with your own custom Action:

1. Create a class implementing SynergizeFlow\Laravel\Contracts\InsertBlogContract:

namespace App\Actions;

use SynergizeFlow\Laravel\Contracts\InsertBlogContract;
use App\Models\Post;

class InsertCustomBlogAction implements InsertBlogContract
{
    public function execute(array $payload): mixed
    {
        return Post::create([
            'title' => $payload['title'],
            'content' => $payload['content'],
            'slug' => $payload['slug'],
            'status' => 'published',
        ]);
    }
}

1. Register your custom Action in config/synergizeflow.php:

'actions' => [
    'insert_blog' => \App\Actions\InsertCustomBlogAction::class,
],

(Alternatively, if your app does not have a blog database, install the optional companion package synergizeflow/laravel-onboarding-blog which provides ready-to-use migrations and models).

5. API Endpoints

This package registers the following routes under the /api/synergizeflow/v2/ prefix:

All routes except validate-license require authentication via the X-SynergizeFlow-Key header or key/license in the request payload.

License

This package is open-sourced software licensed under the MIT license.