How it works
- In the dashboardDeclare the action
Give it a name, a description and the fields it needs, in the dashboard.
- On your pageRegister the code
Your page supplies the function with a few lines of JavaScript.
- In the dashboardPick a rule
Choose when the agent must ask the user first.
- In the chatLet it run
The agent offers the action when it fits the conversation.
The code that runs is yours
The action runs in the browser with the rights that user already has. ChatterMate never sees their password or session.
ChatterMate.registerActions({
update_billing_email: {1
run: async ({ email }) => {
await api.updateBillingEmail(email)2
return { ok: true }3
},
},
})- 1
The name of the action you declared in the dashboard.
- 2
Your own function calls your API, the way your page always does.
- 3
It returns the result, and the agent tells the user what happened.
When the agent asks first
- Never ask
For harmless steps, like saving a draft or reading a value.
- Ask when overwriting
Shows the old and new values first when something would be replaced.
- Always ask
For anything that matters, like sending an invoice or changing access.
Guard rails built in
- Only what you allow
- The AI is offered only actions you declared, enabled and registered on that page.
- Only where you allow
- Actions run only on the domains you list for the widget.
- A real confirmation
- The widget draws the confirm card, so the model cannot skip it. Unanswered, it lapses after five minutes.
- Sensitive forms
- Mark a form as sensitive and IDs or bank details stay out of what the AI sees.
- Stored safely
- Copies of action arguments and results are stored encrypted.
- Sensible limits
- Up to 30 actions per agent, fewer on the Free plan, and up to 3 pauses for approval per reply.

Good first actions
Start with small, safe steps. Ask first for anything that sends, deletes or charges.
- Update a billing email
- Create a client or a project
- Resend an invite
- Change a setting the user is allowed to change
- Mark a task as done
Where it works
In-app actions run in the website widget, because they need your page and your code. On WhatsApp, Slack and the other channels, the same agent answers and hands off, but it cannot act in your app. Pair actions with journeys to guide new users step by step.
- Answers: yes
- Hands off: yes
- Acts in your app: yes
- Answers: yes
- Hands off: yes
- Acts in your app: no
In-app actions questions
Do I need a developer?
Yes, once, to register the functions on your page. After that your team manages the actions and rules in the dashboard.
Can the AI call my backend directly?
No. It asks your page to run a function you wrote, and your page calls your backend the way it always does.
What if the action fails?
Your function returns the result, and the agent tells the user what happened.
Does it work on mobile apps?
It works wherever your web app runs in a browser with our widget. Native apps are not supported.