Docs/Phase 1 Packages

Phase 1 Packages: Laravel + WordPress

OvionDesk AI ships the core Laravel app as the main product. Phase 1 also includes two branded integration packages under packages/oviontech/: a Laravel helper package for developers and a WordPress plugin for buyer websites.

Compatibility note:
OvionDesk AI is the public brand for this release. The app keeps internal aibot_* database tables, legacy webhook headers, and older connector keys compatible. The rebrand changes customer-facing names first.

Package Locations

packages/oviontech/oviondesk-laravel/
packages/oviontech/oviondesk-wordpress/
dist/packages/oviondesk-laravel-1.0.0.zip
dist/packages/oviondesk-wordpress-1.0.0.zip

Laravel Package

The Laravel package is for developers who want to embed OvionDesk AI in another Laravel app without copying the support desk engine. It provides small helpers around the existing core API.

Composer name: oviontech/oviondesk-laravel
Service provider: OvionTech\OvionDesk\OvionDeskServiceProvider
Config file: config/oviondesk.php
Widget helper: WidgetEmbed
Connector helper: ConnectorEventClient
Webhook helper: WebhookVerifier

Laravel Setup Example

composer require oviontech/oviondesk-laravel
php artisan vendor:publish --tag=oviondesk-config

OVIONDESK_CORE_URL=https://support.example.com
OVIONDESK_WORKSPACE_TOKEN=workspace_api_token_here
OVIONDESK_WIDGET_KEY=widget_public_key_here
OVIONDESK_WEBHOOK_SECRET=webhook_secret_here

Embed Example

{!! app(\OvionTech\\OvionDesk\Support\WidgetEmbed::class)->script([
    'identity' => [
        'id' => (string) auth()->id(),
        'name' => auth()->user()?->name,
        'email' => auth()->user()?->email,
    ],
]) !!}

Developer Notes

The helper intentionally calls the existing Universal JS SDK global window.Aibot. That global is a compatibility contract; buyers see OvionDesk AI branding in the UI.

WordPress Plugin

The WordPress package gives buyers an easy way to embed the OvionDesk AI widget on a WordPress site. It does not perform AI inference or duplicate ticket logic.

Plugin folder: oviondesk
Plugin name: OvionDesk AI
Shortcode: [oviondesk]
Block name: OvionDesk AI Widget
Option key: oviondesk_settings
Function prefix: oviondesk_

WordPress Setup Steps

Upload oviondesk-wordpress-1.0.0.zip in WordPress.
Activate OvionDesk AI.
Open Settings > OvionDesk AI.
Paste the Laravel API URL, workspace API token, and widget key.
Click Test Connection.
Add [oviondesk] to a page, use the block, or enable footer auto embed.

Legacy Settings Migration

If the old WordPress plugin stored aibot_support_settings, the new plugin copies that option once into oviondesk_settings. It does not delete the old option, so rollback is safe.

Package QA Checklist

ZIP exists under dist/packages/.
README, changelog, version, fixtures, and screenshots are present.
Laravel composer JSON validates.
PHP files pass php -l.
WordPress plugin has the correct public labels and shortcode.
Core app tests and production smoke test still pass.