How to Use Dashboard Apps in Akece

Dashboard apps allow you to embed a custom application directly within the Akece interface. This feature is ideal for displaying information such as orders, billing history, or customer data right next to the conversation — making your support team's job faster and more efficient.

Your application will load inside the Akece interface and will automatically receive the contact and conversation context via browser events.

How to Create a Dashboard App

1. Go to Settings → Integrations → Dashboard Apps.

2. Click the Configure button under Dashboard Apps.

3. Fill in the following fields:

   • App name: internal name for identifying your app.

   • App URL: the URL where your application is hosted.

Once saved, a new tab will appear in the conversation sidebar with the app name. When clicked, your application will load inside Akece and receive context information automatically.

How to Receive Data from Akece

Akece sends the contact and conversation context using a browser message event. You can capture this data in your app with a simple event listener:

window.addEventListener("message", function (event) {
  if (!isJSONValid(event.data)) return;

  const eventData = JSON.parse(event.data);
  // Use eventData as needed
});

How to Request Context on Demand

If you prefer to manually request the context data, you can send a message to the parent window:

window.parent.postMessage('akece-dashboard-app:fetch-info', '*');

Akece will respond with the context of the conversation, contact, and logged-in agent in the following format:

Example Payload

{
  "event": "appContext",
  "data": {
    "conversation": {
      // Conversation details: messages, status, tags, custom attributes, etc.
    },
    "contact": {
      // Contact info: name, email, phone, custom attributes, etc.
    },
    "currentAgent": {
      // Logged-in agent info
    }
  }
}

Payload Fields Overview

conversation:

• Conversation ID, status, tags, timestamps

• List of messages with sender, type, and content

• Browser attributes and referrer

• Agent and inbox info

contact:

• Name, email, phone, custom attributes

• Social profiles (if available)

• Last activity

currentAgent:

• Name, email, and ID of the currently logged-in agent

With this setup, your application is now fully integrated with the Akece dashboard — with real-time access to relevant customer data. This is a powerful way to extend your support workflows by embedding apps that show order history, subscription details, past payments, and much more — all within the same view.

Need help setting up your custom app in Akece?
Reach out to our support team:
📩 [email protected] | 📱 @akece.ai