plugin-conversations

Preview

@fayz-ai/plugin-conversations

Customers reach out everywhere — a WhatsApp here, an Instagram DM there, an email, a text. Replying across five tabs is how businesses drop conversations. plugin-conversations is the GoHighLevel-style unified inbox for the Fayz engine: every channel collapses into one threaded view, so a salon, a restaurant, or an agency answers everyone from a single place.

Preview of plugin-conversations as the customer sees it

Full documentation is coming. For now, this page summarizes what the SDK catalog knows about the plugin.

Specs

Package	`@fayz-ai/plugin-conversations`
Version	0.2.4
Status	preview
Capability	Partial capability
Stable channel	`^0.2.4`
Migrations	none
Factory	`createConversationsPlugin()`

Data model

Table	Key columns
`plg_conversations`	contact_name, contact_handle, channel, last_message_preview, last_message_at, unread_count
`plg_conversation_messages`	conversation_id, channel, direction, body, author, at

Convention: plg_ + tenant_id + RLS. Data model.

AI tools

id	mode	description
`conversations.list-threads`	read	Lists open conversations across all channels, optionally filtered by channel.
`conversations.send-message`	persist	Sends a reply in a conversation thread.

Tools an agent can call against your app. Your app as a data layer.

Integrations

No hosted connector — external providers come in via the connector spine. integrations catalog.

Use this page as a skill. .md of this page is the agent-consumable contract — data model, tools and integrations in a single file an AI reads directly. Preview fayz skill add plugin-conversations is coming soon to install this as a skill. See Skills.

Integrate

Add the plugin to surfaces.admin.plugins in your app's app.manifest.json and run the doctor to validate:

{
  "surfaces": {
    "admin": {
      "plugins": [
        { "id": "conversations", "enabled": true }
      ]
    }
  }
}

npx fayz doctor

fayz doctor checks the manifest against the SDK catalog. See Configuration.