Add it to your app
Turn it on
Add the help chat
Write or import your articles
Try it
How a chat works
- A customer writes in your app’s help chat.
- If AI answers is on, the AI replies in a few seconds, using your articles and that customer’s earlier chats. Under the answer, the customer sees which article it came from.
- When the articles don’t cover the question, or the customer asks for a person, the AI hands over: I’ll get the team to look at this. They’ll reply here. The chat shows as Waiting for you in your Inbox.
- You reply from the Inbox. Your reply appears in the customer’s chat right away. From then on you have the chat: the AI stays out of it, and the customer’s next messages wait for you. To let the AI answer again, choose Let AI answer in the chat’s ⋮ menu.
- When the customer says thanks, the AI asks if there’s anything else. If they say that’s all, the AI says goodbye and marks the chat Resolved. You can also select Resolve yourself.
- A resolved chat shows as resolved in your app too, and the customer is asked to rate it. If they write again, a new chat starts.
Inbox
The Inbox lists every chat, newest first, with the customer’s first question, their name and where the answer came from. Filter with All, Waiting for you, Pending, Snoozed and Resolved.- AI answers switch: at the top of the Inbox. Turn it off to answer every question yourself. Customers then see Thanks, the team will reply here soon., and no credits are used.
- Test chats: chats from development builds (the simulator, a dev client) carry a Test tag. Turn on Hide test chats to see only chats from your released app.
- Reply or Private note: in a chat, switch the composer to Private note to leave a note for your team. Notes show in yellow. Customers never see them, and the AI never reads them.
- Resolve and Reopen: Resolve ends the chat and asks the customer for a rating. Reopen lets you reply again.
- Pending and Snooze: in a chat, the ⋮ menu has Mark as pending, Snooze until tomorrow and Snooze for a week.
- Let AI answer: once you reply in a chat, the AI stops answering it. Let AI answer in the ⋮ menu hands it back; if the customer’s last message is unanswered, the AI answers it right away. The option shows only while you have the chat, and replying again takes it back.
- Close inactive chats: in Setup, Close inactive chats after (5 days by default) closes chats the customer stopped answering after your team or the AI replied. The customer sees that it closed and can write again any time. Chats waiting for you never close. Set it to 0 to turn this off.
- Download transcript: the ⋮ menu in a chat saves it as a text file, including private notes.
Feedback
The Feedback tab shows how customers rated their resolved chats: the average out of 5, how many ratings of each score, and the latest rated chats. Each shows whether the AI or your team answered it. Select one to open the chat. Ratings also show on resolved chats in the Inbox.Knowledge base
The AI answers only from your knowledge base and the customer’s earlier chats. It doesn’t invent prices, policies or steps.- Add article: write a title and the answer, in plain text or markdown.
- Upload PDF: pick a PDF guide or FAQ. The AI reads it once and saves it as articles you can edit. Each import uses 1 credit.
- Add from link: paste the address of a public page, like your help site, FAQ or website. The AI reads it once and saves it as articles. Each import uses 1 credit. Select Refresh on those articles to read the page again after it changes.
- Chat history: turn off Chat history if you don’t want the AI to use a customer’s earlier chats.
Your articles in your project, and on your website
The agent keeps a copy of your articles in your project, insupport/articles: one file per article plus one list of them all. If you take your code elsewhere, your articles go with it. Ask the agent Export my support articles any time to update the copy.
While Support in your app is on, your website’s FAQ uses the same articles, so your site and your help chat always give the same answers. Edit an article in Knowledge base, then ask the agent to update your website. Edit articles in Newly, not in those files: the next export replaces them.
AI answers and credits
AI answers use your Newly credits. In Setup, under AI answers, choose the Answer quality:- Daily AI answer limit: caps AI answers per day (200 by default, up to 5,000). Past it, questions wait for you until the next day.
- Out of credits: AI answers pause. Customers see Thanks, the team will reply here soon., and the Inbox shows a banner. Answers start again as soon as you add credits. See Out of credits.
- Your replies, private notes and test chats you answer yourself are free.
Recognise signed-in customers
If your app has sign-in, the help chat can show who the customer is, and their chats follow them across devices. Open Setup, then Developer settings, then Recognise signed-in customers:- Supabase: ask the agent Recognise signed-in customers in support. It passes the customer’s sign-in to the chat and gives you the three values to paste here. Only you can save them, because they decide who a customer is.
- Firebase, Clerk, Auth0 and others: enter the Issuer, Signing keys URL and Audience from your sign-in provider.
- Your own server: select Create secret key under keys. Your server uses it to vouch for the signed-in customer. The key is shown once; keep it on your server, never in your app.
Keys
Your app connects to support with a publishable key, one for development builds and one for released builds. It’s safe to ship inside your app: it only opens your app’s help chat. The agent writes both keys into your app when it adds support. If a key leaks or you want to change it, select Rotate in Developer settings. The old key stops working right away, so ship an update with the new one.FAQ
Do my customers need a Newly account?
Do my customers need a Newly account?
Why don't I see my test messages in the Inbox?
Why don't I see my test messages in the Inbox?
How do I make sure my released app uses the right key?
How do I make sure my released app uses the right key?
Can I answer every question myself, without AI?
Can I answer every question myself, without AI?
What does the AI do when it doesn't know the answer?
What does the AI do when it doesn't know the answer?
Why doesn't the AI answer a chat I replied in?
Why doesn't the AI answer a chat I replied in?
Why did the AI stop answering?
Why did the AI stop answering?
Why did a link import say there was nothing to add?
Why did a link import say there was nothing to add?
Can my customers see private notes?
Can my customers see private notes?
Do I keep my articles if I move my app's code elsewhere?
Do I keep my articles if I move my app's code elsewhere?
support/articles. Ask Export my support articles to update it. PDFs and pages you imported aren’t kept, only the articles made from them.Can my website's FAQ use my support articles?
Can my website's FAQ use my support articles?
Can I keep a record of a chat?
Can I keep a record of a chat?
Does the AI close chats by itself?
Does the AI close chats by itself?
Where do I see how customers rated their chats?
Where do I see how customers rated their chats?
Can my customers see their earlier chats?
Can my customers see their earlier chats?
What's the difference between Pending and Waiting for you?
What's the difference between Pending and Waiting for you?
What happens if a customer writes after I resolve a chat?
What happens if a customer writes after I resolve a chat?
Does it work on web builds of my app too?
Does it work on web builds of my app too?