Dashboard apps

A dashboard app embeds an external page directly into the conversation view, so agents see what they need without switching systems.

Setting one up

1. Open Settings → Integrations → Dashboard Apps.
2. Configure an app.
3. Enter a name and the page URL.

The app appears in the panel beside the conversation.

Receiving conversation context

The embedded page receives conversation and contact data through window messages:

window.addEventListener("message", (event) => {
  const data = JSON.parse(event.data);
  // data holds the conversation and contact details
});

You can request fresh data yourself:

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

Uses

• An order card from your own system;
• A customer's purchase history;
• Delivery status;
• Data from an accounting system.

Recommendations

• The page has to be served over HTTPS.
• Design a narrow layout: it is shown in a side panel.
• Do not ask agents to sign in separately — use the contact identifier from the context.