FAQs
Current answers for SupportGPT setup, billing, sources, widget deployment, and troubleshooting.
Account And Workspace
How do I create an account?
Sign in at supportgpt.app. After sign-in, create a workspace or open an existing workspace.
What is a workspace?
A workspace contains members, billing, plans, usage, agents, and shared knowledge sources.
What roles exist?
The app currently uses Owner, Admin, and Member roles. Owners have the highest control, admins can manage most workspace operations, and members have standard workspace access.
Agents And Sources
How do I create an agent?
Open a workspace, go to Agents, select New AI agent, enter a name, and create it.
Which source types are supported?
Supported source areas are Files, Text, Website, Q&A, and Notion.
Which file types can I upload?
The dashboard accepts PDF, DOC, DOCX, and TXT. Text extraction is strongest for PDF, DOCX, and TXT.
Why is my agent giving outdated answers?
Delete stale source files, upload the newest source, and test again in Playground. Conflicting old and new files are a common cause of incorrect answers.
Does SupportGPT use all workspace sources for every agent?
Sources are stored at the workspace level. Agents in the workspace retrieve from workspace knowledge using their own instructions, model, and match threshold.
Widget And Deployment
What is the recommended deployment method?
Use the chat bubble from Deploy -> Embed for most websites. Use the iframe when you want a fixed chat panel inside a page.
Can I use SupportGPT in Next.js?
Yes. Deploy -> Embed includes a Next.js Script Component example.
Can I identify logged-in users?
Yes. Generate a server-side HMAC with the agent secret and call window.supportgpt.identify() with userId, userHash, and optional user_metadata.
Should I put the identity verification secret in the browser?
No. Keep the secret server-side and send only the generated hash to the browser.
Human Handoff
How do I enable human support?
Open Agent settings -> Human Handoff, enable the feature, configure triggers, and ask team members to monitor Inbox.
When does a chat escalate?
Escalation can happen through the Talk to Human button, trigger keywords, negative sentiment, and optional message-count rules.
Where do human agents reply?
Open Agent -> Inbox. Team members can set their status, assign conversations, reply to visitors, leave internal notes, and resolve conversations.
Billing And Usage
Which plans exist?
The dashboard currently shows Free, Hobby, Standard, Pro, and Enterprise options.
Where do I see credits?
Use Usage for workspace usage charts and Workspace settings -> Billing for remaining credits, used credits, total credits, and subscription status.
Who can manage billing?
Owners and admins can manage billing. Some actions, such as cancellation, are owner-only.
Developer Surface
Is there a public REST API?
Not as a stable documented product API yet. The current public integration surface is the hosted embed script and iframe.
Is there an npm SDK?
Not currently. Use https://supportgpt.app/embed.min.js and the window.supportgpt browser API.