v2.3.5 Updated April 2026

Sociably AI Documentation

Everything you need to install, configure and use Sociably AI with your Perfex CRM.

Introduction

Sociably AI is a module for Perfex CRM that adds an AI assistant to every client profile. Instead of clicking through invoices, contracts and notes manually, you ask a question and get the answer instantly.

It works in three places:

How it works: The module reads your Perfex CRM data (invoices, contracts, notes) and sends it to our AI API along with your question. The AI generates a response using that context and returns it in seconds. Your data is never stored or shared.

Requirements

RequirementMinimumNotes
Perfex CRMVersion 3.0+Works with all editions
PHP7.4+PHP 8.x recommended
ServerAny Linux/cPanel hostMust have outbound HTTPS
Sociably licenseAnnual planFrom app.sociably.media
BrowserChrome, Firefox, SafariFor Chrome extension: Chrome only

Installation

Installation takes under 5 minutes. You do not need server access or technical skills beyond basic Perfex CRM admin usage.

1
Download the module
Log in to your Sociably dashboard and download the latest module ZIP file. The current version is v2.3.5.
2
Upload to Perfex CRM
In your Perfex admin panel go to Setup → Modules → Upload & Install. Select the ZIP file and click Upload.
3
Activate the module
Find ClientPortal AI in your modules list and click Activate. A new menu item will appear in your Perfex sidebar.
4
Enter your license key
Go to ClientPortal AI → Settings. Paste your license key from your Sociably dashboard. The API URL is pre-filled — do not change it.
5
Save settings
Click Save Settings. This also syncs your client list to the Sociably API so the Chrome extension and Slack bot can find your clients.
Domain lock: Your license key is locked to the domain you registered at purchase. If your Perfex CRM is at crm.youragency.com, the module will only work on that domain. Contact support@sociably.media to change your domain.

Configuration

All settings are in ClientPortal AI → Settings in your Perfex admin panel.

API Key

Your license key from app.sociably.media/dashboard. Starts with sai_. Keep this private — it is domain-locked to your CRM.

API URL

Pre-filled as https://api.sociably.media. Do not change this unless instructed by support.

Default Language

The language the AI responds in. Default is English. The AI also auto-detects the language of the question and responds accordingly. Available options: English, Greek, French, German, Spanish, Italian, Dutch.

Enable/Disable

Toggle the AI assistant on or off without uninstalling the module. Useful for maintenance.

Test connection

After saving settings, click Test Connection. You should see a green success message with your remaining credits.

Common test connection errors:

AI Assistant

Once installed, an AI Assistant tab appears on every client profile in Perfex CRM. Click any client, then click the AI tab.

You can ask anything about that client:

Each question costs 1 credit (2 credits in Expert mode).

Daily briefing

The floating widget in the bottom-right corner of your Perfex admin shows a Daily Briefing panel. It loads automatically and shows:

Clicking any item in the briefing opens that client's AI assistant instantly.

Annual subscribers get 365 free briefing credits — one per day. Chat responses are billed separately from your credit pack.

Response styles

Three response styles are available in Settings:

Custom AI instructions

The Custom AI Instructions field in Settings lets you add context that applies to every AI response. Use this to:

Example:

We are Themelio Studio, a digital agency based in Athens, Greece.
Our support email is support@themelio.my.
Always be warm and professional.
When clients ask about payment, offer our installment plan option.

Languages

Sociably AI responds in the language the user writes in. If you ask in Greek, it answers in Greek. If you ask in English, it answers in English. The default language setting is a fallback when the language cannot be detected.

Supported languages include Greek, English, French, German, Spanish, Italian, Dutch, Portuguese and more.

Chrome extension

The Sociably AI Chrome extension lets you access your CRM data from any browser tab — without opening Perfex.

Installation

  1. Go to the Integrations page in your dashboard
  2. Click Get from Chrome Web Store and install
  3. Click the Sociably icon in your Chrome toolbar
  4. Enter your license key and your Perfex CRM URL
  5. Click Connect

Usage

First use: After connecting the extension, go to Perfex CRM → ClientPortal AI → Settings → Save Settings. This syncs your client list so the extension can search by name.

Slack integration

Connect Sociably AI to your Slack workspace to get client briefings and daily alerts without leaving Slack.

Setup

  1. Go to Dashboard → Integrations
  2. Click Add to Slack and approve the connection
  3. Create a channel called #sociably-briefing in your workspace
  4. Invite the Sociably bot to the channel

Slash command

In any Slack channel type:

/sociably [client name]

The bot will respond with a briefing including unpaid invoices, overdue amounts, expiring contracts and recommended actions.

Daily briefing

Every morning at 8am (Athens time) the bot posts a briefing to #sociably-briefing with:

Credits

Sociably uses a credit system. 1 credit = 1 AI response.

Credits never expire. Buy more anytime from inside your Perfex module (Settings → Buy more credits) or from your dashboard.

PackCreditsPricePer response
Core1,000€9€0.009
Growth5,000€35€0.007
Pro15,000€79€0.005
Agency50,000€199€0.004

License & domain

Your license key is tied to a single domain — the URL of your Perfex CRM installation. The module will only work on that domain.

To change your licensed domain, email support@sociably.media with your old and new domain. Domain changes are verified manually and completed within 24 hours.

Your license key is visible in your dashboard. Keep it private — anyone with your key and domain can use your credits.

Updates

Annual subscribers receive all module updates for 12 months. New versions are released monthly with bug fixes, security patches and new features.

To update:

  1. Download the latest ZIP from your dashboard
  2. In Perfex go to Setup → Modules
  3. Deactivate the current version
  4. Upload and activate the new ZIP

Your settings and license key are preserved during updates.

FAQ

Does Sociably store my client data?

No. Client data (invoices, contracts, notes) is sent to our API only to generate the AI response and is never stored on our servers. See our Privacy Policy for full details.

Can multiple staff members use it?

Yes. Anyone with access to your Perfex CRM can use the AI assistant. The Chrome extension requires each user to enter the license key once.

What happens when I run out of credits?

The AI will stop responding and show a "No credits remaining" message. Your data and settings are preserved. Top up credits from inside the module or from your dashboard.

Can I use it with multiple Perfex installations?

Each license covers one domain. Contact us for multi-domain pricing.

Does it work with all Perfex versions?

Sociably AI works with Perfex CRM version 3.0 and above. If you are on an older version, we recommend updating Perfex first.

What languages does it support?

The AI responds in whatever language the user writes in. It has been tested extensively in Greek and English. All major European languages are supported.

Is there a free trial?

The Core pack (€9 for 1,000 credits) is our entry point. Credits never expire so you can test at your own pace with no time pressure.

Troubleshooting

The AI tab doesn't appear on client profiles

Make sure the module is activated in Setup → Modules. If activated but not showing, try clearing your browser cache.

Test connection fails with "Connection failed"

Your server needs outbound HTTPS access to api.sociably.media on port 443. Some shared hosting providers block outbound connections. Contact your hosting provider and ask them to whitelist api.sociably.media.

Chrome extension shows "No clients found"

Go to Perfex CRM → ClientPortal AI → Settings → Save Settings. This syncs your client list. Wait a few seconds then search again in the extension.

Slack command times out

The /sociably command should respond within 5 seconds. If it times out, check that your Slack workspace is connected in Dashboard → Integrations.

AI gives generic answers without real data

This happens when the module cannot read the client's data from Perfex. Check that the module is activated and that your license key is correct in Settings.

Still need help?
Email us at support@sociably.media — we respond within 24 hours on business days.