Introduction

What oyehello is and how the pieces fit together.

Welcome. oyehello lets you build AI agents that hold a real, natural conversation with your customers, in the language they actually speak, on three channels from one workspace: phone calls, website chat, and WhatsApp. One agent can call thousands of people to remind them about an appointment, or answer every incoming support call at 2am, or qualify a fresh batch of leads before your sales team ever picks up. It sounds human, it never gets tired, and it sticks to the brief you gave it. You build it once, in your browser, with no code.

This guide walks you through the whole thing - from your first agent to running real campaigns and reading the results. Take it at your own pace; nothing you build goes live until you decide it should.

New here? You don’t need to read this end-to-end. Skim this page to get the mental model, then jump to whatever you’re trying to do. The sidebar is grouped the same way you’ll actually work: build an agent → run it → review results.

The mental model

Almost everything in oyehello hangs off one simple idea:

You build an agent once, point conversations at it - and review what happened afterward.

That’s the whole loop. Three moving parts:

  • The agent is the “who.” It’s the worker that does the talking - its voice (for calls), its language, its persona, its goal, the rules it follows, and the things it’s allowed to do. Every agent is a flow you build in the visual flow builder. See Create an agent.
  • The channel is the “where.” One agent serves one channel, chosen when you create it and fixed after that: Call, Chat (a widget on your website), or WhatsApp. A call agent also has a fixed direction: outbound (it makes calls) or inbound (it answers them).
  • The results are the “what happened.” Every call leaves behind a transcript, an outcome, and any details you asked the agent to capture - plus a recording if recording is on. Chats and WhatsApp conversations leave the same kind of record.

If you remember nothing else, remember that shape: build → run → review. The rest of this guide is just the details of each part.

The building blocks, briefly

Here’s how the pieces you’ll meet fit into that loop:

  • Agents - the worker. You give it a voice and language, a persona, a goal, and a personality. This is where most of your time goes, and it’s worth it.
  • Knowledge base - your real documents, FAQs, and policies, so the agent answers from your actual content instead of guessing.
  • Tools & actions - things the agent can do mid-call: transfer to a human, book a meeting, send a WhatsApp, push an outcome to your CRM.
  • Compliance packs - the rulebook the platform enforces before it ever dials: calling-time windows, Do-Not-Disturb scrubbing, how often the same person can be contacted. You pick a pack; the platform obeys it automatically.
  • Campaigns - upload a list, map your columns, and let the dialer place calls at scale for outbound work. WhatsApp has campaigns too.
  • Nudges - one AI call to one person, triggered on demand from your own system or the console, held until calling hours and retried if nobody answers.
  • Phone numbers - the numbers you call from, and the numbers customers call in to for inbound.
  • Website chat and WhatsApp - the same kind of agent, answering text conversations on your site and on your own WhatsApp Business number.
  • Calls & transcripts and dispositions - everything the call left behind, ready to read, filter, and report on.

What people actually use it for

The same build-once-then-call pattern covers a surprising range of jobs. A few common ones, with the shape of a real call:

  • Sales & lead qualification - call a list of new leads, figure out who’s genuinely interested, and book the hot ones straight into a calendar. “Hi Priya, you enquired about our course - mind if I ask two quick questions to see what you’d qualify for?”
  • Reminders & confirmations - appointment reminders, delivery confirmations, COD order confirmations. One clear message, a chance to confirm or reschedule, done. “This is a reminder that your appointment is tomorrow at 4pm. Would you like to keep it or move it?”
  • Customer support - answer incoming calls, chats and WhatsApp messages, resolve the easy stuff from your knowledge base, and hand the rest to a human. “I can see your order shipped this morning - want me to send you the tracking link?”
  • Feedback & surveys - call after a purchase or a visit, ask a few questions, and capture the answers as clean, reportable fields.

Don’t see your exact use case? If it’s a conversation with a clear purpose, an agent can probably do it. Start with the closest example above and adjust the brief.

Your first 15 minutes

The fastest way to understand oyehello is to build a tiny agent and hear it talk. Here’s a path that gets you there without touching anything you don’t need yet:

  1. Create an agent. Choose a channel, give it a voice and language, and write a one-line purpose - “Remind the customer their appointment is tomorrow and confirm they’ll attend.” That’s genuinely enough to start. The full walkthrough is in Create an agent.
  2. Test it before anyone real hears it. Type as the caller in the Simulate tab, talk to your agent through your computer’s microphone, or place a test call to your own phone so you hear it live. Both are covered in Test your agent.
  3. Publish it. Nothing goes live until you hit Publish. Once you do, campaigns, phone numbers, the chat widget and WhatsApp can use it. Change something later? Just republish.
  4. Run a small campaign. Upload a short list - even five of your own numbers - map the columns, and let it dial. Watch the calls land in Calls & transcripts in real time. See Campaigns.

Tip: keep your first list tiny and use numbers you own. Reading your own transcripts back is the single fastest way to learn what to tweak in the brief.

One thing before you go live

You can build and test agents right away - that part’s free and open. To place live calls to real customers, you’ll first do two quick things: complete KYB verification (so we know who’s calling) and top up your prepaid wallet (calls are billed per minute). Both are walked through in Sign up & workspace and Billing & wallet.

And if you’d rather drive all of this from your own code instead of the console, there’s a full API reference that does everything this guide does, programmatically.

Next: Sign up & workspace → - create your workspace, get verified, and add your team.