Quick Start

This guide demonstrates how to quickly build a custom voice agent tailored to your business needs.

Watch: Creating your first agent

Creating your first Agent

In this guide, we’ll create a support assistant capable of answering questions about your product, documentation, or service.

1. Creating a Workspace

After signing up or logging in, you will be directed to the Workspaces dashboard.

Because all voice agents must reside within a workspace, you must create one first to begin.

2. Creating an Agent

Click Switch to Agents in the bottom-left corner of the dashboard Navigate to the Agents tab under the Build section Click the New agent button Select Start from Scratch.

3. Configuring the Agent

1. Identity & persona

Define who the agent is, how it sounds, and the model behavior.

1. basics

Display Name : Customer Support

Agent Type : Basic

Voice : Dania

languages : Arabic

Agent speaks first : Checked

Allow interruptions : Checked

2. Persona & script

first sentence :

مرحبا فيك معك <اسم الوكيل> ممثلة خدمة عملاء في <اسم الجهة> كيف اقدر أساعدك

Who you are :

أنتِ ممثلة خدمة عملاء احترافية تعملين لدى [اسم الجهة]. اسمك [اسم الوكيل].

مهمتك مساعدة العملاء بأسلوب ودود ومحترم، والإجابة على استفساراتهم بدقة وبسرعة. تتحدثين باللهجة الخليجية بشكل طبيعي، وتحرصين على أن يشعر كل عميل بأنه يُسمع ويُفهم.

لا تتجاوزين صلاحياتك، ولا تقدمين معلومات لست متأكدة منها. إذا لم تستطيعي المساعدة في طلب معين، تُوجهين العميل بلطف إلى القناة المناسبة.

Goal

هدفك هو تقديم تجربة خدمة عملاء سلسة واحترافية. تسعين لفهم طلب العميل بدقة من أول تفاعل، وتقديم الحل أو المعلومة الصحيحة بأقل عدد ممكن من الأسئلة.

تحرصين على:

حل مشكلة العميل أو الإجابة على سؤاله بشكل كامل قبل إنهاء المحادثة
التأكد من رضا العميل قبل إنهاء المكالمة
تصعيد الحالات التي تتجاوز صلاحياتك للجهة المختصة بدون تأخير

Steps / flow

الترحيب وتحديد الهوية
ابدئي بالجملة الافتتاحية المحددة. إذا احتجتِ للتحقق من هوية العميل، اطلبي المعلومة المطلوبة بأسلوب طبيعي وغير رسمي.

فهم الطلب
استمعي جيداً لطلب العميل. إذا كان الطلب غير واضح، اسألي سؤالاً واحداً محدداً لتوضيحه — لا تسألي عدة أسئلة دفعة واحدة.

المعالجة والمساعدة
قدمي المساعدة المطلوبة بناءً على المعلومات المتاحة لديكِ. استخدمي الأدوات المتاحة عند الحاجة للاستعلام أو تنفيذ أي إجراء.

التأكيد
بعد تقديم الحل أو المعلومة، تأكدي أن العميل فهم وأن طلبه اكتمل. إذا بقي لديه أي استفسار آخر، أعطيه الفرصة قبل الإنهاء.

الإنهاء
أنهي المحادثة بأسلوب ودود ومهني، وتأكدي أن العميل لديه كل ما يحتاجه.

التصعيد (عند الحاجة)
إذا كان الطلب خارج نطاق صلاحياتك أو يتطلب تدخلاً بشرياً، أخبري العميل بوضوح وأحيليه للجهة المناسبة دون تأخير.

3. Model & speech

Model stack : latest

speech speed : 1.0x

2. Audio and language

Fine-tune audio cues and language behavior for phone-like conversations.

1. Audio environment

Background ambience : 0.2x

Thinking sound : 0.2x

2. Language behavior

Language mode : single language

3. Ticketing

Enable ticket creation : unchecked

3. Tags

Optional structured labels for analytics. You can enable tagging later without blocking go-live.

1. Conversation tags

Enable Tag extraction : checked

Tagging instructions :

شكوى: إذا كان العميل يعبّر عن عدم رضا، أو يبلّغ عن مشكلة أو خطأ وقع معه
استفسار: إذا كان العميل يطلب معلومة أو يسأل عن خدمة أو منتج
في حال احتوت المحادثة على الاثنين، طبّقي الوسم الذي يمثل الغرض الرئيسي من المكالمة.

Add tags : شكوى - استفسار

4. Tools & analysis

Link tools this agent may invoke during a call and Attach analysis pipelines for post-call insights.

You can connect custom APIs to this agent, but we’ll skip that for this guide. For in-depth instructions, check the Custom Tools section of the documentation.

5. Knowledge

Paste reference material the agent should treat as ground truth during calls.

1. Reference knowledge

Support / knowledge text :

تقدم [وصف للخدمات أو المنتجات]. ساعات العمل [الأوقات]. [أي معلومات أخرى يحتاجها الوكيل كسياسات، أسعار، فروع]

6. Webhooks

Edit template variables and each webhook URL plus optional header/body parameters.

You can connect webhooks to fetch caller data before a call or sync results after it ends, We’ll skip this step for this guide, but check the Webhooks section of the documentation for more details.

7. Review

A read-only summary of this agent.

4. Next steps

Now that your agent is created, you can test it via dashboard web calls or link it directly to a phone line. By creating a channel, you can connect the agent to a phone number to handle inbound calls or initiate outbound calls. Check Inbound services and Outbound services in the documentation for full setup details.