Receive Phone Calls
Configure inbound routing, IVR language selection, and handle customer calls.
Now that you have an Agent and Script, let's set up a digital receptionist.
Inbound Routing allows you to connect a phone number to an Agent. It also handles the initial handshake, such as asking the user for their preferred language ("Press 1 for English") before the AI takes over.
Prerequisites
- A Twilio, Telnyx, or SIP account with a purchased phone number.
- Account SID and Auth Token (or API Key).
Connect Telephony & Add Number
If you haven't already connected your carrier:
- Navigate to Business Dashboard → Integrations.
- Add your Twilio or Telnyx integration.
- Go to the Numbers Tab and click Add Number.
- Enter your number in E.164 format (e.g.,
+1234567890) and select the Route Server Region.
Webhook Configuration
For Inbound calls to work, your carrier must send the call to Iqra AI.
- Twilio/Telnyx: We attempt to auto-configure the webhook when you save the number.
- SIP/Others: You must manually copy the Webhook URL displayed in the Numbers list and paste it into your carrier's portal.
Deep Dive
Trouble connecting? Read our detailed guide on Managing Phone Numbers and manual webhook setup.
Create Inbound Route
The "Route" is the logic that decides who picks up the phone.
- Go to Routing → Inbound Routing.
- Click Add Route.
- Number: Select the phone number you added in Step 1.
- Agent: Select your "Iqra" agent.
- Script: Select your script.
Deep Dive
Inbound Routes are powerful. You can configure Webhooks & Actions to trigger external tools (like a CRM update) immediately when the phone rings or when the call ends.
Configure Language (IVR)
Iqra AI features a built-in Programmatic IVR.
- Single Language: If you only enable "English", the Agent picks up immediately.
- Multi-Language: If you add "English" and "Arabic", the system automatically plays: "Press 1 for English. Press 2 for Arabic."
For this test, stick to Single Language (English) for the fastest pickup time.
The Test
- Pick up your personal phone.
- Dial the business number you configured.
- Ring... Ring...
- The system should answer, and your Agent should speak the greeting: "Hello! Thanks for calling..."
Real-time Monitoring
While on the call, you can watch the "Brain" work in real-time.
- Open the Conversations Tab in your dashboard.
- You will see a row with status Active.
- Click on it to see the live transcript as you speak.
Deep Dive
Want to analyze the conversation after it ends? Check out History & Logs to listen to recordings and view debug traces.
Troubleshooting
- Busy Signal? This usually means the Webhook failed.
- Check your Twilio/Telnyx console. Ensure the "Voice URL" is pointing to
https://.../webhooks/twilio. - Ensure you have credits in your Iqra AI account (if using Cloud).
- Check your Twilio/Telnyx console. Ensure the "Voice URL" is pointing to
- Silence after pickup? This is often a Region Mismatch. Ensure your Number, Route Server, and TTS Provider are in the same region (e.g., US-East).