Assistant
The Assistant is a chat inside the Fonema dashboard. Ask it about your agents, your calls and your WhatsApp conversations in plain words, and it answers with numbers, tables and charts taken from your own account. If you are an admin, it can also make changes for you, such as updating an agent's prompt.
Where to find it
Assistant is the first item in the left menu. It is also the page you land on after logging in.
- Admins and operators can use it. Operators can ask about everything and start calls, but cannot change agents, the same as in the rest of the dashboard.
- Users whose access is limited to the Calls page do not have the Assistant.
- It only works with your company's data, and each person only sees their own conversations.
Start a conversation
Type your question in the box and press Enter. Use Shift + Enter for a new line.
The cards around the flame show things the Assistant can do. Click one and it starts the sentence for you. The grey text is a suggested ending: press Tab to accept it, or keep typing your own. More actions opens a few more ideas.
While it works, the Assistant shows each step it takes, for example Looking up agents or Calculating call stats. Click Stop to end an answer early.
What you can ask
Results and numbers
- How many calls were made yesterday and how many were successful?
- How did the appointment reminders go last week?
- Show me the KPIs for my agents over the last 7 days
- How much did the calls cost this week, and how much per successful person?
How the Assistant counts:
- People first, calls next to them. One customer is often called several times. For questions about results, the Assistant reports people (how many you tried to reach, how many answered, how many had a successful call) and adds the number of calls beside it, so the two are not mixed up. A person who was called five times and said yes on the fifth call counts as one successful person.
- "Successful" depends on the agent. It means the call met that agent's own success criteria: a sale for one agent, a confirmed appointment for another. The Assistant tells you how it counted when there is room for doubt.
- Dates such as today, yesterday or this week follow the time zone of your browser.
- Costs are shown in US dollars.
- Up to 30 days per query. For longer periods the Assistant works in parts and tells you. People counted in separate parts are not added together, because the same person can appear in both.
If you want the other view, ask for it: "per call instead of per person", "only the collections agent", "per day".
Charts and tables
Ask for a chart, or let the Assistant add one when a trend or a comparison is easier to read as a drawing. It can draw bar, line, pie and doughnut charts, and rankings.
- Build a bar chart of the answered and not answered calls per day last week
- Build a line chart of the number of calls per day this month
- Build a table with the last 20 calls, their duration and outcome
Under every chart you have:
- Show data: the same numbers as a table.
- Copy image and Download image: the chart as a picture, ready to paste in a report or a chat.
- Download Excel: the chart's numbers as a spreadsheet.
Tables appear in the conversation itself. The Excel download belongs to charts.
One call or one customer
- What happened with the call to +52 55 5550 0142?
- Summarize the last 5 calls and tell me what went wrong
- What did this customer write on WhatsApp?
The Assistant reads the call's summary, transcript and captured data, and the messages of WhatsApp and web chat conversations. Agent names and call ids in its answers are links: they open the agent or the call in a new tab.
Your agents
- Which agents do I have and what does each one do?
- What does Sofía say when someone asks about prices?
- Which skills does my reminders agent have?
Changes to agents (admins only)
- Read the attached script and update my agent's prompt
- Change Sofía's greeting to "Hi, this is Sofía from Brisa Dental"
- Sofía should only call Monday to Friday from 9:00 to 18:00
- Add a skill to Sofía that emails me a summary when a patient asks to reschedule
- Create a new agent that confirms next-day appointments
| The Assistant can | Done in the dashboard |
|---|---|
| Create an agent (name, prompt, voice, greeting, farewell, captured data) | Phone numbers, knowledge base files and webhooks |
| Change an agent's name, voice prompt, text (WhatsApp) prompt, greeting and farewell | Any other agent setting, such as the voice of an existing agent |
| Change the data an agent captures (output variables), its working hours and whether it allows return calls | Deleting an agent |
| Add, edit and remove skills of type Send email, Call to GPT and Make a phone call | Skills of type API call, HubSpot, Google Calendar and WhatsApp template |
Good to know:
- A change is applied right away. There is no separate confirmation step and you do not need to click Update. The agent is published with the change, and it is saved as a new version of the agent like any other update.
- It changes only what you asked for and then tells you what changed, before and after.
- To review first, say so: "Show me the new greeting and wait for my OK before changing it." When a request is unclear (which agent, which text), the Assistant asks before acting.
Place a call
Admins and operators can ask the Assistant to call someone with one of their agents:
- Call +52 55 5550 0142 with Sofía. The patient's name is Ana.
- Call this number with Sofía in 30 minutes
This dials a real person. The call is queued and placed within about a minute, or when the agent's working hours start if it is outside them. You can delay it by up to 7 days. If the agent's prompt needs data for the call (for example an appointment date), the Assistant asks you for it first.
It places calls one at a time, up to 10 calls every 10 minutes per user. For a list of contacts, use automated calls.
Attach documents and images
Click the paperclip, or drag files onto the message box. You can send them with or without text.
| Formats | Limits | |
|---|---|---|
| Images | PNG, JPG, WEBP, GIF | Up to 5 per message, 4 MB each. Larger photos are made smaller automatically before they are uploaded. |
| Documents | PDF, Word (.doc, .docx), OpenDocument (.odt), RTF, Excel (.xls, .xlsx), HTML, text (.txt) and Markdown (.md) | Up to 5 per message, 20 MB each. Very long documents are cut at 80,000 characters. |
The Assistant sees the images themselves (a screenshot, a photo of a price list, a flyer) and reads the text of the documents. A typical use: attach your new script or price list and ask it to update an agent.
- An image that you attach but do not send within a day expires. Attach it again.
- After many attachments in the same conversation, the Assistant asks you to start a new one.
- Other image formats, such as HEIC, are not accepted.
Your conversations
Conversations are saved. The list on the left groups them by Today, Yesterday, Last 7 days and Older, and each one is named after its first message.
- New conversation starts a clean chat.
- The … button next to a conversation lets you Rename or Delete it.
- The icon next to New conversation hides the list, and the same spot brings it back.
- An answer keeps running if you open another conversation or leave the page. Come back and it is there.
- Each conversation answers one message at a time.
Start a new conversation for a new topic. In a very long conversation the Assistant works with the most recent messages and may no longer take the earliest ones into account.
What the Assistant cannot do
- Send WhatsApp messages or reply to chats. It only reads those conversations.
- Play or download call recordings. Open the call to listen to it.
- Delete agents, or change the settings listed under Done in the dashboard above.
- Manage billing, users, telephones or WhatsApp templates. Use their pages in the dashboard.
- Launch a batch of calls. It places one call at a time.
Limits
| What | Limit |
|---|---|
| Messages | 10 per minute per user, up to 20,000 characters each |
| Statistics | 30 days per query |
| Calls placed by the Assistant | 10 every 10 minutes per user |
| Agents created by the Assistant | 20 per hour per user |
| Very long tasks | After many steps in one answer, the Assistant pauses and asks you to tell it to continue |
The same tools in other AI apps
The Assistant uses the same tools as the Fonema MCP server. To ask the same questions from an AI app outside the dashboard, see What is the Fonema MCP?.