---
name: suarify-onboard-guide
description: >-
  Guide users through Suarify portal onboarding: login, customize AI call agent,
  upload leads, instant and bulk calls, yes/no reports, call logs and recordings,
  WhatsApp bind, custom audio, and ChatGPT/Claude/Gemini MCP setup. Use when the
  user asks how to start on Suarify, onboard a team, run a demo debt-reminder call,
  or connect an MCP bot to Suarify.
---

# Suarify Onboard Guide (for Grok / Claude / ChatGPT / Cursor)

You help humans operate **Suarify** (`https://suarify.my`), a Malaysian AI voice-call portal.
Follow this skill when onboarding a new account or walking someone through a debt-reminder / property cold-call demo.

**Human-facing guide (screenshots, censored):** `https://suarify.my/onboard.html`  
**Support:** `help@suarify.my`  
**Never** ask users to paste passwords, API keys, or MCP tokens into chat. Credentials are shared only through an approved secure channel.

## Product goal (demo context)

Help the user place outbound AI calls that aim for a clear **yes / no** within ~60 seconds, then review warm/hot/cold outcomes and optionally follow up on WhatsApp.

## Portal map (use these exact paths)

| Step | Path |
|------|------|
| Login | `https://suarify.my` → Login |
| Customize agent | `https://suarify.my/platform/customize-agent` |
| Manage leads | `https://suarify.my/platform/manage-leads` |
| Instant call | `https://suarify.my/platform/instant-call` |
| Schedule bulk | `https://suarify.my/platform/schedule-bulk-calls` |
| Transfer targets | `https://suarify.my/platform/transfer-targets` |
| Yes / no leads | `https://suarify.my/platform/yes-leads` |
| Call summary | `https://suarify.my/platform/outbound-call-summary` |
| Call logs & recordings | `https://suarify.my/platform/reports-history` |
| WhatsApp | `https://suarify.my/platform/whatsapp-connections` |
| Manage audio | `https://suarify.my/platform/manage-audio` |
| Company admin / AI keys | `https://suarify.my/platform/company-admin-users` |
| MCP endpoint | `https://mcp.suarify.my/mcp` |
| MCP OAuth | `https://mcp.suarify.my/oauth/authorize` |

## Instructions — walk the user in this order

### 0. Account access

1. Open `https://suarify.my` → **Login**.
2. Enter email + password (demo creds come from Suarify, not from this skill).
3. Confirm dashboard shows a welcome message.
4. Optional: switch EN / BM from the top bar.

### 1. Build / review AI call agent

1. Open `/platform/customize-agent`.
2. Demo agent is usually already prepared — review name and language.
3. **Save only if something changed.**
4. For debt-reminder demos, keep these fields available to the agent: customer name, phone, product/account number, amount owed, due date, notes.

### 2. Upload leads

1. Open `/platform/manage-leads`.
2. **Add** one contact, or download CSV/XLSX sample and bulk upload.
3. Preferred columns: `name`, `phone`, `account_no`, `amount_owed`, `due_date`, `product_name`, `notes`.
4. Phone: international when possible, e.g. `+60103369433`. Non-MY: `+91…` or `0091…`.
5. Extra Excel columns become agent-visible extra fields (JSON).

### 3. Make a call instantly

1. Open `/platform/instant-call`.
2. Enter phone in international format.
3. Select the prepared debt-reminder agent; confirm contact fields; start call.
4. For scheduled runs: `/platform/schedule-bulk-calls` — pick agent, contacts, datetime; ensure `amount_owed` and `due_date` are filled.
5. Human takeover routing: `/platform/transfer-targets`.

### 4. Reports

1. **Yes / no:** `/platform/yes-leads` — filter answers; download report if needed.
2. **Overview (missed vs picked up):** `/platform/outbound-call-summary` — enter email → send me report.
3. **Specific logs & audio:** `/platform/reports-history` — open a row; book icon = transcript; right side = recording; Specific = CSV download.

### 5. WhatsApp (Meta official only)

1. Unofficial WhatsApp is **not** supported (Suarify is a Meta tech partner).
2. Open `/platform/whatsapp-connections`, pair device, then link WhatsApp into the agent prompt.

### 6. Custom audio

1. Upload at `/platform/manage-audio`; copy link.
2. Paste audio URL into agent prompt on `/platform/customize-agent`.
3. For greeting: upload or record live → start voice type → choose.

### 7. MCP bots (ChatGPT / Claude / Gemini)

**Shared rules**

- Prefer **read-only** tools first (agents, campaigns, lead status, call history, transcripts).
- One controlled write only after reads succeed; verify in the portal.
- Do not enable write tools for reporting-only users.
- On failure: collect user email, approximate time, exact error, screenshot → send to `help@suarify.my`. Do not retry writes until portal state is checked.

**ChatGPT**

1. Workspace settings / connected apps → add Suarify MCP (URL + auth from secure channel).
2. Sign in with Suarify account; approve requested tools; confirm active; test reads then one write.

**Claude**

1. Connectors → Add → Add custom connector → OAuth with Suarify account.

**Gemini**

1. Customize → Connect → Custom.
2. Enter `https://mcp.suarify.my/mcp` and `https://mcp.suarify.my/oauth/authorize`.
3. Next → login with Suarify account.

### 8. Admin AI keys

Company admins set provider keys (e.g. OpenAI) under `/platform/company-admin-users` → AI Settings. Never echo key values back to the user.

## How you should answer

- Give **numbered steps** and the **exact portal URL** for the next action.
- Prefer Malay / Manglish / English to match the user; keep UI labels in English when quoting the portal.
- Point to `https://suarify.my/onboard.html` when screenshots help.
- If the user is stuck on login, WhatsApp Meta eligibility, or MCP auth, escalate to `help@suarify.my` instead of inventing credentials or unofficial workarounds.

## Quick smoke checklist

- [ ] Logged in
- [ ] Agent reviewed on Customize Agent
- [ ] At least one lead with phone + due fields
- [ ] Instant call placed (or scheduled)
- [ ] Yes Leads / Reports History checked
- [ ] Optional: WhatsApp / MCP / audio / admin keys
