Docs

Plonom documentation

Everything you need to build, test and run voice and message agents.

Getting started

Plonom runs AI agents that answer your phone and WhatsApp. You build and manage everything from the panel.

Sign in at /home with your panel password.
Create an agent under Build → Agents.
Test it in the browser by voice or by message.
Publish it, then connect a phone number or WhatsApp line.
Follow calls, chats and contacts in Data, and results in Analytics.

Your workspace name and business rules are in Settings → Business.

Create an agent

There are two kinds of agents. Voice agents talk on the phone and in the browser. Message agents chat on WhatsApp and the web.

Go to Agents and click Create an agent.
Choose Voice agent or Message agent.
Enter a name, pick the language and choose a starting point: Business knowledge card (listings, prices and rules filled in) or Blank prompt.
Click Create agent. The editor opens.

Configure the agent

The editor has three columns: the prompt on the left, settings in the middle and the test panel on the right.

Model, voice and language: the brain, the voice and the language the agent speaks.
Prompt: what the agent knows and how it behaves. Variables like {{company_name}} are filled for every call.
Welcome message: the first sentence, or let the customer speak first.
Identity: the persona name and the agent name.
Functions: end the conversation, transfer to a person and the integrations you switched on.
Knowledge base: the libraries the agent answers from.
Speech settings (voice): speed, stability, volume, responsiveness, interruptions, backchannel and background sound.
Call settings (voice): silence timeout, maximum length, reminders and voicemail.
Phone numbers (voice): which numbers this agent answers and calls from.
Chat settings (message): close the chat after silence and the closing message.
Post-call extraction: the fields saved after each conversation, one per line as name | type | description.
Brand details: values for the variables used in the prompt.
Data: how much of each call is stored.

Test the agent

The test panel always uses the latest saved draft. Save before testing your changes.

Voice test: tap the circle and allow the microphone. The circle turns green and the waves follow the agent's voice. Tap again to end.
Message test: type a message. Voice agents can be tested by message too, with the same prompt.
Every test call appears in Call history with a recording link.

Publish and versions

Save draft keeps your changes without affecting live calls. Publish makes them live as a new version: the first publish is v1, the third is v3.

When you save after publishing, the badge shows Unpublished changes until you publish again. The Versions section lists every published version.

Knowledge base

A knowledge base is a library of documents, web pages and texts. Libraries live in the workspace; each agent chooses which ones it answers from.

Open Build → Knowledge base and create a library.
Add texts, web page addresses (one per line) or documents.
Wait until the status is Ready.
In the agent editor, open Knowledge base and tick the library, then save.

Phone numbers

Bring your own number from Twilio, Telnyx, Vonage or your operator over SIP.

Open Settings → Integrations and click Connect a number in the Phone numbers card.
Enter the number, the SIP termination address and, if your provider needs it, the SIP user name and password.
Choose the agent that answers incoming calls and save.
Change it later in the agent editor under Phone numbers, or in the numbers table.

Callbacks: choose the callback agent and caller number to call new contacts back automatically. Use Test call to place a real call.

Message agents do not connect to WhatsApp directly. Plonom sits in the middle: it receives each message, saves the contact, keeps the chat history, asks the answering agent and sends the reply back on WhatsApp.

Your own number: connect your WhatsApp Business number. Customers see your business name and logo; edit the profile on the WhatsApp page.
Answering agent: in the lines table, choose which message agent replies, or the built-in assistant.

Integrations

Integrations work the same for voice and message agents. Connect them in Settings → Integrations, then switch each one on in the agent's Functions and save.

Save contacts (built in): the agent writes the customer's name, need, budget and a summary to Contacts during the conversation.
Cal.com: enter your API key and the event type ID. The agent checks free times and books the slot the customer picks.
MCP: enter the server address and, if needed, an access key. Plonom lists the server's tools; tick the ones the agent may use.
Zapier, Make, n8n: paste the webhook address. The agent sends each contact to your workflow.

Webhook payload sent to Zapier, Make and n8n (JSON):

{
  "name": "send_to_zapier",
  "args": {"name": "Omar Haddad", "phone": "+971505550101", "need": "2BR in Marina",
           "budget": "2M AED", "summary": "Wants a viewing on Saturday"},
  "call": { ... conversation details ... }
}

Calls, chats and contacts

Call history: every call with recording, transcript, summary, mood and outcome.
Chat history: every WhatsApp and web conversation.
Contacts: everyone your agents spoke to, with stage, need and source. Open a contact to read the conversation, change the stage or take over.
Export: download your contacts as CSV from the Contacts page.

Analytics

See calls, chats and agent performance for the last 7, 30 or 90 days. Needs review lists conversations with a negative mood, an unsuccessful outcome or a request for the team.

Settings and security

Business: workspace name, business, hand-off person and hours, follow-up time, owner's WhatsApp and panel password.
Integrations: phone numbers, WhatsApp and agent tools.
The panel always asks for the password. After 8 wrong attempts the address is locked for 15 minutes.
Incoming events are signed and checked, keys stay on the server and every page is served over HTTPS.