iMash

Introduction

Build, test, deploy, and monitor AI agents.

iMash AI Agent Platform

Here's what iMash offers

How iMash Works
Agent platform with voice and automation.
Quickstart
Create your first agent in minutes.

Build

Create Agent
Define behavior, voice and integrations.
Flows
Create structured conversations.

Test

Playground
Test your agents quickly.
Simulation
Automate regression tests.

Deploy

Phone Calls
Make and receive calls.
Custom Telephony
Integrate SIP providers.

Monitor

Webhook
Receive events in real-time.
Analytics
Understand agent performance.
API REFERENCE

CRM Leads

Endpoint /api/v2/crm_leads

Request Builder

Response — 
Click "Execute Request" to see the response

Schema & Fields

Quickstart Guide - How To Create Your First Voice Agent With iMash

This guide provides step-by-step instructions on how to create, configure, and connect an AI voice agent in Imash, including integration with phone numbers, call handling, and system features.

⏱️ Time to complete: 10 minutes

Creating a New Agent

  1. Navigate to Intelligence Center → Smart Agents.
  2. Click Create New Agent.
  3. Assign a meaningful Agent Name (e.g., ‘Ben’).
  4. Select a Model:
    • Real-time model (recommended): fastest and most natural sounding.
    • LLM + STT/TTS integration: fully customisable but may involve additional costs.
    Pricing varies depending on model choice.
  5. Select a Voice Provider:
    • Native voices (recommended when using real time models, they are provided with the model and do not add extra costs).
    • Alternative providers may incur extra costs.
  6. Configure:
    • Opening Message: greeting shown to users.
    • Manual Prompt / Instructions: define style, behaviour, fallback responses.
    • Conversation Starter: choose whether the agent or the user begins speaking.
    • Temperature:
      • Lower values = consistent, predictable responses.
      • Higher values = more creative and random. (Recommended starting value: 0.7).
New agent builder
A brand-new agent opens in the builder, ready to configure
New agent builder
A brand-new agent opens in the builder, ready to configure

Testing the Agent

  1. Open the Test Window → click Test Agent → Connect.
  2. Verify audio interaction (both agent and user voices).
Test your agent
Test the agent live in your browser before going live
Test your agent
Test the agent live in your browser before going live

Configuring Agent Features

  • Knowledge Base: Upload files to extend agent knowledge.
  • Tools: Add functions (e.g., End Call Tool). Agents can trigger tools autonomously.
  • Settings: Define thresholds, such as automatic follow-up messages after user inactivity (e.g., 8 seconds).
  • Privacy: Choose whether to retain or discard call recordings.
  • Advanced: Configure post-call actions, such as summarisation and structured data collection (e.g., user’s name and age).
    At the end of a call: Access Call Logs to review conversations. In the Analysis Tab, view call summaries and structured data collected by the agent for deeper insights.
  • Observer Agent: Provides live cues and monitoring during conversations.
  • Embedding Agents: Agents can be embedded into websites for direct interaction.
  • MCP Automation: Configure automations via the Automation Tab. Automations can be linked to agents using an MCP server.
Agent feature panels
Toggle Knowledge Base, Voice, LLM, tools and more
Agent feature panels
Toggle Knowledge Base, Voice, LLM, tools and more

Connecting a Phone Number

  1. Navigate to Phone Numbers → Buy New Number.
  2. Select country and area code.
  3. Choose and purchase available numbers.
  4. Alternatively, import a SIP provider number by adding provider details in the SIP Providers section.
Phone numbers
Connect a phone number so your agent can take calls
Phone numbers
Connect a phone number so your agent can take calls

Making Live Calls

  1. Open Live Calls Panel.
  2. Click the Telephone Icon (top-right).
  3. Select AI Agent Call mode.
  4. Choose:
    • The Number to call from.
    • The Agent to handle the call.
    • The Target Number to dial.
  5. Join or monitor the call live if needed. Observe real-time interactions and intervene manually when required.
Live calls
Watch calls happen live in the Contact Center
Live calls
Watch calls happen live in the Contact Center

Additional Features in Imash

  • Overview Page: live analytics dashboard.
  • Automation Tab: create workflows and servers.
  • Call Center: manage agents, logs, phone numbers, and SIP providers.
  • Campaigns: create and manage outbound campaigns.
  • CRM: manage accounts, contacts, and leads with lifecycle tracking.
  • Calendar: schedule meetings and assign calls to agents.
  • API Keys: generate keys to use Imash as infrastructure (without UI).
  • Credentials: connect directly with external voice and LLM providers.
  • Account Settings: manage user profile.
  • Billing: manage payment methods and account balance.
  • Demo Data: install prebuilt agents, leads, and records to explore features quickly.
Tools and MCP
Give your agent tools and integrations for more power
Tools and MCP
Give your agent tools and integrations for more power

What's Next?

Congratulations! 🎉 You've successfully set up your first AI agent and made your first API calls. Here's what you can explore next:

Advanced Agent Settings
Learn about custom tools, webhooks, and advanced prompting techniques.
Set Up Phone Numbers
Connect your own phone numbers for inbound and outbound calls.
Create Campaigns
Set up automated calling campaigns with dial lists and scheduling.
Build Smart Flows
Create complex conversation flows with branching logic.

Need Help?

If you run into any issues or have questions:

Build Overview

Design agents, configure flows, and connect tools.

Create Agent

Define goals, voice, and integrations. Save to start testing immediately.

API Reference

All requests require the x-api-key header.

Base /api/v2/
ADD LIST UPDATE DELETE

List Contacts

curl -X GET "/api/v2/contacts?limit=10&order_by=created_at desc" \
  -H "x-api-key: YOUR_SECRET_API_KEY"

Create Contact

curl -X POST "/api/v2/contacts" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_SECRET_API_KEY" \
  -d '{"name":"Ada Lovelace","phone":"+15551234567"}'

Video Tutorials

Learn how to use iMash with step-by-step video guides.

Video Title