- শব্দগুলো
- শুরু থেকে শেষ
- মেনু ধরে ধরে
- ইনবাউন্ড ও আউটবাউন্ড (বিস্তারিত)
- কল লিংক (বিস্তারিত)
- ডেভেলপারদের জন্য
- নিরাপত্তা
- English guide
- Inbound and outbound (English)
- API reference
Parley ব্যবহারের পুরো গাইড
Parley হলো AI ভয়েস এজেন্ট — মানুষের মতো বাংলা/ইংরেজিতে ফোনে কথা বলে: অর্ডার কনফার্ম করে, অ্যাপয়েন্টমেন্ট মনে করিয়ে দেয়, কলের উত্তর দেয়, দরকার হলে মানুষের কাছে কল দিয়ে দেয়। এই গাইডে আছে অ্যাকাউন্ট খোলা থেকে শুরু করে প্রতিদিনের কাজ পর্যন্ত সব — কোনটা লাগবেই, কোনটা ঐচ্ছিক, আর কোন মেনুতে কী।
এজেন্ট বানান→টেস্ট করুন→কল শুরুর উপায় বাছুন→কল দেখুন→ফলাফল আপনার সিস্টেমে
কয়েকটা শব্দ আগে বুঝে নিন
| শব্দ | মানে |
| এজেন্ট (Agent) | যে কল করে বা কল ধরে। দুই রকম: আউটবাউন্ড (নিজে কল করে) আর ইনবাউন্ড (আপনার নম্বরে আসা কল ধরে)। |
| স্কিল (Skill) | এজেন্টের "মাথা": কী বলবে, কীভাবে বলবে, কী জানতে চাইবে, কখন মানুষের কাছে দেবে। একটা স্কিল অনেক এজেন্ট ব্যবহার করতে পারে। |
| ভার্সন ও পাবলিশ | স্কিল বদলালে নতুন ভার্সন হয়। পাবলিশ না করা পর্যন্ত আসল কলে নতুন ভার্সন চলে না — তাই নিশ্চিন্তে বদলানো যায়। |
| ভ্যারিয়েবল | প্রতি কলে বদলায় এমন তথ্য: কাস্টমারের নাম, অর্ডার নম্বর, টাকা। এজেন্ট কথায় এগুলো বলে। |
| ফলাফল (Result) | কল শেষে এজেন্ট যা বের করে: কনফার্ম / বাতিল / পরে কল চাই ইত্যাদি। রিপোর্ট, ক্যাম্পেইন আর আপনার সিস্টেমে যায়। |
| হ্যান্ড-ওভার | এজেন্ট কল মানুষের হাতে দেয় — লাইভ ডেস্কে বা একটা ফোন নম্বরে। |
| ক্যাম্পেইন | একটা তালিকা (CSV) ধরে সবাইকে কল; না ধরলে নিজে থেকে আবার চেষ্টা। |
| কল লিংক | আপনার দোকান/CRM ডেটা পাঠালেই কল — কোড ছাড়া। |
| ওয়ালেট ও প্ল্যান মিনিট | প্ল্যানে মাসিক মিনিট থাকে; শেষ হলে ওয়ালেটের টাকা থেকে কাটে। ১০ সেকেন্ডের ধাপে বিল, না ধরা কল ফ্রি। |
শুরু থেকে শেষ: ধাপে ধাপে
| # | কী করবেন | লাগবে? | কোথায় |
| ১ | অ্যাকাউন্ট খুলুন: নাম, কোম্পানি, ইমেইল, পাসওয়ার্ড, দেশ, ভাষা। ইমেইলে আসা কোড দিন (বা Google দিয়ে)। | লাগবেই | সাইটের Start building |
| ২ | এজেন্ট বানান: কাজটা নিজের ভাষায় লিখুন, Parley এজেন্ট বানিয়ে দেবে — অথবা টেমপ্লেট থেকে। | লাগবেই | Overview / Agents → Describe a new agent / এজেন্ট এডিটর |
| ৩ | টেস্ট করুন: ব্রাউজারে কথা বলে, নিজের ফোনে কল নিয়ে, বা টেক্সট চ্যাটে। | অবশ্যই করুন | উপরের মাইক বাটন, এজেন্ট এডিটরের ডান পাশে Chat / Talk, Test call |
| ৪ | স্কিল ঠিক হলে Publish করুন। চাইলে "গোল্ডেন টেস্ট" যোগ করুন — পাবলিশের আগে নিজে থেকে চলে। | পাবলিশ লাগবেই, টেস্ট ঐচ্ছিক | Skills → স্কিল |
| ৪ক | দরকার হলে: দামের তালিকা/FAQ Files-এ আপলোড করে এজেন্টে টিক দিন; কলটা ধাপে ধাপে Flows-এ আঁকুন। | ঐচ্ছিক | Files, Flows, এজেন্ট এডিটর → Knowledge |
| ৫ | ফোন লাইন: Parley-র লাইনে কল যায়। নিজের নম্বর থেকে কল চাইলে নিজের SIP trunk যোগ করুন; কল ধরার জন্য নম্বর লাগে। | আউটবাউন্ডে ঐচ্ছিক, ইনবাউন্ডে নম্বর লাগবেই | Providers, Phone numbers |
| ৬ | কল শুরুর উপায় বাছুন (অন্তত একটা): কল লিংক (কোড ছাড়া), ক্যাম্পেইন (CSV তালিকা), API (ডেভেলপার), বা হাতে Test call। | অন্তত একটা | Call links, Campaigns, Developers |
| ৭ | যাচাই (KYC): ক্যাম্পেইন চালু করতে Meghly আপনার ব্যবসা যাচাই করে। সাপোর্টে যোগাযোগ করুন। | ক্যাম্পেইনে লাগবেই | Settings → Calling rules-এ অবস্থা দেখা যায় |
| ৮ | মানুষের সাহায্য: এজেন্ট কঠিন কল লাইভ ডেস্কে বা কোনো ফোনে দেবে। | ঐচ্ছিক | Live desk, স্কিলের Transfer to a phone |
| ৯ | ফলাফল আপনার সিস্টেমে: কল লিংকের ফলাফল রিকোয়েস্ট, বা ওয়েবহুক। | ঐচ্ছিক | Call links (৩ নম্বর অংশ), Developers → Webhooks |
| ১০ | প্রতিদিন: কল, রেকর্ডিং, ট্রান্সক্রিপ্ট, AI সারাংশ দেখুন; ড্যাশবোর্ডে ফলাফল। | — | Overview, Calls, Analytics |
| ১১ | টাকা: প্ল্যান মিনিট দেখুন; ওয়ালেটে টাকা — bKash/ব্যাংক/নগদে Meghly-কে দিয়ে টপ-আপের রিকোয়েস্ট পাঠান (Meghly মিলিয়ে যোগ করে), বা অনলাইন পেমেন্ট চালু থাকলে সরাসরি। | মিনিট শেষ হলে লাগবেই | Billing |
মিনিট বা ওয়ালেট না থাকলে নতুন কল হয় না; অ্যাকাউন্ট স্থগিত হলে সব দেখা যায় কিন্তু কিছু বদলানো বা কল করা যায় না।
প্যানেলের বাঁ দিকের মেনু ছয় ভাগে: Overview, Build (তৈরি), Run (চালানো), Observe (দেখা), Connect (যুক্ত করুন), Account (অ্যাকাউন্ট)। সবার নিচে Docs (এই গাইড)। উপরের ডান কোণে সবসময় একটা মাইক বাটন — এজেন্টের সাথে কথা বলুন: যেকোনো পেজ থেকে একটা এজেন্ট বেছে ব্রাউজারে কথা বলুন।
Overview (ওভারভিউ)
- সময় বাছুন: আজ / ১৪ দিন / ৩০ দিন। উপরে সংখ্যার ঘর: কল, উত্তর, কাজ সফল, মানুষের কাছে দেওয়া, খরচ — প্রতিটার পাশে আগের একই সময়ের তুলনায় কত বাড়ল/কমল।
- চার্ট: দিনে দিনে কল আর উত্তর (লাইন), কল কীভাবে শেষ হলো (গোল চার্ট, পাশে তালিকা), এজেন্ট অনুযায়ী খরচ আর সফলতা (বার)। প্রতিটা চার্টে সংখ্যাও লেখা থাকে।
- Needs your attention: কলব্যাকের অপেক্ষায় থাকা মানুষ, ফেল করা কল, মিনিট শেষ হওয়া। Live now: এই মুহূর্তের কল। Recent calls, ক্যাম্পেইনের অবস্থা।
- নতুন অ্যাকাউন্টে এখানেই "আপনার এজেন্ট কী করবে?" — কাজটা লিখুন, দিক (আউটবাউন্ড/ইনবাউন্ড), মূল কাজ, ব্যবসার নাম, ভাষা বেছে এজেন্ট তৈরি করুন। এক মিনিটের মধ্যে নির্দেশনা, শুরুর লাইন, ভ্যারিয়েবল, ফলাফল, হ্যান্ড-ওভার নিয়ম আর ৩টা টেস্ট কেসসহ এজেন্ট তৈরি হয়।
- বাটন: Talk in browser (মাইকে কথা বলে দেখুন), Test call (নিজের ফোনে কল)।
Build → Agents (এজেন্ট)
- সব এজেন্ট কার্ডে: দিক, স্কিল, লাইভ/ড্রাফট, ৭ দিনের কল, উত্তরের হার, আর একটা মাইক বাটন (সাথে সাথে কথা বলুন)।
- New agent: নাম, দিক, স্কিল; চাইলে স্কিলের একটা ভার্সন "পিন" করুন ঐচ্ছিক (না করলে সবসময় সর্বশেষ পাবলিশ ভার্সন)। Describe a new agent: লিখে এজেন্ট বানানো।
- এজেন্টে ক্লিক করলে এজেন্ট এডিটর খোলে। বাঁয়ে ফর্ম, ডানে টেস্ট। ফর্মের ট্যাব:
| ট্যাব | কী থাকে |
| Model | কলের AI (অ্যাকাউন্টের পছন্দ বা এই এজেন্টের জন্য আলাদা), ভাষা, প্রথম লাইন আর সেটা কীভাবে বলা হবে (আগে থেকে রেকর্ড করা — সাথে সাথে বাজে, বা AI বলবে), নির্দেশনা, ব্যবসার তথ্য, প্রতি কলে আসা ভ্যারিয়েবল (কোনটা লাগবেই)। |
| Voice | কণ্ঠ, কথা বোঝার ভাষা, যে শব্দ ঠিকভাবে বলতে/শুনতে হবে (ব্র্যান্ডের নাম), লম্বা কলের সীমা, চুপ থাকলে কত সেকেন্ড পরে আবার জিজ্ঞেস, কতবার; ফোনের বোতাম (১ চাপলে কনফার্ম ইত্যাদি); আউটবাউন্ডে আগে ভয়েসমেইল শোনা আর রেখে যাওয়ার মেসেজ। |
| Tools | কলের মাঝে আপনার ওয়েব ঠিকানা থেকে তথ্য আনা (যেমন অর্ডারের অবস্থা); খুঁজতে খুঁজতে কী বলবে, ব্যর্থ হলে কী বলবে। |
| Knowledge | এই এজেন্ট কোন Files ব্যবহার করবে (টিক দিন), স্কিলের নিজের ডকুমেন্ট, Move to Files (স্কিলের ডকুমেন্ট সব এজেন্টের জন্য ফাইলে নেওয়া), ছোট তথ্য। |
| Hand-over | কখন মানুষের কাছে দেবে (লাইন প্রতি একটা), কোন ডেস্ক, কেউ না থাকলে কী বলবে; Transfer to a phone — কাকে (নাম, নম্বর), কখন। |
| Analysis | কল শেষে এজেন্ট কী ফলাফল ভরবে (ঘর: হ্যাঁ/না, তালিকা থেকে একটা, লেখা…) — কল লগে আর ওয়েবহুকে যায়। |
| Advanced | পুরো স্কিল JSON-এ। এখানে বদলালে অন্য ট্যাবেও দেখায়। |
- খরচের দাগ: মিনিটপ্রতি আনুমানিক খরচ চার ভাগে — ফোন লাইন, AI কথা, কণ্ঠ, Meghly।
- গতির দাগ: শোনা / ভাবা / বলা — গত ৭ দিনের আসল কল থেকে মাঝামাঝি সময় (২০টা কথার কম হলে "যথেষ্ট কল নেই")। ফাইল খোঁজা আর টুলের সময়ও দেখায়।
- ডান পাশে Chat (লিখে কথা) আর Talk (ব্রাউজারে আসল কল — রেকর্ড ও বিল হয়), কথা আর টুল লাইভ দেখায়। চ্যাট শেষ সেভ করা ভার্সনে চলে।
- Versions: খসড়া হিসেবে সেভ, কী বদলাল তার তালিকা, Publish, পুরনোটা Restore। চলমান কল যে ভার্সনে শুরু হয়েছে সেটাতেই শেষ হয়।
- কলে কোন নম্বর দেখাবে (আউটবাউন্ড এজেন্টে) ঐচ্ছিক: আপনার নিজের নম্বরগুলোর একটা — বিস্তারিত কলে কোন নম্বর দেখায়।
- Archive: এজেন্ট বন্ধ; পুরনো কল থেকে যায়।
ইনবাউন্ড এজেন্ট শুধু নম্বরের সাথে যুক্ত হলে কাজ করে (Phone numbers)। কল লিংক, ক্যাম্পেইন আর API — তিনটাতেই আউটবাউন্ড এজেন্ট লাগে। দুই রকম কলের পুরো বিবরণ ইনবাউন্ড ও আউটবাউন্ড অধ্যায়ে।
Build → Skills (স্কিল)
- New skill: খালি থেকে বা টেমপ্লেট থেকে (অর্ডার কনফার্মেশন, অ্যাপয়েন্টমেন্ট রিমাইন্ডার ইত্যাদি)। একই স্কিল অনেক এজেন্ট ব্যবহার করতে পারে।
- স্কিলের পেজে: কথোপকথনের সারসংক্ষেপ ছবি (পরিচয়, শুরুর লাইন, কথা, টুল, হ্যান্ড-ওভার, শেষ), Definition (JSON)।
- Save as vN: নতুন ভার্সন — চালু কলে প্রভাব নেই। Publish: এখন থেকে কলে এই ভার্সন। Restore: পুরনো ভার্সন আবার আনা।
- Golden set ঐচ্ছিক, পরামর্শ: জানা কথোপকথন যা এজেন্টকে ঠিক বলতেই হবে — কলার কী বলবে, কোন ফলাফল চাই, কী বলতেই হবে / কখনো বলবে না, আর ফ্লো থাকলে কোন পথে যাবে (যেমন
greet, ask, done)। পাবলিশের সময় চলে; একটা ফেল করলে পাবলিশ থামে।
- Test chat: টেক্সটে কথা বলে দেখা; ফ্লো থাকলে নিচে ফ্লোর পথ দেখায় (কোন ধাপ থেকে কোন ধাপে গেল)।
- স্কিলে যা থাকে: নির্দেশনা, শুরুর লাইন, ভাষা, ভ্যারিয়েবল, ফলাফলের ধরন, টুল, নলেজ, হ্যান্ড-ওভারের নিয়ম, আর ঐচ্ছিক ফ্লো। সাধারণ কাজ এজেন্ট এডিটরেই সহজে হয়; স্কিলের পেজ ভার্সন আর গোল্ডেন টেস্টের জন্য।
Build → Files (ফাইল) ঐচ্ছিক
- একবার আপলোড, যত এজেন্টে চান ব্যবহার: দামের তালিকা, FAQ, নিয়ম, আপনার ওয়েবসাইট।
- যোগ করার উপায়: Upload a file (PDF, Word, লেখা বা CSV), Write text (সরাসরি লেখা), Add a web page (পাবলিক পেজ — প্রতিদিন আবার পড়া হয়; না পারলে আগের কপি থাকে)।
- যোগ করার সময়ই পটভূমিতে পড়া হয়, পাশে পড়া হচ্ছে … %, তারপর Ready। তাই কলের সময় খোঁজা দ্রুত (কয়েক মিলিসেকেন্ড)।
- সীমা: একটা ফাইল ২০ MB, পুরো অ্যাকাউন্টে ৫০০ MB (স্কিলের ডকুমেন্টসহ)। উপরে কত জায়গা ব্যবহার হলো দেখায়।
- কোন এজেন্ট কোন ফাইল ব্যবহার করবে: এজেন্ট এডিটরের Knowledge ট্যাবে টিক দিন। সাথে সাথে কার্যকর — নতুন ভার্সন লাগে না; চলমান কল আগের মতোই শেষ হয়।
- মুছলে সব এজেন্ট থেকে সরে যায়। অন্য অ্যাকাউন্ট কখনো আপনার ফাইল দেখতে পায় না।
Build → Flows (ফ্লো) ঐচ্ছিক
- কলটা ধাপে ধাপে আঁকুন: প্রতিটা ধাপ একটা বাক্স, লাইনে জোড়া। ফ্লো ছাড়াও এজেন্ট চলে — তখন নির্দেশনাই কল চালায়।
- প্রথমে স্কিল বাছুন (পাশে কোন এজেন্ট ব্যবহার করে দেখায়)। স্কিলের সর্বশেষ ভার্সন খোলে; ফ্লো না থাকলে ৩টা ধাপের শুরু দেওয়া থাকে।
- ধাপের ধরন: বলুন (এজেন্ট কিছু বলে), জিজ্ঞেস (প্রশ্ন করে উত্তর শোনে), টুল চালান (আপনার টুল বা ফলাফল জমা), মানুষের কাছে দিন, কল শেষ।
- লাইনের শর্ত (একটা লাইনে একটা): কলার যখন… (সাধারণ কথায়, যেমন "কলার হ্যাঁ বলে"), ফলাফলে যখন… (যেমন
status = confirmed), টুল যখন… (কাজ হয়েছে / ব্যর্থ), বা নইলে / সবসময় (একটা ধাপে এমন লাইন একটাই)।
- হাতে: বাক্স টেনে সরান; বাক্সের ডান পাশের ফোঁটা টেনে আরেক বাক্সে ছাড়ুন = লাইন; ফাঁকা জায়গা টেনে পুরো ছবি সরান; মাউসের চাকা বা − / + দিয়ে ছোট-বড়; পুরোটা দেখান; ফেরান (Ctrl+Z)।
- কিবোর্ডে: Tab দিয়ে বাক্সে যান, তীর-চাবি দিয়ে সরান (Shift দিলে বেশি), Delete দিয়ে মুছুন, Enter দিলে ডান পাশের ঘরে যায়। লাইন ডান পাশ থেকেও যোগ করা যায় (লাইন যোগ)।
- ডান পাশে বাছা ধাপের নাম (ছোট হাতের ইংরেজি অক্ষর, সংখ্যা, _), ধরন, শিরোনাম (শুধু আপনার জন্য), কী বলবে/জিজ্ঞেস করবে (
{customer_name} এর মতো ভ্যারিয়েবল চলে), টুল, লাইনগুলো, কল এখান থেকে শুরু, ধাপ মুছুন।
- খসড়া হিসেবে রাখুন: নতুন ভার্সন হয়। ভুল থাকলে সেভ হয় না, কারণ লেখা আসে — যেমন কোনো ধাপে শুরু থেকে যাওয়া যায় না, ফ্লোর শেষ নেই, কোনো ধাপ থেকে বের হওয়ার লাইন নেই, বা এমন চক্র যেখান থেকে কখনো শেষে যাওয়া যায় না। আসল কলে চালাতে স্কিলের পেজ থেকে Publish করুন।
- কলে ফ্লো গতি কমায় না: পুরো ফ্লো শুরুতেই এজেন্টের কাছে থাকে, পরের ধাপে যাওয়া সাথে সাথে হয় (AI-কে আবার ডাকতে হয় না)। প্রতিটা ধাপ বদল কলের টাইমলাইনে দেখা যায়। আউটবাউন্ড আর ইনবাউন্ড দুটোতেই চলে।
Build → Phone numbers (ফোন নম্বর) — কল ধরা আর কলে নিজের নম্বর দেখানো
- Connect a number: আপনার নিজের নম্বর (আপনার ক্যারিয়ার থেকে Meghly-তে ফরোয়ার্ড করা)। প্রথম কল আসলে নিজে থেকে চালু হয়।
- Rent a number: Parley-র পুল থেকে মাসিক ভাড়ায় (থাকলে)।
- প্রতিটা নম্বরে: কোন এজেন্ট ধরবে, অফিস টাইম, দিন, আর সময়ের বাইরে কী হবে — মেসেজ, ভয়েসমেইল, অন্য (রাতের) এজেন্ট, ডেস্কে রিং, বা মোবাইলে বাজানো।
- আগে মোবাইলে বাজবে ঐচ্ছিক, আর যেসব এজেন্টের কলে এই নম্বর দেখায় — বিস্তারিত ইনবাউন্ড অংশে।
Run → Calls (কল লগ)
- উপরে পাঁচটা সংখ্যার ঘর: সব কল, কাজ সফল, মানুষের কাছে, উত্তর নেই, ব্যর্থ — বেছে নেওয়া ফিল্টার অনুযায়ী। ঘরে ক্লিক করলে তালিকা সেই কলগুলোতে নামে।
- ফিল্টার এক সারিতে: তারিখ (আজ, ৭ দিন, ৩০ দিন, সব সময়, বা নিজে তারিখ বাছুন), এজেন্ট, দিক, কীভাবে শেষ হলো, ফলাফল (গৃহীত / বাতিল / নেই), খরচ (কম-বেশি)। চালু ফিল্টারগুলো নিচে চিপ হিসেবে দেখায়; ✕ দিয়ে একটা, বা Clear all দিয়ে সব সরান।
- খোঁজা: নম্বর, কলের ডেটায় থাকা নাম, সারাংশ, বা কথার যেকোনো শব্দ দিয়ে।
- তালিকা পাতায় পাতায় আসে — নিচে Show more। লাখ লাখ কল থাকলেও দ্রুত।
- Download CSV: এখন যে ফিল্টার চালু, সেই কলগুলো। নম্বর সবসময় আংশিক লুকানো (
01711-•••777)।
- প্যানেলে কেউই পুরো নম্বর দেখেন না — অ্যাকাউন্টের অ্যাডমিনও না। পুরো নম্বর শুধু আপনার নিজের সার্ভার API key দিয়ে পায়।
- একটা কলে: রেকর্ডিং, ট্রান্সক্রিপ্ট (Translate দিয়ে নিজের ভাষায়), AI সারাংশ (৩০ সেকেন্ডের মধ্যে), ফলাফল, টাইমলাইন (ফ্লোর ধাপ বদলসহ), ভ্যারিয়েবল, বিল। লাইনে অপেক্ষারত কল Cancel করা যায়।
- রেকর্ডিং প্ল্যানের দিন পর্যন্ত থাকে, তারপর নিজে মুছে যায়। আপনি নিজে কল মুছতে পারেন না; দরকার হলে Meghly-কে বলুন — শুধু Meghly-র সুপার অ্যাডমিন একটা কলের রেকর্ডিং, কথা আর সারাংশ মুছতে পারেন, আর আপনার অডিট লগে লেখা থাকে কে, কবে।
Run → Campaigns (ক্যাম্পেইন) ঐচ্ছিক
- New campaign: নাম, আউটবাউন্ড এজেন্ট, কল করার সময়, দিন, একসাথে কয়টা লাইন, কতবার আবার চেষ্টা।
- Add contacts: CSV (UTF-8) — একটা
phone কলাম আর স্কিলের ভ্যারিয়েবলের কলাম। ভুল নম্বর, ডুপ্লিকেট আর do-not-call বাদ পড়ে, সংখ্যা দেখায়।
- Preview: একজন কন্টাক্টের জন্য এজেন্ট কী জানবে দেখুন।
- Start (KYC যাচাই লাগবে) → কয়েক সেকেন্ডে কল শুরু। Pause / Resume / Cancel।
- ফলাফল: কনফার্ম, বাতিল, কলব্যাক, আবার চেষ্টার অপেক্ষা — প্রতি ৫ সেকেন্ডে আপডেট। Results CSV ডাউনলোড।
Do-not-call তালিকা (এই পেজেই): এই নম্বরগুলোতে কোনো ক্যাম্পেইন, লিংক বা API কখনো কল করবে না। কেউ কলে "আর কল করবেন না" বললে নিজে থেকে যোগ হয়।
Run → Live desk (লাইভ ডেস্ক) ঐচ্ছিক
- New desk: একটা দল (যেমন সাপোর্ট), কত সেকেন্ড রিং করবে।
- Add member: প্রতিজনের একটা "সিট" (সফটফোনের ইউজার ও পাসওয়ার্ড — পাসওয়ার্ড একবারই দেখায়)। সদস্যরা Chrome-এ Open softphone খুলে কল ধরেন।
- AI হ্যান্ড-ওভার করলে এখানে দেখায়: কেন, এজেন্ট কী জানে। কেউ না ধরলে কল AI-তে ফেরে বা কলব্যাক হিসেবে জমা হয়।
- Callbacks: যারা পরে কল চেয়েছেন — নম্বর, কারণ, AI-এর নোট; কল করে Done।
Run → Call links (কল লিংক) ঐচ্ছিক
আপনার দোকান/CRM/POS ডেটা পাঠালে কল, কল শেষে ফলাফল ফেরত। বিস্তারিত নিচে কল লিংক অধ্যায়ে।
Observe → Analytics (অ্যানালিটিক্স)
কাজ সফলের হার, উত্তরের হার, গড় কথা, সফল প্রতি খরচ, দিনে দিনে গ্রাফ, স্কিলের ভার্সন অনুযায়ী ফলাফল, AI খরচের ভাগ। (মানের স্কোর আর কাস্টমারের মুড শীঘ্রই।)
Connect → Integrations (ইন্টিগ্রেশন)
কী কী সংযোগ আছে তার তালিকা: ওয়েবহুক (চালু), আপনার API টুল হিসেবে (চালু), n8n/Zapier/Make/Google Sheets (ওয়েবহুক দিয়ে), কুরিয়ার (টুল হিসেবে); Shopify, WooCommerce, HubSpot, Calendar, WhatsApp ইত্যাদির এক-ক্লিক সংযোগ শীঘ্রই — এখন কল লিংক দিয়েই এগুলো চলে।
Connect → Providers (প্রোভাইডার) ঐচ্ছিক
- Phone carriers: Connect a SIP trunk — আপনার IPTSP/SIP প্রোভাইডার বা PBX (সার্ভার, পোর্ট, ইউজার, পাসওয়ার্ড, ট্রান্সপোর্ট, নম্বর কীভাবে ডায়াল হয়)। তখন কল আপনার নম্বর থেকে যায় আর লাইনের বিল ক্যারিয়ার আপনাকে দেয়।
- AI choices: প্রতিটা কাজে কোন AI (ফোনে কথা, সারাংশ, এজেন্ট লেখা, ডকুমেন্ট পড়া, খোঁজা, ট্রান্সক্রিপ্ট, রেকর্ড করা লাইন)। Meghly কোনটা লক করলে বদলানো যায় না। একটা এজেন্টের জন্য আলাদা AI এজেন্ট এডিটরের Model ট্যাবে।
- AI services: নিজের API key দিলে সেই প্রোভাইডার সরাসরি আপনাকে বিল করে; না দিলে Parley-র key। Test key দিয়ে যাচাই। Key এনক্রিপ্ট হয়ে থাকে, আর কখনো দেখানো হয় না।
Connect → Developers (ডেভেলপার) ঐচ্ছিক
- API keys: আপনার সার্ভারের জন্য চাবি; কী পারবে (কল করা, কল পড়া, এজেন্ট/স্কিল চালানো, বাকি পড়া), চাইলে শুধু নির্দিষ্ট IP থেকে। একবারই দেখায়। Revoke করলে সাথে সাথে বন্ধ।
- Webhooks: কলের ঘটনা আপনার URL-এ (সাইন করা)। Send test, Deliveries (কী গেল, কী উত্তর এল, Retry)।
- Start a call: Node/Python/cURL উদাহরণ।
- Secrets: টুল আর কল লিংক যে পাসওয়ার্ড/টোকেন ব্যবহার করে (যেমন
SHOP_TOKEN) — এনক্রিপ্ট করা, আর দেখানো হয় না।
- শুধু অ্যাকাউন্টের অ্যাডমিন এগুলো দেখেন।
Account → Billing (বিলিং)
- প্ল্যানের মিনিট (কত গেল, কত আছে), ওয়ালেট, মিনিটপ্রতি দাম, এজেন্ট অনুযায়ী খরচ, শেষ ৫০টা বিল করা কল।
- টপ-আপের রিকোয়েস্ট (টাকা যোগ করুন কার্ডে): bKash, Nagad, Rocket, ব্যাংক বা নগদে Meghly-কে টাকা দিন → মুদ্রা (টাকা বা ডলার), পরিমাণ, কীভাবে দিয়েছেন, ট্রানজেকশন আইডি লিখে রিকোয়েস্ট পাঠান। Meghly মিলিয়ে দেখে ওয়ালেটে যোগ করে — সাথে সাথে কল চালু। নিচে টপ-আপ রিকোয়েস্ট তালিকায় অবস্থা: Meghly-র অপেক্ষায় / যোগ হয়েছে / বাতিল (কারণসহ)। অপেক্ষার রিকোয়েস্ট নিজে বাতিল করা যায়; একসাথে সর্বোচ্চ ৩টা অপেক্ষায় থাকতে পারে। শুধু অ্যাকাউন্টের অ্যাডমিন পাঠাতে পারেন।
- মিনিটপ্রতি দাম: ওয়ালেট থেকে এক মিনিটের দাম Meghly ঠিক করে — টাকায় (যেমন ৳৭) বা ডলারে (যেমন $0.29), আপনার ওয়ালেটের মুদ্রা অনুযায়ী। দাম বদলালে পরের কল থেকে কার্যকর, আর এই পেজে সাথে সাথে দেখায় (ওয়ালেটে কত মিনিট হবে সহ)। আপনার প্ল্যানে আলাদা দাম থাকলে সেটাই চলে। প্ল্যানের মিনিট আগে খরচ হয়, তারপর ওয়ালেট।
- ওয়ালেটের মুদ্রা: প্রথম যে মুদ্রায় টাকা আসে (টাকা বা ডলার), ওয়ালেট সেটাতেই থাকে।
- অনলাইন পেমেন্ট (চালু থাকলে): bKash / SSLCommerz / কার্ড দিয়ে সরাসরি; ইনভয়েস পাওয়া যায়।
- Auto-recharge ঐচ্ছিক: ওয়ালেট একটা অঙ্কের নিচে নামলে সেভ করা কার্ড থেকে নিজে টপ-আপ।
- AI প্রোভাইডার আর AI কাজের খরচের হিসাব (৩০ দিন)। নিজের SIP ক্যারিয়ারের চার্জ এখানে আসে না।
Account → Settings (সেটিংস)
- Account: কে লগইন, অবস্থা, অ্যাকাউন্ট আইডি।
- Calling rules: KYC অবস্থা, আউটবাউন্ড চালু/ফ্রিজ (কারণসহ), কল করার সময় (এর বাইরে কখনো না), একটা নম্বরে দিনে কতবার।
- Plan limits: মাসিক মিনিট, একসাথে কয়টা লাইন, কয়টা এজেন্ট ও স্কিল।
- Language and support: অ্যাকাউন্টের ভাষা (শুধু মালিক বদলাতে পারেন — ড্যাশবোর্ড, সারাংশ, ইমেইল, সাপোর্ট সেই ভাষায়), সারাংশের ভাষা, নিজের স্ক্রিনের ভাষা, আপনার সাপোর্ট টিম।
- সাইন আউট। নিচে বাঁয়ে থিম (ডার্ক/লাইট) আর বাংলা/ইংরেজি বোতাম।
ডেভেলপারদের জন্য সংক্ষেপে
- একটা কল:
POST /v1/calls — হেডার Authorization: Bearer <API key> (calls:write)।
{
"agentId": "01a1f038-…",
"to": "+8801711000000",
"variables": { "customer_name": "Rahim", "order_id": "A-1001" },
"idempotencyKey": "order-A-1001",
"scheduledAt": null
}
একই idempotencyKey আবার পাঠালে নতুন কল হয় না (আগেরটাই ফেরত)। ভুল হলে কারণসহ উত্তর: invalid_variables, no_balance, do_not_call, retry_limit, outbound_frozen ইত্যাদি।
ওয়েবহুকের ঘটনা: call.started, call.answered, call.handover, call.completed (ফলাফলসহ), call.summarized (সারাংশসহ), call.callback_requested, campaign.finished, usage.low। প্রতিটা Meghly-Signature দিয়ে সাইন করা (কল লিংক অধ্যায়ে যাচাইয়ের কোড)। কল লিংকের সব API API রেফারেন্সে।
নিরাপত্তা ও গোপনীয়তা
- এক অ্যাকাউন্ট আরেকটার কিছু দেখতে পায় না — ডাটাবেস নিজেই আলাদা রাখে।
- পাসওয়ার্ড, API key, সিক্রেট, ক্যারিয়ারের পাসওয়ার্ড এনক্রিপ্ট করা; সেভ করার পর আর দেখানো হয় না; লগে কখনো না।
- কাস্টমারের ফোন নম্বর লগে মাস্ক করা; রেকর্ডিং প্ল্যানের দিন পর মুছে যায়।
- কল করার সময়, do-not-call, দিনে ৩ বারের সীমা — সব কলে খাটে (লিংক, ক্যাম্পেইন, API)।
- Meghly-র অ্যাডমিন সাপোর্টের জন্য আপনার প্যানেলে ঢুকলে উপরে লাল দাগ দেখায়, আর প্রতিটা কাজ অডিট লগে তার নামে থাকে।
ইনবাউন্ড ও আউটবাউন্ড কল — পুরো বিবরণ
Parley-র এজেন্ট দুই রকম কাজ করে: আউটবাউন্ড — নিজে মানুষকে কল করে (অর্ডার কনফার্ম, রিমাইন্ডার, বকেয়া টাকা); ইনবাউন্ড — আপনার নম্বরে আসা কল ধরে (সাপোর্ট, বুকিং, তথ্য)। কথা বলা, টুল, ফাইল, ফ্লো, ফলাফল, রেকর্ডিং আর বিল দুটোতেই এক। আলাদা শুধু কল কীভাবে শুরু হয় আর কোন নিয়ম খাটে।
- এক নজরে তুলনা
- কলের ভেতরে কী হয় (দুটোতেই)
- আউটবাউন্ড: শুরুর আগে
- আউটবাউন্ড: কল শুরুর ৪ উপায়
- আউটবাউন্ড: কখন ডায়াল হয়
- আউটবাউন্ড: যে নিয়মে কল আটকায়
- কলে কোন নম্বর দেখায়
- ভয়েসমেইল ধরা
- ইনবাউন্ড: নম্বর আর রাউটিং
- ইনবাউন্ড: কল এলে কী হয়
- মানুষের কাছে দেওয়া
- কলের অবস্থা ও শেষের কারণ
- ফলাফল কোথায় যায়
- বিল
- API সংক্ষেপে
- সমস্যা হলে
১. এক নজরে তুলনা
| আউটবাউন্ড | ইনবাউন্ড |
| কে কল শুরু করে | Parley (আপনার নির্দেশে) | কলার (আপনার নম্বরে ফোন করে) |
| কী লাগবে | আউটবাউন্ড এজেন্ট + পাবলিশ করা স্কিল + মিনিট বা ওয়ালেট | ইনবাউন্ড এজেন্ট + একটা নম্বর (ভাড়া বা ফরোয়ার্ড) + মিনিট বা ওয়ালেট |
| কলের তথ্য (ভ্যারিয়েবল) | আপনি পাঠান (নাম, অর্ডার…); "লাগবেই" ঘর না থাকলে কল হয় না | কলার পাঠাতে পারে না; Parley নিজে কলারের নম্বর আর আগের তথ্য খুঁজে দেয় |
| সময়ের নিয়ম | শুধু কল করার সময়ে (ডিফল্ট ০৯:০০–২০:০০, কখনো ০৮:০০–২১:০০-এর বাইরে না) | নম্বরের অফিস টাইম আপনি ঠিক করেন (রাতও হতে পারে); বাইরে মেসেজ/ভয়েসমেইল/রাতের এজেন্ট/মোবাইল |
| Do-not-call, দিনে ৩ বার, KYC | খাটে (KYC শুধু ক্যাম্পেইনে) | খাটে না — কলার নিজে ফোন করেছে |
| সব লাইন ব্যস্ত হলে | কল লাইনে অপেক্ষা করে, লাইন খালি হলে ডায়াল | কলার হোল্ড মেসেজ শোনেন (৩০ সেকেন্ড পর্যন্ত), তারপর কলব্যাকের মেসেজ |
| ভয়েসমেইল | উত্তর দেওয়া মেশিন চিনে মেসেজ রেখে যেতে পারে | অফিসের বাইরে কলার ভয়েসমেইল রাখতে পারেন |
২. কলের ভেতরে কী হয় (দুটোতেই)
- শুরুর লাইন: আগে থেকে রেকর্ড করা হলে কল ধরার সাথে সাথে বাজে (কোনো দেরি নেই); "AI বলবে" বাছলে AI নিজে বলে। ইনবাউন্ডে আগে রেকর্ডিংয়ের ঘোষণা বাজতে পারে।
- কথা: এজেন্ট স্কিলের নির্দেশনা, ফাইল, আর ফ্লো থাকলে ফ্লো ধরে কথা বলে। কলার মাঝপথে কথা বললে এজেন্ট থেমে শোনে।
- ফোনের বোতাম ঐচ্ছিক: যেমন ১ = কনফার্ম, ২ = বাতিল — কথা না বলেও কাজ হয়।
- টুল ঐচ্ছিক: কলের মাঝে আপনার সিস্টেম থেকে তথ্য আনে (অর্ডারের অবস্থা, খালি সময়)। আনতে দেরি হলে "এক মুহূর্ত…" বলে।
- ফাইল থেকে উত্তর ঐচ্ছিক: দামের তালিকা, FAQ — খোঁজা কয়েক মিলিসেকেন্ডে।
- চুপ থাকলে: কয়েক সেকেন্ড পর আবার জিজ্ঞেস করে (কতবার, আপনি ঠিক করেন), তারপর ভদ্রভাবে রাখে। কল কত মিনিট পর্যন্ত চলবে তারও সীমা আছে।
- "আর কল করবেন না": কলার এটা বললে এজেন্ট দুঃখ প্রকাশ করে কল রাখে, নম্বর do-not-call তালিকায় যায়।
- মানুষের কাছে: কঠিন কল ডেস্কে বা ফোনে দেয় (১১ নম্বর)।
- ফলাফল: শেষে এজেন্ট ফলাফল জমা দেয় (যেমন
status: confirmed); নিয়মে না মিললে সেটা "বাতিল" হিসেবে কারণসহ থাকে।
- পরে: রেকর্ডিং, ট্রান্সক্রিপ্ট, ৩০ সেকেন্ডের মধ্যে AI সারাংশ, বিল — সব Calls-এ।
একটা কল যে স্কিল ভার্সনে শুরু হয়, সেটাতেই শেষ হয় — মাঝে নতুন ভার্সন পাবলিশ করলেও। নতুন কল থেকে নতুন ভার্সন।
৩. আউটবাউন্ড: শুরুর আগে
| কী | লাগবে? | কোথায় |
| আউটবাউন্ড এজেন্ট | লাগবেই | Agents → New agent (দিক: Outbound) |
| স্কিলের পাবলিশ করা ভার্সন | লাগবেই | এজেন্ট এডিটর → Versions → Publish |
| প্ল্যান মিনিট বা ওয়ালেটে টাকা | লাগবেই | Billing |
| KYC যাচাই | শুধু ক্যাম্পেইনে লাগবেই | Meghly করে; Settings → Calling rules-এ দেখায় |
| নিজের নম্বর থেকে কল (SIP trunk বা ভাড়া নম্বর) | ঐচ্ছিক | Providers, Phone numbers |
| ভয়েসমেইল চেনা | ঐচ্ছিক | এজেন্ট এডিটর → Voice → Answering machines |
| ফলাফল আপনার সিস্টেমে | ঐচ্ছিক | Call links বা Developers → Webhooks |
৪. আউটবাউন্ড: কল শুরুর ৪ উপায়
| উপায় | কার জন্য | কীভাবে |
| Test call | নিজে পরীক্ষা | Overview বা Agents → Test call: এজেন্ট, নম্বর, ভ্যারিয়েবল দিন → কয়েক সেকেন্ডে কল। আসল কলের মতো রেকর্ড ও বিল হয়। |
| কল লিংক | দোকান, CRM, POS — কোড ছাড়া | আপনার সিস্টেম লিংকে ডেটা পাঠায় → কল। কল লিংক অধ্যায়। |
| ক্যাম্পেইন | একটা তালিকার সবাইকে | CSV আপলোড → সময়, লাইন, আবার চেষ্টা ঠিক করে Start। |
| API | ডেভেলপার | POST /v1/calls (১৫ নম্বর)। |
যেভাবেই শুরু হোক, একই key (যেমন অর্ডার নম্বর) দিয়ে দুইবার পাঠালে একটাই কল হয়। কল সাথে সাথে বা নির্দিষ্ট সময়ে (scheduledAt) হতে পারে।
৫. আউটবাউন্ড: কখন ডায়াল হয়
- কল প্রথমে লাইনে (Queued) যায়। Parley প্রতি ২ সেকেন্ডে দেখে কোনটা ডায়াল করা যায়।
- শুধু কল করার সময়ে, আপনার অ্যাকাউন্টের সময় অঞ্চলে: ডিফল্ট ০৯:০০–২০:০০; আপনি বদলাতে পারেন কিন্তু ০৮:০০–২১:০০-এর বাইরে কখনো না। রাতে আসা কল সকালে হয়।
- একসাথে কয়টা: আপনার প্ল্যানের লাইন পর্যন্ত। বেশি হলে বাকিরা অপেক্ষা করে, পুরনোটা আগে।
- ক্যাম্পেইনে: ক্যাম্পেইনের নিজের দিন, ঘণ্টা আর লাইন; একজনকে একসাথে দুইবার কখনো না; আবার চেষ্টার মাঝে অন্তত ২ ঘণ্টা; Pause করলে লাইনের কল অপেক্ষা করে।
- লাইনে থাকা কল Cancel করা যায় (Calls পেজ বা API)।
৬. আউটবাউন্ড: যে নিয়মে কল আটকায়
ডায়ালের ঠিক আগে প্রতিটা কল এই নিয়মগুলো পার হয়, উপর থেকে নিচে। আটকালে কলটা Rejected হয়, কারণ লেখা থাকে, আর ওয়েবহুক যায় — চুপচাপ বাদ পড়ে না।
| কারণ | মানে | কী করবেন |
tenant_suspended | অ্যাকাউন্ট স্থগিত | Meghly-র সাথে যোগাযোগ |
outbound_frozen | Meghly আউটবাউন্ড বন্ধ রেখেছে (কারণ Settings-এ লেখা) | কারণ ঠিক করে Meghly-কে জানান |
kyc_required | ক্যাম্পেইনের কল, কিন্তু ব্যবসা যাচাই হয়নি | KYC করান (একটা একটা কল/API-তে লাগে না) |
do_not_call | নম্বর do-not-call তালিকায় | মানুষটা নিজে চাইলে তালিকা থেকে সরান |
retry_limit | এই নম্বরে গত ২৪ ঘণ্টায় ৩ বার ডায়াল হয়েছে | পরের দিন |
no_balance | মিনিটও নেই, ওয়ালেটও খালি | টপ-আপ |
retry_too_soon, outside_hours | আটকায় না, শুধু পিছায় — সময় হলে নিজে ডায়াল হয় | কিছু না |
৭. কলে কোন নম্বর দেখায়
মানুষের ফোনে কোন নম্বর দেখাবে, এই ক্রমে:
- এজেন্টে আপনি যে নম্বর বেছেছেন (এজেন্ট → Edit → কলে কোন নম্বর দেখাবে)।
- না বাছলে: আপনার ডিফল্ট SIP ক্যারিয়ারের নম্বর।
- সেটা না থাকলে: আপনার প্রথম ভাড়া নেওয়া নম্বর।
- কিছুই না থাকলে: Meghly-র কমন নম্বর।
- মানুষ ওই নম্বরে ফিরতি কল দিলে নম্বরের ইনবাউন্ড এজেন্ট ধরে, আর জানে আগে এই মানুষকে কল করা হয়েছিল।
- ফরোয়ার্ড করা নম্বর শুধু কল আনে — সেটা দেখিয়ে কল করা যায় না। অন্য অ্যাকাউন্টের নম্বর কখনো দেখায় না।
৮. ভয়েসমেইল ধরা (আউটবাউন্ড) ঐচ্ছিক
- চালু করলে কল ধরার পর এজেন্ট আগে একটু শোনে: ছোট্ট "হ্যালো?" তারপর চুপ = মানুষ; লম্বা টানা কথা = মেশিন। ৪ সেকেন্ডে না বোঝা গেলে মানুষ ধরে নেয় — আসল কাস্টমার কখনো রেকর্ডিং শোনেন না।
- মানুষ হলে এজেন্ট সাথে সাথে শুরু করে (তার "হ্যালো"-ও শোনে)। মেশিন হলে কল Voicemail হয়; মেসেজ দেওয়া থাকলে বিপ শেষে একবার বাজিয়ে রাখে (নাম/অর্ডারের মতো ভ্যারিয়েবল বসে), না থাকলে রেখে দেয়।
- বন্ধ রাখলে কিছু বদলায় না — শুরুর লাইন সাথে সাথে বাজে।
৯. ইনবাউন্ড: নম্বর আর রাউটিং
নম্বর পাওয়ার দুই উপায়
| ভাড়া নম্বর | নিজের নম্বর (ফরোয়ার্ড) |
| কীভাবে | Phone numbers → Rent a number → পুল থেকে বাছুন | আপনার ক্যারিয়ারে নম্বরটা Meghly-র নম্বরে ফরোয়ার্ড করুন → Connect a number |
| চালু হয় | সাথে সাথে | প্রথম কল আসলে (তার আগে "অপেক্ষায়") |
| খরচ | মাসিক ভাড়া + কলের মিনিট | কলের মিনিট (ফরোয়ার্ডের চার্জ আপনার ক্যারিয়ারের) |
| কলে দেখানো যায়? | হ্যাঁ | না, শুধু কল আনে |
| ছেড়ে দিলে | পুলে ফেরে | মুছে যায় |
কয়টা নম্বর রাখতে পারবেন তা প্ল্যানে লেখা। পুরনো কল নম্বর ছাড়ার পরেও থাকে।
প্রতিটা নম্বরের রাউটিং
| ঘর | মানে |
| এজেন্ট | কোন ইনবাউন্ড এজেন্ট ধরবে। না থাকলে নম্বরের ডেস্ক, সেটাও না থাকলে "এখন পাওয়া যাচ্ছে না" মেসেজ। |
| অফিস টাইম ও দিন | যেমন 09:00-18:00, শনি–বৃহস্পতি। রাত পার হতে পারে (20:00-08:00)। খালি রাখলে সবসময় খোলা। |
| সময়ের বাইরে | মেসেজ (ডিফল্ট: "আমরা এখন বন্ধ"), ভয়েসমেইল, অন্য এজেন্ট (রাতের এজেন্ট), ডেস্ক, বা মোবাইলে বাজানো। |
| আগে মোবাইলে বাজবে ঐচ্ছিক | কল এলে আগে আপনার মোবাইলে বাজে, ১০–৬০ সেকেন্ড (ডিফল্ট ২৫) — অফিস সময়ে, পরে, বা দুই সময়েই। শুধু নিজের দেশের নম্বর, নিজের Meghly নম্বর না। |
যেকোনো অবস্থায় কল কোথাও না কোথাও যায় — কলার কখনো চুপচাপ লাইনে পড়ে থাকেন না।
১০. ইনবাউন্ড: কল এলে কী হয়
- নম্বর চেনা: কোন অ্যাকাউন্টের কোন নম্বর, ক্যারিয়ার যে রূপেই পাঠাক (
+880…, 0…)।
- রাউটিং: অফিস টাইম আর উপরের ঘর দেখে ঠিক হয় — এজেন্ট, মোবাইল, ডেস্ক, ভয়েসমেইল না মেসেজ।
- টাকা আছে? মিনিট বা ওয়ালেট না থাকলে কলার একটা মেসেজ শোনেন, কল Rejected।
- কলারকে চেনা: এজেন্ট পায়
caller_number, caller_known (হ্যাঁ/না), caller_previous_calls, আর এই নম্বর আগে কোনো ক্যাম্পেইনে থাকলে তার তথ্য (যেমন customer_name, order_id) — তাই পরিচিত কাস্টমারকে নাম ধরে ডাকতে পারে।
- লাইন খালি? সব লাইন ব্যস্ত হলে কলার হোল্ড মেসেজ শোনেন (প্রতি ১৫ সেকেন্ডে), ৩০ সেকেন্ড পর্যন্ত। লাইন খালি হলে এজেন্ট ধরে; না হলে "পরে কল করব" মেসেজ, কলব্যাক তালিকায় যোগ আর
call.callback_requested ওয়েবহুক। অপেক্ষার সময়ের বিল হয় না।
- এজেন্ট ধরে: রেকর্ডিংয়ের ঘোষণা (চালু থাকলে) → শুরুর লাইন → কথা। বাকি সব আউটবাউন্ডের মতো।
- ভয়েসমেইল: মেসেজ → বিপ → ২ মিনিট পর্যন্ত রেকর্ড (৬ সেকেন্ড চুপ থাকলে শেষ) → কল লগে "Voicemail", ফলাফলে রেকর্ডিং।
- মোবাইলে বাজানো: কলার রিং শোনেন (বিল নেই)। মোবাইল ধরলে দুজন কথা বলেন, রেকর্ড আর বিল হয়; না ধরলে অফিস সময়ে এজেন্ট/ডেস্ক, পরে ভয়েসমেইল। মোবাইলে কলটা আপনার এই নম্বর দেখিয়ে আসে।
ইনবাউন্ড স্কিলে "লাগবেই" ভ্যারিয়েবল চাওয়া হয় না — কলার তো পাঠাতে পারে না।
১১. মানুষের কাছে দেওয়া
| লাইভ ডেস্ক | ফোনে ট্রান্সফার |
| কোথায় যায় | আপনার দলের ব্রাউজার সফটফোনে | যেকোনো ফোন নম্বরে (ম্যানেজারের মোবাইল, অফিস লাইন) |
| সেট কোথায় | Live desk + এজেন্ট এডিটর → Hand-over | এজেন্ট এডিটর → Hand-over → Transfer to a phone (সর্বোচ্চ ১০ জন) |
| কখন | আপনার লেখা অবস্থায়, আর সবসময়: কলার মানুষ চাইলে, রেগে গেলে, এজেন্ট না জানলে | লেখা অবস্থায়, বা কলার ওই মানুষটাকে চাইলে |
| বাজার সময় | খালি সদস্যদের একে একে (যে সবচেয়ে বেশি সময় ফাঁকা, আগে) | এজেন্ট কলারের সাথে থাকে যতক্ষণ না ধরে |
| কেউ না ধরলে | কল AI-তে ফেরে বা কলব্যাক তালিকায় যায় | এজেন্ট কলারকে বলে আর কথা চালিয়ে যায় |
| যিনি ধরেন তিনি দেখেন | কেন দেওয়া হলো, এজেন্ট কী জানে | — (নম্বর কখনো AI বা ট্রান্সক্রিপ্টে যায় না) |
দুটোতেই কল একটাই থাকে, পুরোটা রেকর্ড আর বিল হয়; ওয়েবহুক call.handover।
১২. কলের অবস্থা ও শেষের কারণ
Queued→Dialing→Ringing→Answered→InConversation→Completed
অন্যভাবে শেষ: NoAnswer (ধরেনি), Busy, Voicemail, Rejected (নিয়মে আটকেছে), Failed, Cancelled। মানুষের কাছে গেলে মাঝে HandingOver → WithHuman। ইনবাউন্ড শুরু হয় Ringing থেকে।
| শেষের কারণ | মানে |
agent_ended | এজেন্ট কাজ শেষ করে রেখেছে |
caller_hung_up | কলার রেখে দিয়েছেন |
silence | অনেকক্ষণ চুপ |
time_limit | সর্বোচ্চ মিনিট পার |
voicemail / voicemail_left | মেশিন ধরেছে / কলার ভয়েসমেইল রেখেছেন |
handed_over, transferred | ডেস্কে / ফোনে দেওয়া হয়েছে |
opt_out | কলার আর কল চান না |
lines_busy | ইনবাউন্ড: সব লাইন ব্যস্ত ছিল, কলব্যাক চাওয়া হয়েছে |
caller_abandoned | রিং হওয়ার সময়ই কলার রেখে দিয়েছেন (বিল নেই) |
agent_unavailable, not_dialled | এজেন্ট/স্কিল চালানো যায়নি (আর্কাইভ, পাবলিশ নেই) |
১৩. ফলাফল কোথায় যায়
- Calls পেজে প্রতিটা কলে, আর কাজ সফল ঘরে গোনা হয়।
- ওয়েবহুক
call.completed (ফলাফলসহ) আর call.summarized (সারাংশসহ) — Developers → Webhooks।
- কল লিংক থেকে শুরু হলে ফলাফল সরাসরি আপনার দোকান/CRM-এ ফেরত (কল লিংক ৭ নম্বর)।
- ক্যাম্পেইনে Results CSV।
- Download CSV (Calls পেজ) — নম্বর আংশিক লুকানো।
১৪. বিল
- কল ধরা থেকে রাখা পর্যন্ত, ১০ সেকেন্ডের ধাপে। আগে প্ল্যানের মিনিট, তারপর ওয়ালেট।
- ফ্রি: না ধরা, ব্যস্ত, আটকানো, বাতিল কল; ইনবাউন্ডে হোল্ডে অপেক্ষা আর রিং হওয়ার সময়।
- ডেস্ক, মোবাইল আর ফোনে ট্রান্সফারের মিনিট একই কলে যোগ হয়। নিজের SIP ক্যারিয়ারের লাইন চার্জ ক্যারিয়ার আপনাকে দেয়, এখানে আসে না।
- মিনিট আর টাকা দুটোই শেষ হলে নতুন কল হয় না, ট্রান্সফারও না। চলমান কল কাটে না।
১৫. API সংক্ষেপে
| কাজ | রিকোয়েস্ট |
| একটা আউটবাউন্ড কল | POST /v1/calls {agentId, to, variables, idempotencyKey, scheduledAt} |
| কল বাতিল (লাইনে থাকলে) | POST /v1/calls/{id}/cancel |
| একটা কল, ঘটনা আর ফলাফলসহ | GET /v1/calls/{id}; কথা: GET /v1/calls/{id}/transcript |
| কলের তালিকা, ফিল্টারসহ | GET /v1/calls?from&to&agent&direction&endReason&result&outcome&minCost&maxCost&q&cursor (পরের পাতা X-Next-Cursor হেডারে) |
| সংখ্যার ঘর / CSV | GET /v1/calls/summary, GET /v1/calls/export.csv (একই ফিল্টার) |
| নম্বর | GET /v1/numbers, GET /v1/numbers/available, POST /v1/numbers/{id}/rent, POST /v1/numbers/forwarded, PUT /v1/numbers/{id} (এজেন্ট), PUT /v1/numbers/{id}/routing, DELETE /v1/numbers/{id} |
| কলে কোন নম্বর দেখাবে | GET /v1/caller-numbers, PUT /v1/agents/{id}/caller-number {numberId} |
| নিয়মের অবস্থা | GET /v1/compliance |
বিস্তারিত উদাহরণ API রেফারেন্সে (English)।
১৬. সমস্যা হলে
| দেখছেন | কী করবেন |
| কল Queued-এ বসে আছে | কল করার সময়ের বাইরে, বা সব লাইন ব্যস্ত। সময় হলে নিজে যাবে। ক্যাম্পেইন Pause থাকলেও অপেক্ষা করে। |
invalid_variables | স্কিলের "লাগবেই" ভ্যারিয়েবল পাঠাননি। এজেন্ট এডিটর → Model-এ দেখুন কোনগুলো লাগে। |
Rejected — do_not_call / retry_limit | ৬ নম্বর দেখুন। |
| অনেক কল Voicemail | সময় বদলান (অফিস টাইমে মানুষ কম ধরে), বা ভয়েসমেইল মেসেজ রাখুন। |
| নিজের নম্বরে কল এসে "পাওয়া যাচ্ছে না" বলে | নম্বরে ইনবাউন্ড এজেন্ট বা ডেস্ক বাছেননি, বা এজেন্ট আর্কাইভ/স্কিল পাবলিশ নেই। |
| ফরোয়ার্ড করা নম্বর "অপেক্ষায়" | এখনো একটাও কল আসেনি। ক্যারিয়ারে ফরোয়ার্ড ঠিক আছে কিনা দেখে একটা কল করুন। |
| ইনবাউন্ডে কলার "পরে কল করব" শোনেন | সব লাইন ব্যস্ত ছিল। প্ল্যানে লাইন বাড়ান; কলব্যাক তালিকা Live desk-এ। |
| মোবাইলে বাজে না | নম্বরটা নিজের দেশের কিনা, আর "কখন" (অফিস সময়/পরে) ঠিক বাছা কিনা দেখুন। |
| এজেন্ট ধীরে উত্তর দেয় | এজেন্ট এডিটরের গতির দাগে দেখুন কোথায় সময় যাচ্ছে (শোনা, ভাবা, বলা, ফাইল, টুল)। |
কল লিংক — আপনার যেকোনো সিস্টেম থেকে অটো কল
অর্ডার এলে কাস্টমারকে কল করে কনফার্ম করা, নতুন লিড এলে কল, বকেয়া বিলের রিমাইন্ডার — এগুলো চালু করতে প্রোগ্রামার লাগবে না। Parley আপনাকে একটা লিংক দেয়। আপনার সিস্টেম (দোকান, CRM, POS, নিজের অ্যাপ) ওই লিংকে ডেটা পাঠালেই এজেন্ট কল করে, আর কল শেষে ফলাফল আপনার সিস্টেমে ফেরত পাঠাতে পারে।
আপনার সিস্টেম→কল লিংক→এজেন্ট কাস্টমারকে কল করে→ফলাফল→আপনার সিস্টেম
- শুরু করার আগে
- লিংক বানানো
- লিংকে ডেটা পাঠানো
- আমরা কী ডেটা নিই
- ঘর বেছে নেওয়া
- লিংক কী উত্তর দেয়
- ফলাফল ফেরত পাঠানো
- নিরাপত্তা
- সীমা ও নিয়ম
- সমস্যা হলে
- ডেভেলপারদের জন্য API
১. শুরু করার আগে
- একটা আউটবাউন্ড এজেন্ট লাগবে (Agents পেজ)। লিংক শুধু বাইরে কল করে।
- এজেন্টের স্কিলে যে ভ্যারিয়েবল আছে (যেমন
customer_name, order_id, amount) — কল করার সময় এজেন্ট এগুলো জানবে। লিংক আপনার ডেটা থেকে এগুলো ভরে দেবে।
- অ্যাকাউন্টে মিনিট বা ব্যালেন্স থাকতে হবে।
- কল হয় শুধু কল করার সময়ের মধ্যে (সাধারণত সকাল ৯টা থেকে রাত ৮টা)। রাতে ডেটা এলে কল লাইনে থাকে, সকালে হয়।
২. লিংক বানানো
- প্যানেলে বাঁ দিকে Call links → New link।
- একটা নাম দিন (যেমন "দোকানের অর্ডার") আর কোন এজেন্ট কল করবে বেছে নিন।
- একটা লিংক পাবেন, এরকম দেখতে:
https://voice.meghly.com/in/cl_k3m9q2x7v4b8n5p6r2t8/q8v4m2k9x3p7n5b6t2r8w4z6y3c9d5f2
লিংকের দুই অংশ: cl_… হলো লিংকের নাম্বার, শেষের লম্বা অংশ হলো গোপন চাবি। পুরো লিংক যার কাছে আছে, সে আপনার এজেন্ট দিয়ে কল চালু করতে পারে — তাই এটা পাসওয়ার্ডের মতো রাখুন।
লিংক কারো হাতে চলে গেছে মনে হলে লিংকের পেজে New secret চাপুন। পুরনো লিংক সাথে সাথে বন্ধ হবে, নতুনটা আপনার সিস্টেমে বসিয়ে দিন।
৩. লিংকে ডেটা পাঠানো
আপনার সিস্টেম যেভাবে পারে সেভাবেই পাঠাবে — আমাদের কোনো নির্দিষ্ট ফরম্যাট মানতে হবে না।
WooCommerce (WordPress দোকান)
- WordPress অ্যাডমিন → WooCommerce → Settings → Advanced → Webhooks → Add webhook।
- Name: যেকোনো নাম। Status: Active। Topic: Order created।
- Delivery URL: আপনার কল লিংক।
- Secret: একটা লম্বা র্যান্ডম লেখা দিন (পরে নিরাপত্তায় লাগবে, ৮ নম্বর দেখুন)।
- API version: সবচেয়ে নতুনটা। Save webhook।
Save করার সময় WooCommerce একটা টেস্ট পাঠায় (webhook_id=…)। লিংক এটা চিনে নেয় আর ঠিক আছে বলে উত্তর দেয় — কোনো কল হয় না।
Shopify
- Shopify অ্যাডমিন → Settings → Notifications → Webhooks → Create webhook।
- Event: Order creation। Format: JSON। URL: আপনার কল লিংক।
- Save। পেজের নিচে Shopify একটা signing secret দেখায় — এটা নিরাপত্তার জন্য রেখে দিন।
CRM, POS বা অন্য সফটওয়্যার
সফটওয়্যারে "Webhook", "Notification URL", "Callback URL" বা "HTTP POST" নামে কোনো সেটিং থাকলে সেখানে লিংকটা বসিয়ে দিন। না থাকলে Zapier, Make বা n8n দিয়ে "Webhook / HTTP request" স্টেপে লিংকটা দিন।
নিজের কোড (যেকোনো ভাষা)
লিংকে একটা POST রিকোয়েস্ট, বডিতে JSON। কোনো API key বা বিশেষ হেডার লাগে না।
# cURL
curl -X POST "https://voice.meghly.com/in/cl_…/…" \
-H "Content-Type: application/json" \
-d '{"id":"A-1001","name":"রহিম","phone":"01711-000000","total":1450}'
// PHP / Laravel
Http::post(env('PARLEY_LINK'), [
'id' => $order->id, 'name' => $order->customer_name,
'phone' => $order->phone, 'total' => $order->total,
]);
// Node.js
await fetch(process.env.PARLEY_LINK, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ id: order.id, name: order.name, phone: order.phone, total: order.total }),
});
# Python
import os, requests
requests.post(os.environ["PARLEY_LINK"], json={"id": "A-1001", "name": "Rahim", "phone": "01711000000", "total": 1450}, timeout=10)
// C# / .NET
using var http = new HttpClient();
await http.PostAsJsonAsync(link, new { id = "A-1001", name = "Rahim", phone = "01711000000", total = 1450 });
// Google Sheet (Extensions → Apps Script): নতুন সারির ডেটা পাঠানো
function sendRow(row) {
UrlFetchApp.fetch(PropertiesService.getScriptProperties().getProperty('PARLEY_LINK'), {
method: 'post', contentType: 'application/json',
payload: JSON.stringify({ id: row[0], name: row[1], phone: row[2] })
});
}
লিংকটা কোডে সরাসরি না লিখে সেটিং বা environment variable-এ রাখুন (উপরের উদাহরণে PARLEY_LINK)।
পুরনো ধরনের ফর্মও চলে: Content-Type: application/x-www-form-urlencoded দিয়ে name=Rahim&phone=01711000000 পাঠালে লিংক এগুলোকে ঘর হিসেবে পড়ে।
৪. আমরা কী ডেটা নিই
আপনার সিস্টেম যে JSON দেয় সেটাই পাঠাবে — ঘরের নাম আপনার ইচ্ছামতো। আমাদের দরকার শুধু:
| কী | লাগবে? | কেন |
| ফোন নম্বর | হ্যাঁ | কাকে কল করবে। 01711000000, 01711-000000, +8801711000000, 8801711000000, বাংলা অঙ্ক ০১৭১১০০০০০০ — সব চলে। |
| একটা ইউনিক আইডি | খুব দরকারি | অর্ডার নম্বর, লিড আইডি, ইনভয়েস নম্বর। একই আইডিতে দুইবার কল হয় না — দোকান একই অর্ডার দুইবার পাঠালেও। |
| এজেন্টের ভ্যারিয়েবল | স্কিল যা চায় | নাম, টাকার পরিমাণ, পণ্যের নাম, ডেলিভারির ঠিকানা — এজেন্ট কলে এগুলো বলবে। |
| বাকি সব ঘর | না | থাকলে সমস্যা নেই; শর্তে ব্যবহার করতে পারেন (যেমন পেমেন্টের ধরন)। |
উদাহরণ ১ — একটা সাধারণ অর্ডার
{
"id": "A-1001",
"name": "রহিম উদ্দিন",
"phone": "01711-223344",
"total": 1450,
"payment": "cod",
"address": "মিরপুর ১০, ঢাকা"
}
উদাহরণ ২ — WooCommerce যেভাবে পাঠায় (ছোট করে)
{
"id": 727,
"status": "processing",
"total": "1450.00",
"payment_method": "cod",
"billing": { "first_name": "রহিম", "last_name": "উদ্দিন", "phone": "01711-223344" },
"line_items": [ { "name": "T-shirt", "quantity": 2 } ]
}
এখানে ফোন আছে billing-এর ভেতরে — তাই ঘরের নাম হবে billing.phone।
উদাহরণ ৩ — এক রিকোয়েস্টে অনেকগুলো (CRM-এর লিড তালিকা)
{
"leads": [
{ "lead_id": "L1", "name": "করিম", "mobile": "+8801811000001" },
{ "lead_id": "L2", "name": "রিনা", "mobile": "01911000002" }
]
}
এখানে "রেকর্ডের তালিকা" ঘরে leads লিখবেন — প্রতিটা লিডে আলাদা কল হবে (এক রিকোয়েস্টে সর্বোচ্চ ১০০টা)। বডি নিজেই তালিকা হলে ([ {...}, {...} ]) ঘরটা ফাঁকা রাখুন।
৫. ঘর বেছে নেওয়া
প্রথমে একটা টেস্ট অর্ডার দিন (বা টেস্ট ডেটা পাঠান)। লিংক শেষ রিকোয়েস্টটা রেখে দেয়, আর লিংকের পেজে সব ঘর দেখায়। তারপর:
- ফোন নম্বরের ঘর বেছে নিন। এটা না বাছা পর্যন্ত কোনো কল হয় না — আসা ডেটা শুধু নমুনা হিসেবে থাকে।
- ইউনিক আইডি বেছে নিন (অর্ডার নম্বর)।
- এজেন্টের প্রতিটা ভ্যারিয়েবল-এর পাশে কোন ঘর থেকে আসবে বেছে নিন।
- দরকার হলে শর্ত দিন (নিচের টেবিল)।
- দরকার হলে অপেক্ষা দিন — যেমন অর্ডারের ১০ মিনিট পরে কল।
- Check with the last request চাপুন — কোন নম্বরে কল যাবে, এজেন্ট কী জানবে, কোনো সমস্যা আছে কিনা দেখাবে। এতে কোনো কল হয় না।
- Save। এখন থেকে প্রতিটা নতুন ডেটায় কল হবে।
ঘরের নাম কীভাবে পড়বেন
| ঘরের নাম | উদাহরণ ২-এ যা পায় |
id | 727 |
billing.phone | 01711-223344 (billing-এর ভেতরের phone) |
billing.first_name | রহিম |
line_items.0.name | T-shirt (তালিকার প্রথমটা; গোনা শুরু ০ থেকে) |
শর্ত — কখন কল হবে
সব শর্ত মিললে তবেই কল। না মিললে রেকর্ডটা বাদ (skipped)। বড়-ছোট হাতের অক্ষর পার্থক্য করে না।
| শর্ত | উদাহরণ |
| সমান (Is) | payment_method সমান cod — শুধু ক্যাশ অন ডেলিভারি |
| সমান নয় (Is not) | status সমান নয় cancelled |
| এর মধ্যে আছে (Contains) | address-এ আছে ঢাকা |
| এগুলোর একটা (Is one of) | payment_method এগুলোর একটা cod,bkash |
| মান আছে / খালি | email খালি |
| এর বেশি / এর কম | total এর বেশি 1000 |
৬. লিংক কী উত্তর দেয়
প্রতিটা রিকোয়েস্টে লিংক জানায় প্রতিটা রেকর্ডের কী হলো:
{
"accepted": true,
"queued": 1,
"results": [
{ "index": 0, "outcome": "queued", "callId": "01a1f03c-5c48-7b14-9181-bceae273ee56", "detail": "key 727" }
]
}
| outcome | মানে |
queued | কল লাইনে উঠেছে |
duplicate | এই আইডিতে আগেই কল হয়েছে — আবার হবে না |
skipped | শর্ত মেলেনি |
invalid | ফোন নম্বর নেই বা ভুল |
refused | নিয়মে আটকেছে: ব্যালেন্স নেই, নম্বর do-not-call তালিকায়, দিনে ৩ বার চেষ্টা হয়ে গেছে, এজেন্টের দরকারি ভ্যারিয়েবল নেই — বা নিরাপত্তা যাচাই মেলেনি |
sample | এখনো ফোনের ঘর বাছা হয়নি; ডেটা নমুনা হিসেবে রাখা হলো |
ping | পাঠানোর সিস্টেমের টেস্ট (যেমন WooCommerce) |
paused | লিংক বন্ধ বা অ্যাকাউন্ট স্থগিত — কোনো কল হয়নি |
সব ঘটনা লিংকের পেজে Requests received-এ দেখা যায়। HTTP কোড: 200 নেওয়া হয়েছে · 400 বডি JSON বা ফর্ম না · 403 নিরাপত্তা যাচাই মেলেনি · 404 লিংক ভুল · 413 বডি বড় বা ১০০-র বেশি রেকর্ড · 429 খুব দ্রুত পাঠাচ্ছেন।
লিংক বন্ধ থাকলেও 200 দেয় (কল ছাড়া), যাতে WooCommerce বা Shopify নিজে থেকে ওয়েবহুক বন্ধ করে না দেয়।
৭. ফলাফল ফেরত পাঠানো (ঐচ্ছিক)
কল শেষ হলে Parley আপনার সিস্টেমে একটা রিকোয়েস্ট পাঠাতে পারে — যেমন অর্ডারে নোট, অর্ডারের স্ট্যাটাস বদল, CRM-এ কলের ফলাফল। কী পাঠাবে আপনি লিংকের পেজের ৩ নম্বর অংশে লিখে দেন:
| ঘর | কী লিখবেন |
| When | The call ends (কল শেষ হওয়ার সাথে সাথে) বা The AI summary is ready (কয়েক সেকেন্ড পরে, সারাংশসহ) |
| Method | আপনার সিস্টেমের API যা চায়: সাধারণত POST, কখনো PUT/PATCH |
| Address | আপনার API-র ঠিকানা, https:// দিয়ে শুরু |
| Headers | লগইনের চাবি ইত্যাদি, প্রতি লাইনে নাম: মান |
| Body | যা পাঠাবেন; ফাঁকা রাখলে আমাদের সাধারণ JSON যায় |
| Only for | শুধু কিছু ফলাফলে পাঠাতে চাইলে (যেমন শুধু Completed); কিছু না বাছলে সব কলে |
বসানোর জিনিস (placeholder)
ঠিকানা, হেডার আর বডিতে নিচের লেখাগুলো লিখলে পাঠানোর সময় আসল মান বসে যায়:
| লিখুন | যা বসবে | উদাহরণ |
{var.order_id} | কলের যেকোনো ভ্যারিয়েবল ({var.নাম}) | 727 |
{result.status} | এজেন্ট যে ফলাফল বের করেছে | confirmed |
{result.ঘর} | ফলাফলের যেকোনো ঘর | {result.delivery_time} |
{call.state} | কলের শেষ অবস্থা | Completed, NoAnswer, Busy, Voicemail, Failed, Rejected, Cancelled |
{call.summary} | AI সারাংশ (When = AI summary হলে) | কাস্টমার অর্ডার কনফার্ম করেছেন… |
{call.id} | Parley-তে কলের আইডি | 01a1f03c-… |
{call.to} | যে নম্বরে কল হয়েছে | 8801711223344 |
{call.durationSec} / {call.billableSec} | কথা বলার সময় / বিলের সেকেন্ড | 65 |
{call.endReason} | কেন শেষ হলো | agent_ended |
{call.answeredAt} / {call.endedAt} | সময় (ISO) | 2026-11-19T10:01:05Z |
{secret.NAME} | আপনার রাখা সিক্রেট — শুধু হেডারে | API চাবি |
JSON বডিতে মানগুলো নিজে থেকে নিরাপদভাবে বসে (উদ্ধৃতি চিহ্ন, নতুন লাইন ঠিক থাকে)। উদ্ধৃতি চিহ্ন আপনি লিখবেন: "note":"{call.summary}"। সংখ্যার জন্য উদ্ধৃতি ছাড়া: "seconds":{call.durationSec}।
উদাহরণ — WooCommerce অর্ডারে নোট
WooCommerce → Settings → Advanced → REST API থেকে একটা key বানান (Read/Write)। consumer_key:consumer_secret লেখাটা base64 করে Developers → Secrets-এ WOO_AUTH নামে রাখুন।
When: The AI summary is ready
Method: POST
Address: https://your-shop.com/wp-json/wc/v3/orders/{var.order_id}/notes
Headers: Authorization: Basic {secret.WOO_AUTH}
Body: {"note":"Parley call: {call.state}. Result: {result.status}. {call.summary}","customer_note":false}
উদাহরণ — Shopify অর্ডারে নোট
Method: PUT
Address: https://your-shop.myshopify.com/admin/api/2025-01/orders/{var.order_id}.json
Headers: X-Shopify-Access-Token: {secret.SHOPIFY_TOKEN}
Body: {"order":{"id":{var.order_id},"note":"Parley: {call.state} — {result.status}"}}
উদাহরণ — নিজের সার্ভার বা CRM
Method: POST
Address: https://crm.example.com/api/leads/{var.lead_id}/calls
Headers: X-Api-Key: {secret.CRM_KEY}
Body: {"result":"{result.status}","state":"{call.state}","seconds":{call.durationSec},"summary":"{call.summary}"}
Body ফাঁকা রাখলে এটা যায়:
{"callId":"…","status":"Completed","endReason":"agent_ended","to":"8801711223344","durationSec":65,"result":"confirmed","summary":"…"}
পাঠানোর নিয়ম
- একই কলে একবারই পাঠায়।
- আপনার সার্ভার
2xx দিলে "পৌঁছেছে"। না দিলে আবার চেষ্টা: ১ মিনিট, ৫ মিনিট, ৩০ মিনিট, ২ ঘণ্টা, ৬ ঘণ্টা পর; তারপর "failed"।
- লিংকের পেজে Results sent-এ সব দেখা যায় (সিক্রেট •••• দিয়ে লুকানো), Retry দিয়ে আবার পাঠানো যায়।
- Show the request চাপলে পাঠানোর আগেই দেখতে পাবেন কেমন যাবে (কিছু পাঠানো হয় না)।
- প্রতি রিকোয়েস্টে এই হেডারগুলো থাকে:
Meghly-Signature (নিচে দেখুন), Meghly-Event, Meghly-Delivery।
৮. নিরাপত্তা
আমরা যা করি
- লিংকের গোপন চাবি ১৬০-বিটের র্যান্ডম, ডাটাবেসে এনক্রিপ্ট করা। ভুল চাবি বা ভুল লিংকে একই উত্তর (
404) — কোনটা ভুল বোঝা যায় না। চাবি মেলানো হয় এমনভাবে যাতে সময় মেপেও আন্দাজ করা না যায়।
- এক অ্যাকাউন্ট অন্যটার কিছু দেখতে পায় না — ডাটাবেস নিজেই আলাদা রাখে (row-level security)। লিংক শুধু নিজের অ্যাকাউন্টের এজেন্ট দিয়ে কল করে।
- গতির সীমা: প্রতি লিংকে মিনিটে ১২০, প্রতি পাঠানো ঠিকানায় (IP) মিনিটে ৩০০ রিকোয়েস্ট। ভুল লিংকে বড় বডি পড়াই হয় না।
- কলের নিয়ম: একই আইডিতে একবার; একটা নম্বরে দিনে সর্বোচ্চ ৩ বার; do-not-call তালিকা; কলের সময়; ব্যালেন্স — সব লিংকের কলেও খাটে।
- ফলাফল পাঠানো: শুধু
https:// আর শুধু ইন্টারনেটের পাবলিক ঠিকানায় যায় — আমাদের ভেতরের নেটওয়ার্ক বা ক্লাউড মেটাডেটায় কখনো না; redirect মানে না। সার্ভারের নাম আপনাকে লিখে দিতে হয় — কাস্টমারের ডেটা দিয়ে ঠিকানার সার্ভার বদলানো যায় না।
- কাস্টমারের ডেটার মান (নাম, ঠিকানা) রিকোয়েস্টে নিরাপদভাবে বসে: JSON ভাঙে না, হেডারে নতুন লাইন ঢোকানো যায় না, মানের ভেতরের
{secret.…} কখনো আসল সিক্রেট হয় না।
- সিক্রেট শুধু হেডারে, লগে কখনো না। ফোন ক্যারিয়ারের পাসওয়ার্ড (
CARRIER_) পাঠানো যায় না।
- লিংক বানানো, দেখা, বদলানো শুধু অ্যাকাউন্টের অ্যাডমিন পারেন; প্রতিটা কাজ অডিট লগে থাকে।
আপনি যা করবেন (পরামর্শ)
- সিগনেচার যাচাই চালু করুন (লিংকের পেজ → ৪ নম্বর অংশ)। WooCommerce আর Shopify প্রতিটা ওয়েবহুকে একটা সিগনেচার দেয়; চালু করলে শুধু আপনার দোকানের পাঠানো ডেটাই নেওয়া হয়, লিংক ফাঁস হলেও অন্য কেউ কল চালু করতে পারবে না।
- দোকানের webhook secret-টা Developers → Secrets-এ রাখুন (যেমন
SHOP_WEBHOOK_SECRET)।
- Shopify signature বা WooCommerce signature বাটন চাপুন, সিক্রেটের নাম দিন, Save।
- নিজের কোড হলে: বডির HMAC-SHA256 (আপনার সিক্রেট দিয়ে) একটা হেডারে base64 বা hex করে পাঠান, আর সেই হেডারের নাম দিন।
- পাঠানোর সার্ভারের IP নির্দিষ্ট হলে Only from these IPs-এ দিন।
- শর্ত দিয়ে অপ্রয়োজনীয় কল আটকান (যেমন শুধু COD)।
- লিংক কোডে বা git-এ সরাসরি লিখবেন না; সন্দেহ হলে New secret।
- ফলাফল যে API-তে যায়, তার জন্য আলাদা, কম অধিকারের key বানান (যেমন শুধু অর্ডার নোট লেখার)।
- আপনার সার্ভারে আমাদের সিগনেচার যাচাই করুন (নিচে কোড)।
আমাদের পাঠানো রিকোয়েস্ট যাচাই
Meghly-Signature: t=1763542800,v1=5f2c…। v1 = HMAC-SHA256(চাবি = আপনার লিংকের শেষ অংশ / গোপন চাবি, লেখা = t + "." + বডি), hex। t ৫ মিনিটের বেশি পুরনো হলে বাতিল করুন।
// Node.js
const crypto = require("crypto");
function fromParley(rawBody, header, linkSecret) {
const parts = Object.fromEntries(header.split(",").map(p => p.split("=")));
if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false;
const mac = crypto.createHmac("sha256", linkSecret).update(parts.t + "." + rawBody).digest("hex");
return crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(parts.v1 || ""));
}
// PHP
function from_parley(string $raw, string $header, string $secret): bool {
parse_str(str_replace(',', '&', $header), $p);
if (abs(time() - (int)($p['t'] ?? 0)) > 300) return false;
return hash_equals(hash_hmac('sha256', $p['t'] . '.' . $raw, $secret), $p['v1'] ?? '');
}
আমরা কী রাখি
- লিংকে আসা শেষ রিকোয়েস্টটা (নমুনা, সর্বোচ্চ ৬৪ হাজার অক্ষর) — ঘর বাছার জন্য। পরের রিকোয়েস্ট এলে বদলে যায়; লিংক মুছলে মুছে যায়।
- প্রতি লিংকের শেষ ৫০০টা ঘটনা (কখন, কী হলো) আর ফলাফল পাঠানোর লগ।
- কলের ভ্যারিয়েবল কলের সাথে থাকে, অন্য কলের মতোই।
৯. সীমা ও নিয়ম
| বডির আকার | সর্বোচ্চ ১ MB |
| এক রিকোয়েস্টে রেকর্ড | সর্বোচ্চ ১০০ |
| রিকোয়েস্টের গতি | প্রতি লিংকে মিনিটে ১২০; প্রতি IP-তে মিনিটে ৩০০ |
| অ্যাকাউন্টে লিংক | সর্বোচ্চ ৫০ |
| ভ্যারিয়েবলের মান | প্রতিটা সর্বোচ্চ ২০০০ অক্ষর |
| কল করার আগে অপেক্ষা | ০ থেকে ১৪৪০ মিনিট (২৪ ঘণ্টা) |
| একটা নম্বরে চেষ্টা | ২৪ ঘণ্টায় সর্বোচ্চ ৩ বার |
| ফলাফল পাঠানোর অপেক্ষা | আপনার সার্ভার ১০ সেকেন্ডে উত্তর না দিলে আবার চেষ্টা |
১০. সমস্যা হলে
| যা দেখছেন | কী করবেন |
| লিংকের পেজে "Nothing received yet" | আপনার সিস্টেম পাঠায়নি। ওয়েবহুক Active কিনা আর URL পুরোটা ঠিক কপি হয়েছে কিনা দেখুন; একটা টেস্ট অর্ডার দিন। |
sample | ফোনের ঘর বেছে Save করুন। |
invalid — no phone number | ফোনের ঘর ভুল বা কিছু অর্ডারে ফোন নেই। "Check with the last request" দিয়ে দেখুন। |
refused — variables | এজেন্টের দরকারি ভ্যারিয়েবলের ঘর বাছা হয়নি বা ফাঁকা। |
refused — signature | Secrets-এ রাখা সিক্রেট আর দোকানের webhook secret এক নয়, বা হেডারের নাম ভুল। |
duplicate | ঠিক আছে — একই অর্ডারে আবার কল হয় না। প্রতিটা অর্ডারে আলাদা আইডির ঘর বেছেছেন কিনা দেখুন। |
| কল লাইনে আছে কিন্তু হচ্ছে না | কল করার সময়ের বাইরে, বা একসাথে কলের সীমা পূর্ণ। সময় হলে নিজে থেকে হবে। |
| Results sent — answered 401/403 | আপনার API-র key ভুল বা মেয়াদ শেষ; Secrets-এ নতুনটা দিন, Retry। |
| Results sent — answered 404 | ঠিকানা ভুল, বা {var.order_id} খালি; Show the request দিয়ে দেখুন। |
| "the address is not public" | ফলাফল শুধু ইন্টারনেটের পাবলিক https ঠিকানায় যায়; লোকাল বা অফিস নেটওয়ার্কের ঠিকানায় না। |
| লিংকের জায়গায় "secret can't be read" | New secret চাপুন, নতুন লিংক আপনার সিস্টেমে বসান। |
The complete Parley guide (English)
Parley is an AI voice agent that talks on the phone in Bangla or English: it confirms orders, reminds appointments, answers your numbers and hands hard calls to people. Below: from sign-up to daily work — what is required, what is optional, and what each menu does.
Words
Agent — makes calls (outbound) or answers your numbers (inbound). Skill — what the agent says and does; changes make versions, and only a published version runs on calls. Variables — per-call facts (name, order number, amount). Result — what the agent concludes (confirmed, cancelled, call back…). Hand-over — passing the call to a person (live desk or a phone). Campaign — a CSV list called with retries. Call link — your system sends data, a call starts, no code. Plan minutes and wallet — monthly minutes, then the wallet; billed in 10-second steps; unanswered calls are free.
From start to finish
| # | Do | Needed? | Where |
| 1 | Sign up (name, company, email, password, country, language) and enter the emailed code, or use Google | required | Site → Start building |
| 2 | Make an agent: describe the job in your words, or start from a template | required | Overview / Agents / Skills |
| 3 | Test: talk in the browser, call your phone, or the text Test chat | do it | Agents, skill page |
| 4 | Publish the skill; add golden tests that run before every publish | publish required, tests optional | Skills |
| 5 | Phone line: Parley's line by default; your own SIP trunk to call from your number; a number to answer calls | outbound optional, inbound number required | Providers, Phone numbers |
| 6 | Choose how calls start: call links, campaigns, the API, or a test call | at least one | Call links, Campaigns, Developers |
| 7 | KYC: Meghly verifies your business before campaigns | campaigns required | Settings → Calling rules |
| 8 | People: live desk, or transfer to a phone | optional | Live desk, skill page |
| 9 | Results into your system: call link result request or webhooks | optional | Call links, Developers |
| 10 | Daily: calls, recordings, transcripts, AI summaries, dashboards | — | Overview, Calls, Analytics |
| 11 | Money: plan minutes, wallet top-up (bKash/card), auto-recharge | when minutes run out | Billing |
Menu by menu
The menu is in groups: Overview · Build · Run · Observe · Connect · Account, then Docs.
- Overview — range Today / 14 days / 30 days; tiles (calls, answered, task success, handed to people, spend) with the change against the period before; charts: calls and answered per day, how calls ended, spend and success per agent; what needs attention; live and recent calls; campaigns. New accounts describe the job here and get an agent (instructions, opening line, variables, result, hand-over rules, 3 test cases) in about a minute. The mic button at the top right of every page talks to any agent in the browser.
- Build → Agents — cards with direction, skill, live/draft, 7-day numbers and a mic button; New agent (name, direction, skill, optional pinned version); Describe a new agent; Archive. Opening an agent opens the agent editor: tabs Model (AI for calls, languages, first line and how it is said, instructions, business facts, variables), Voice (voice, words to say right, longest call, silence and re-asks, phone keys, answering machines), Tools (your web addresses during the call), Knowledge (which Files it uses, the skill's own documents, Move to Files), Hand-over (when, which desk, transfer to a phone), Analysis (result fields), Advanced (the skill as JSON). A cost bar (line, AI talk, voice, Meghly per minute) and a speed bar (listen / think / speak, from the last 7 days' calls); Chat and Talk beside the form; Versions with what changed, Publish, Restore. An outbound agent can choose which of your numbers its calls show (see the calls chapter).
- Build → Skills — new from empty or a template; the conversation drawn; Definition (JSON); Save as a new version, Publish, Restore; Golden set (optional: known conversations that must pass before publishing, including the expected flow path); Test chat (shows the flow path).
- Build → Files (optional) — upload once, use in any agent: PDF, Word, text, CSV, written text or a public web page (read again daily). Read in the background with a progress figure, then Ready; 20 MB a file, 500 MB an account. Link files to an agent in its Knowledge tab; it applies at once.
- Build → Flows (optional) — draw the call as boxes joined by lines: Say, Ask, Use a tool, Hand over, End the call; a line can carry one condition (what the caller says, a result field, the tool's outcome) or none ("otherwise"). Drag boxes, drag a box's dot to another box for a line, pan, zoom, fit, undo (Ctrl+Z); Tab, arrows and Delete on the keyboard. Save as draft makes a new version; a flow that cannot work (unreachable step, no end, a loop with no way out) is refused with the reason. On a call moving to the next step is instant (no extra AI call) and every move is on the call's timeline.
- Build → Phone numbers — connect your own number or rent one; per number: the answering agent, office hours and days, and after hours (message, voicemail, another agent, the desk, or your mobile); ring a phone first (optional); which outbound agents show this number. Details in the calls chapter.
- Run → Calls — tiles (all, task success, to a person, not answered, failed) for the filters in force, click one to filter; filters in one row (period, agent, direction, how it ended, result, cost) shown as chips; search by number, name, summary or words said; Show more; Download CSV of the filtered list. Numbers are always partly hidden in the panel and the CSV, for everyone signed in; only your API keys get full numbers. On a call: recording, transcript (Translate), AI summary within 30 s, result, timeline (flow moves included), variables, bill; cancel a queued call. Only Meghly's platform admin can delete a call's content; your audit log records it.
- Run → Campaigns (optional) — agent, hours, days, lines, retries; upload a CSV with a
phone column and the variables; Preview; Start (needs KYC), Pause, Resume, Cancel; outcomes live; Results CSV. The do-not-call list here blocks a number for every campaign, link and API call; "don't call me again" on a call adds it.
- Run → Live desk (optional) — desks and members (each a softphone seat in Chrome); hand-overs show why and what the agent knows; unanswered ones go back to the AI or become callbacks; Callbacks list with Done.
- Run → Call links (optional) — data in from any system, a call out, the result back. See the call links chapter.
- Observe → Analytics — task success, answered, average talk, cost per success, per-day charts, results by skill version, AI cost by part.
- Connect → Providers (optional) — your SIP trunk (calls go out from your number; your carrier bills the line); AI choices per job; your own AI keys (the provider bills you), with Test key. Keys are encrypted and never shown again.
- Call links (optional) — data in from any system, a call out, the result back. See the call links chapter.
- Connect → Integrations — what connects today (webhooks, your API as tools, n8n/Zapier/Make/Sheets through webhooks) and what is coming as one-click connectors.
- Connect → Developers (optional, account admins) — API keys (scopes, optional IP list, shown once, revoke), webhooks (signed, test, deliveries, retry), code samples, secrets for tools and links.
- Account → Billing — plan minutes, wallet, per-minute price, spend by agent, the last 50 billed calls, AI usage. Request a top-up: pay Meghly by bKash, Nagad, Rocket, bank or cash, then send the currency (taka or dollar), amount, method and transaction id; Meghly checks it and adds it to your wallet, and calls go on at once (requests list with status; cancel a waiting one; at most 3 waiting). The price of a wallet minute is set by Meghly per currency (e.g. ৳7 or $0.29) and shows here; a change applies from the next call; a plan with its own price keeps it. The wallet's currency is fixed by the first money that reaches it. Online payment (bKash, SSLCommerz, card) and auto-recharge when turned on. Your own carrier's charges are not billed here.
- Account → Settings — account; calling rules (KYC, outbound on/frozen, calling hours, attempts per number); plan limits; account language (owner only: dashboard, summaries, emails and support), summary language, your screen language, your support team; sign out.
Security and privacy
Accounts are isolated by the database itself; passwords, keys and secrets are encrypted, never shown again and never logged; phone numbers are masked in logs; recordings are deleted after your plan's days; calling hours, do-not-call and 3 attempts a day apply to every call; when Meghly's admin opens your panel for support, a red bar shows it and every change is audited under their name.
Inbound and outbound calls — the full picture
Outbound: the agent calls people (order confirmation, reminders, dues). Inbound: the agent answers your number (support, bookings, questions). The conversation, tools, files, flows, results, recordings and billing are the same; what differs is how a call starts and which rules apply.
| Outbound | Inbound |
| Needs | an outbound agent, a published skill, minutes or wallet | an inbound agent, a number (rented or forwarded), minutes or wallet |
| Call data | you send the variables; required ones must be there | the caller cannot send any; Parley adds caller_number, caller_known, caller_previous_calls and the caller's latest campaign contact data |
| Hours | calling hours only (default 09:00–20:00, never outside 08:00–21:00) | the number's office hours (any, overnight too); after hours: message, voicemail, night agent, desk or your mobile |
| Do-not-call, 3 dials a day, KYC | apply (KYC for campaigns only) | do not apply |
| All lines busy | the call waits in the queue | hold message up to 30 s, then a callback message, a callback task and call.callback_requested |
On every call
Opening line (recorded: plays at once; or said by the AI) → conversation following the instructions, Files and the flow if any → phone keys, tools ("one moment" while they run), re-asks on silence and a time limit → "don't call me again" adds the number to do-not-call → hand-over to the desk or a phone → the result → recording, transcript, AI summary within 30 s, bill. A call keeps the skill version it started on.
Outbound
- Four ways to start: Test call, call links, campaigns,
POST /v1/calls. The same key twice makes one call; scheduledAt delays it.
- When it dials: queued calls are looked at every 2 s; inside calling hours in your time zone; up to your plan's lines, oldest first; campaigns use their own days, hours and lines, never call one contact twice at once and wait at least 2 h between retries.
- Checked just before dialling, in order:
tenant_suspended, outbound_frozen, kyc_required (campaigns), do_not_call, retry_limit (3 dials of a number in 24 h), no_balance → the call is Rejected with the reason and a webhook; retry_too_soon and outside_hours only delay it.
- The number people see: the agent's chosen number, else your default carrier's number, else your first rented number, else Meghly's shared number. A call back reaches that number's inbound agent. Forwarded numbers only bring calls in.
- Answering machines (optional): the agent listens first — a short "hello?" then quiet is a person, a long greeting is a machine; unclear within 4 s counts as a person. A machine ends as Voicemail, after leaving your message (variables filled in) if you set one.
Inbound
- Numbers: rent one from Meghly's pool (active at once, monthly rent, can be shown on outbound calls) or forward your own (active with its first call). Your plan sets how many.
- Routing per number: the agent (else the number's desk, else a "not available" message), office hours and days (empty = always open, overnight allowed), after hours (message, voicemail, another agent, the desk, your mobile), and optionally ring your mobile first (10–60 s, default 25; a phone in your country, never one of your Meghly numbers). Every path ends somewhere; nobody is left in silence.
- When a call comes in: the number is recognised in any form → routed → no minutes and no wallet: a message, Rejected → the caller is looked up → a free line: recording notice (if on), opening line, conversation; no free line: hold, then callback → voicemail: message, beep, up to 2 minutes (6 s of silence ends it) → mobile first: the caller hears ringing (not billed), answered = bridged, recorded, billed; not answered = the agent or desk in hours, a voicemail after hours.
People
Live desk: your team's browser softphones, rung one by one (longest idle first); unanswered → back to the AI or a callback; the member sees why and what the agent knows. Transfer to a phone: up to 10 named numbers; the agent stays with the caller until someone answers, else tells the caller and carries on; the number is never given to the AI or the transcript. Both stay one call, recorded and billed; webhook call.handover.
States and endings
Queued → Dialing → Ringing → Answered → InConversation → Completed (inbound starts at Ringing); also NoAnswer, Busy, Voicemail, Rejected, Failed, Cancelled, and HandingOver → WithHuman. End reasons: agent_ended, caller_hung_up, silence, time_limit, voicemail, voicemail_left, handed_over, transferred, opt_out, lines_busy, caller_abandoned, agent_unavailable, not_dialled.
Billing
From answer to hang-up in 10-second steps, plan minutes first, then the wallet. Free: unanswered, busy, rejected and cancelled calls, inbound hold and ringing. Desk, mobile and transfer minutes are part of the same call. Your own carrier bills its line itself. With no minutes and no money, no new call and no transfer starts; calls on the line are not cut.
The API for all of this is in the API reference.
Call links — automatic calls from any system
Parley gives you a link. Your shop, CRM, POS or own app sends its data to the link; your agent calls the customer; when the call ends, Parley can send the result back to your system. No programmer and no fixed format needed.
1. Before you start
You need an outbound agent (Agents page) whose skill has the variables the agent should know (e.g. customer_name, order_id), minutes or balance, and calls happen within calling hours (usually 09:00–20:00); data arriving at night waits for the morning.
2. Make a link
Panel → Call links → New link, give it a name and choose the agent. The link (https://…/in/cl_…/<secret>) is a key: anyone who has it can start calls with your agent. If it leaks, press New secret — the old link stops at once.
3. Send data to it
- WooCommerce: WooCommerce → Settings → Advanced → Webhooks → Add webhook; Status Active, Topic Order created, Delivery URL = the link, a long random Secret. Its save-time test ping is recognised and answered; nothing is called.
- Shopify: Settings → Notifications → Webhooks → Create webhook; Event Order creation, Format JSON, URL = the link. Keep the signing secret shown there.
- CRM / POS / other software: any "webhook", "notification URL" or "HTTP POST" setting; otherwise a Zapier, Make or n8n HTTP step.
- Your own code: POST your JSON (or a classic form) to the link; no API key or header. Examples for cURL, PHP, Node, Python, C# and Google Apps Script are in the Bangla section above — the code is the same.
4. What data we take
Whatever JSON your system produces, with your own field names. Required: a phone number (01711000000, +8801711000000, with dashes or spaces, Bangla digits — all fine). Strongly recommended: a unique id (order number): the same id is never called twice. Plus the fields for the agent's variables. Other fields can be used in conditions. One request may carry a list of up to 100 records (set "List of records" to its path, e.g. leads; leave it empty when the body itself is a list).
5. Choose the fields
Send one test; the link keeps the last request and shows its fields as paths: billing.phone = "phone inside billing", line_items.0.name = "name of the first item". Choose the phone field (no calls until you do), the unique id, a field for each variable, optional conditions (Is, Is not, Contains, Is one of, Has a value, Is empty, More than, Less than — all must match) and an optional delay. Check with the last request shows who would be called, without calling.
6. What the link answers
JSON with one result per record: queued, duplicate, skipped, invalid, refused, sample, ping, paused (see the table above). HTTP: 200 taken · 400 not JSON/form · 403 sender check failed · 404 wrong link · 413 too large · 429 too fast. A turned-off link still answers 200 (nothing called) so senders don't disable the webhook.
7. Send the result back (optional)
On the link's page, part 3: when (call ends / AI summary ready), method, https address, headers, body, and which end states. Placeholders: {var.x}, {result.status}, {result.field}, {call.state|summary|id|to|durationSec|billableSec|endReason|answeredAt|endedAt}, {secret.NAME} (headers only). Values are escaped for JSON, form and URL automatically; write the quotes yourself. Sent once per call; 2xx = delivered, otherwise retried after 1 m, 5 m, 30 m, 2 h, 6 h. Every request carries Meghly-Signature, Meghly-Event and Meghly-Delivery. WooCommerce, Shopify and CRM examples are above.
8. Security
What we do: 160-bit random link secrets stored encrypted and compared in constant time; the same 404 for any wrong link; accounts isolated by the database itself; 120 requests a minute per link and 300 per sender address; one call per unique id, 3 attempts a day per number, do-not-call, calling hours and balance apply; result requests go only to public https addresses, never follow redirects, and the server name must be written by you (the sender's data cannot pick the server); values cannot break JSON, add headers or expand into secrets; secrets only in headers and never logged; phone-carrier passwords can never be sent; only account admins manage links, every change audited.
What you should do: turn on the signature check (part 4: Shopify / WooCommerce buttons, or your own HMAC-SHA256 header) so only your shop can start calls; add your server's IPs if they are fixed; use conditions; keep the link out of code and git; give the result API a narrow key; verify our Meghly-Signature (v1 = hex HMAC-SHA256 with the link's secret part over t + "." + body; reject if t is over 5 minutes old — Node and PHP code above).
What we keep: the last request per link (≤ 64 000 characters) for choosing fields, replaced by the next one and deleted with the link; the last 500 events per link; the result-request log with secrets hidden.
9. Limits
Body 1 MB · 100 records a request · 120 requests/min per link, 300 per IP · 50 links per account · variable values 2000 characters · delay 0–1440 minutes · 3 attempts per number per 24 h · your result endpoint must answer within 10 s.
API reference (developers)
Base address: your Parley address (e.g. https://voice.meghly.com). Everything under /v1 needs Authorization: Bearer <sign-in token> of an account admin (links hold a secret, like API keys). The link itself (/in/…) needs nothing but its address.
| Method and path | What it does |
POST /in/{linkId}/{secret} | Data in: queue calls from any JSON or form body |
GET /in/{linkId}/{secret} | Check the address: {"ok":true,"link":"Shop orders","active":true} |
GET /v1/call-links | All links of the account (with their full address) |
POST /v1/call-links | Make a link |
GET /v1/call-links/{id} | One link with its last request, its fields and a suggested mapping |
PUT /v1/call-links/{id} | Change name, agent, on/off, mapping, sender checks, result request |
DELETE /v1/call-links/{id} | Delete (its events and result log too) |
POST /v1/call-links/{id}/rotate | New secret: the old address stops at once |
POST /v1/call-links/{id}/preview | Who a mapping would call, from the last request or a pasted sample; calls nobody |
POST /v1/call-links/{id}/action-preview | The result request as it would be sent, secrets hidden; sends nothing |
GET /v1/call-links/{id}/hits?limit=100 | Requests received and what each did |
GET /v1/call-links/{id}/deliveries?limit=100 | Result requests sent, their answers and next try |
POST /v1/call-links/deliveries/{id}/retry | Send a result request again now |
PUT /v1/secrets/{NAME} | Store a secret ({"value":"…"}) for {secret.NAME} and signature checks |
Make a link — POST /v1/call-links
{
"name": "Shop orders",
"agentId": "01a1f038-6417-7cf8-94bf-c501cccb4da8",
"mapping": {
"phone": "billing.phone",
"key": "id",
"variables": { "customer_name": "billing.first_name", "order_id": "id", "amount": "total" },
"items": null,
"filters": [ { "path": "payment_method", "op": "equals", "value": "cod" } ],
"delayMinutes": 5,
"guard": {
"allowedIps": [ "203.0.113.10" ],
"signatureHeader": "X-WC-Webhook-Signature",
"signatureSecret": "SHOP_WEBHOOK_SECRET",
"signatureEncoding": "base64"
}
},
"action": {
"event": "call.summarized",
"method": "POST",
"url": "https://your-shop.com/wp-json/wc/v3/orders/{var.order_id}/notes",
"headers": { "Authorization": "Basic {secret.WOO_AUTH}" },
"body": "{\"note\":\"Parley: {call.state}. {call.summary}\"}",
"contentType": "application/json",
"states": [ "Completed" ]
}
}
Only name and agentId are required; mapping, its guard and action can be set later. Answer 201:
{
"id": "01a1f038-6436-7e51-b4ab-adae638ca140",
"name": "Shop orders",
"agentId": "01a1f038-6417-7cf8-94bf-c501cccb4da8",
"active": true,
"url": "https://voice.meghly.com/in/cl_tees7rsdntaf9yf48yf7/fxwiawhr5cjcyirw4iefwf4zq5j33rbv",
"mapping": { … },
"action": { … },
"sampleAt": null,
"createdAt": "2026-11-19T10:00:00Z",
"updatedAt": "2026-11-19T10:00:00Z"
}
| Field | Rules |
mapping.phone, key, items, variables.*, filters[].path | Paths: a.b, a.0.b, a[0].b, $.a.b; up to 200 characters; case-forgiving |
filters[].op | equals, not_equals, contains, in (comma list), exists, missing, greater_than, less_than; up to 10 filters |
delayMinutes | 0–1440 |
guard.allowedIps | Up to 20 addresses or ranges (203.0.113.0/24) |
guard.signature* | Header name + the name of one of your secrets; base64 (Shopify, WooCommerce) or hex; a sha256= prefix is accepted |
action.event | call.completed or call.summarized |
action.method | POST, PUT, PATCH, GET, DELETE |
action.url | https only; the server name written out (no placeholders before the first /); no secrets |
action.headers | Up to 10; not Host or Content-Length; secrets allowed here |
action.contentType | application/json, application/x-www-form-urlencoded, text/plain |
action.states | Any of Completed, NoAnswer, Busy, Voicemail, Failed, Rejected, Cancelled; empty = all |
Errors are 400 with every problem listed:
{ "error": "invalid", "message": "The link has problems.",
"details": [ "phone: not a field path (e.g. billing.phone)", "action.url: an https:// address" ] }
Preview a mapping — POST /v1/call-links/{id}/preview
request: { "mapping": { "phone": "billing.phone", "key": "id", "variables": { "customer_name": "billing.first_name" } } }
answer: [ { "index": 0, "phone": "8801711223344", "variables": { "customer_name": "Rahim" }, "key": "727", "problem": null } ]
Preview the result request — POST /v1/call-links/{id}/action-preview
request: (an "action" object, as above)
answer: { "request": "POST https://your-shop.com/…/orders/727/notes\nAuthorization: Basic •••\n\n{\"note\":\"…\"}",
"problems": [] }
Events — GET /v1/call-links/{id}/hits
[ { "at": "2026-11-19T10:01:00Z", "outcome": "queued", "callId": "01a1…", "detail": "key 727" },
{ "at": "2026-11-19T10:00:30Z", "outcome": "refused", "callId": null, "detail": "wrong or missing signature in X-WC-Webhook-Signature" } ]
Result log — GET /v1/call-links/{id}/deliveries
[ { "id": "cd01…", "callId": "01a1…", "event": "call.completed", "status": "pending", "attempts": 1,
"nextAttemptAt": "2026-11-19T10:06:00Z", "lastStatusCode": 500, "lastError": "answered 500",
"request": "POST https://…\nAuthorization: Basic •••\n\n{…}", "createdAt": "…", "deliveredAt": null } ]
status: pending (waiting or retrying), delivered, failed (all tries used).
Calls, numbers, files and flows
Use an API key (Authorization: Bearer mvk_…) with the scope shown (read grants every read; each write scope grants its own reads), or a panel sign-in token.
| Method and path | Scope | What it does |
POST /v1/calls | calls:write | Queue an outbound call: {agentId, to, variables, idempotencyKey, scheduledAt}; same key = same call; 400 invalid_variables, 409 do_not_call / retry_limit / outbound_frozen / idempotency_conflict |
POST /v1/calls/{id}/cancel | calls:write | Cancel a call still queued |
GET /v1/calls | calls:read | The list. Filters: from, to, agent, direction, endReason, result (Accepted, Rejected, none), outcome, minCost, maxCost, q, limit, cursor; the next page's cursor is in X-Next-Cursor |
GET /v1/calls/summary | calls:read | The tiles for the same filters: all, task success, to a person, not answered, failed |
GET /v1/calls/export.csv | calls:read | The filtered list as CSV, streamed; numbers partly hidden |
GET /v1/calls/{id}, /transcript | calls:read | One call with its events and result; its turns (caller, agent, tool — flow moves appear as flow_step: ask → cancel) |
GET /v1/numbers, /available | calls:read | Your numbers; free pool numbers with their rent |
POST /v1/numbers/{id}/rent, POST /v1/numbers/forwarded | calls:write | Rent a pool number; connect your own forwarded number ({number, agentId?, label?}) |
PUT /v1/numbers/{id}, /routing | calls:write | The answering inbound agent; {hours, weekdays, afterHours, afterHoursAgentId, afterHoursMessage, deskId, forwardTo, forwardInHours, forwardRingSeconds} |
GET /v1/caller-numbers, PUT /v1/agents/{id}/caller-number | read / agents:manage | Which numbers an outbound agent may show; choose one ({numberId}, null = default) |
GET /v1/compliance | read | KYC, outbound on/frozen, calling hours, limits |
GET/POST/DELETE /v1/files, POST /v1/files/text, /v1/files/url | read / skills:manage | Files: upload, write, add a web page, delete; status and progress |
PUT /v1/agents/{id}/files | agents:manage | Which files an agent uses (applies at once) |
GET /v1/agents/{id}/estimate, /latency | read | Cost per minute by part; listen / think / speak medians of the last 7 days |
POST /v1/skills/{id}/versions | skills:manage | A new version; its definition may hold a flow (below) |
A flow inside a skill definition (box positions x, y are kept for the canvas and never sent to the AI):
"flow": {
"start": "ask",
"steps": [
{ "id": "ask", "type": "ask", "text": "Ask {customer_name} if order {order_id} is right.",
"next": [ { "to": "confirm", "when": "the caller says yes" }, { "to": "cancel", "when": "the caller says no" } ] },
{ "id": "confirm", "type": "tool", "tool": "submit_result",
"next": [ { "to": "thanks", "field": "status", "equals": "confirmed" }, { "to": "bye" } ] },
{ "id": "cancel", "type": "say", "text": "Say sorry, the order is cancelled.", "next": [ { "to": "bye" } ] },
{ "id": "thanks", "type": "end", "text": "Thank them." },
{ "id": "bye", "type": "end" }
]
}
Step types: say, ask, tool, handover, end. A line has at most one of when, field + equals, outcome (ok/failed, tool steps only). A golden case may expect a path: "expect": { "path": ["ask", "cancel", "bye"] }. A flow that cannot work answers 400 with every problem, e.g. Step 'lost' cannot be reached from the start step 'ask'.
Prefer a plain API?
POST /v1/calls with an API key (calls:write) does the same for one call: {"agentId":"…","to":"+8801711000000","variables":{…},"idempotencyKey":"order-A-1001"}, and the call.completed webhook carries the result. Call links are the no-code way to get the same.