Iqra AIIqra AI
Introduction
Platform Management
Build & Deploy
Integrations
Developers
API Reference

The Foundation

Build the Brain, Persona, and Logic of your first AI Agent.

View as Markdown

Before you can make a phone call or deploy a web agent, you need to build the Core Intelligence. This guide covers setting up the "Brain" (AI Models), the "Persona" (Agent), and the "Logic" (Script).

Prerequisites

To complete this tutorial, ensure you have API keys for your preferred AI providers:

  • LLM (Brain): GroqCloud, Anthropic Claude, OpenAI, Google Gemini.
  • TTS (Voice): ElevenLabs, Deepgram, Azure Speech.
  • STT (Ears): Deepgram, Azure Speech.

Infrastructure First

If you are Self-Hosting, ensure you have registered these providers in the Admin Dashboard first. If you are using Iqra Cloud, they are pre-configured; you just need your API keys.

Create a Business Workspace

Everything in Iqra AI happens inside a Business container.

  1. Navigate to the Businesses Tab in your User Dashboard.
  2. Click Add Business.
  3. Give it a name (e.g., "My First Agency") and upload a logo if desired.
  4. Click on the newly created business card to enter the Business Dashboard.

Deep Dive

Learn more about managing workspaces and team isolation in the Business Management guide.

Connect AI Integrations

Give your business the resources it needs to think, hear, and speak.

  1. Go to the Integrations Tab in the Business Dashboard.
  2. Add LLM: Click Add Integration → Select GroqCloud → Paste your API Key.
  3. Add STT: Click Add Integration → Select Azure Speech → Paste your API Key.
  4. Add TTS: Click Add Integration → Select ElevenLabs → Paste your API Key.

Deep Dive

Need help finding your keys? Check our specific guides for Azure, OpenAI, and ElevenLabs.

Create the Agent (The Persona)

Define who is speaking.

  1. Go to the Agents Tab.
  2. Click Add Agent.
  3. General: Name it "Iqra".
  4. Personality: Enter a instruction prompt: "You are a helpful receptionist for a dental clinic. Be polite and concise."
  5. Intelligence: Select the integrations you added in Step 2.
  6. Utterances: Set Agent Speaks First to ON with greeting: "Hello! Thanks for calling Medina Dental. How can I help you?"
  7. Save the Agent.

Deep Dive

The Agent engine is powerful. Learn how to configure Interruption Logic (VAD/Barge-in) and Caching support.

Create the Script (The Logic)

Define what happens.

  1. Go to the Scripts Tab.
  2. Click Add Script.
  3. The Visual Builder: You will see a Start Node.
  4. Drag & Drop:
    • Drag a User Query node from the sidebar. Connect it to Start.
    • Drag an AI Response node. Connect it to User Query.
  5. Save the Script.

Deep Dive

Master the visual builder. Learn about Script Nodes, injecting variables with Templating, and using FlowApps for external tools.

Deploy Your Agent

Your "Iqra" agent is now alive, but she has no way to talk to the world. Choose a channel to deploy her.

Make a Phone Call

Outbound Telephony. Connect a Twilio/Telnyx/SIP number and trigger a call to your own phone.

Receive Phone Calls

Inbound Telephony. Connect a Twilio/Telnyx/SIP number and have the agent pick up incoming calls.

Web Agent

Real-time Web. Create a high-fidelity web session and test it in your browser using our Client SDK.

On this page

PrerequisitesCreate a Business WorkspaceConnect AI IntegrationsCreate the Agent (The Persona)Create the Script (The Logic)Deploy Your Agent