Documentation menu

Internal tools

Internal tools are the back-office side of your project — the pages where you look up a customer, check how your app is doing, and work your marketing. Every project starts with three of them: Users, Analytics, and Marketing. You can add as many custom ones as you need. For how they sit alongside your public apps, see Apps and tools.

Only you see them

Internal tools live inside Spark and share your sign-in. They have no public address, so your customers can never reach them, even with a link.

Each tool opens as its own full page in the platform. Apps show their work-in-progress in a preview frame beside the chat; an internal tool is the page itself, so it carries a Live/Preview bar along the top. Live shows the published version. Preview shows what the agent has built since. For where everything sits, see Around the platform.

Users

Users is a roster of your apps’ customers — everyone who has signed in. You can search it, sort it, and switch between saved views: all, active this week, heaviest usage, went quiet, and no profile. Each row carries a person’s activity counts and a sparkline of their recent activity, and you can export the whole list as a CSV.

Click a row to open the person panel: how they signed in, their recent conversations in your chat app, and what their activity has cost. The AI-usage numbers here are metered to your project — they show what that customer’s activity costs you, in the same usage your plan and credits cover. Customers are never billed for their own usage.

Before anyone has signed in, the page shows a single prompt pointing you toward sharing your app.

Analytics

Analytics answers one question: how people are using your app. It reports the totals — conversations, people, and messages — the ratios between them, and the newest people to arrive. When you want the full list, Users has it. A closing panel names the questions the page can’t answer yet, so you always know what it does and doesn’t cover.

Marketing

Marketing holds a marketing plan for your business. The agent researches your market — reading your business profile and brand and your live site, plus web research — writes a short read on where you can win, and proposes channels, ranked, each with the reason it made the list and a checklist of actions. The plan stays a proposal until you click Start this plan.

As you work through it, drafted content lands on the content shelf: scripts, emails, replies to community threads the agent found for you. Once you’ve shipped a piece, Mark posted records it against the plan. Every draft carries Work on this and Adjust it in chat, which drop a ready-made prompt into the agent chat for you to send.

Build a custom tool

Your business will eventually need a back-office page nobody ships off the shelf. Describe it. A support inbox where you reply to customer emails, a view of everything you’ve sent, a weekly report — pick Custom tool from the + New picker, tell the agent what you want, and it builds the page for you. The result sits alongside Users and Analytics and works the same way.

Edit and publish a tool

Changing an internal tool is the same conversation as changing an app: tell the agent what you want, watch Preview update, and publish from the Live/Preview bar when it looks right. Versions, History, and Restore work the same as everywhere else — see Preview and publish.

Each tool also keeps an activity log of what happened in its area, so you can trace what changed and when without asking anyone.