# Send Sophiie AI Office Manager to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "sophiie",
    "name": "Sophiie AI Office Manager",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/tomc98/sophiie",
    "canonicalUrl": "https://clawhub.ai/tomc98/sophiie",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/sophiie",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sophiie",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/sophiie.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/sophiie"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/sophiie",
    "downloadUrl": "https://openagent3.xyz/downloads/sophiie",
    "agentUrl": "https://openagent3.xyz/skills/sophiie/agent",
    "manifestUrl": "https://openagent3.xyz/skills/sophiie/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/sophiie/agent.md"
  }
}
```
## Documentation

### Sophiie — Sales Pipeline Management

Sophiie is a B2B SaaS platform for sales pipeline management. Organizations get AI-powered virtual assistant agents that handle calls, SMS, and lead management. This skill lets you manage your Sophiie pipeline via natural language.

### Authentication

All requests use Authorization: Bearer <key> where the key is SOPHIIE_API_KEY. Keys are prefixed sk_live_* (production) or sk_test_* (sandbox).

Base URL: https://api.sophiie.ai
Rate limit: 60 requests/minute
All responses: JSON

### External Endpoints

MethodURLData SentGEThttps://api.sophiie.ai/v1/leadsQuery: page, limitGEThttps://api.sophiie.ai/v1/leads/{id}NonePOSThttps://api.sophiie.ai/v1/leadsBody: firstName, lastName, email, phone, suburb, businessName, socialsPUThttps://api.sophiie.ai/v1/leads/{id}Body: firstName, lastName, email, phone, suburb, businessName, socialsDELETEhttps://api.sophiie.ai/v1/leads/{id}NoneGEThttps://api.sophiie.ai/v1/leads/{id}/notesQuery: page, limitGEThttps://api.sophiie.ai/v1/leads/{id}/activitiesQuery: page, limitGEThttps://api.sophiie.ai/v1/inquiriesQuery: page, limit, leadId, expandGEThttps://api.sophiie.ai/v1/inquiries/{id}NoneGEThttps://api.sophiie.ai/v1/appointmentsQuery: page, limit, leadIdPOSThttps://api.sophiie.ai/v1/callsBody: name, phoneNumber, mode, custom_instructionsPOSThttps://api.sophiie.ai/v1/smsBody: userId, leadId, message, messageThreadIdGEThttps://api.sophiie.ai/v1/faqsQuery: page, limitPOSThttps://api.sophiie.ai/v1/faqsBody: question, answer, isActivePUThttps://api.sophiie.ai/v1/faqs/{id}Body: question, answer, isActiveDELETEhttps://api.sophiie.ai/v1/faqs/{id}NoneGEThttps://api.sophiie.ai/v1/policiesQuery: page, limitPOSThttps://api.sophiie.ai/v1/policiesBody: title, content, isActivePUThttps://api.sophiie.ai/v1/policies/{id}Body: title, content, isActiveDELETEhttps://api.sophiie.ai/v1/policies/{id}NoneGEThttps://api.sophiie.ai/v1/membersQuery: page, limitGEThttps://api.sophiie.ai/v1/organizationNoneGEThttps://api.sophiie.ai/v1/organization/availabilityNoneGEThttps://api.sophiie.ai/v1/organization/membersQuery: page, limitGEThttps://api.sophiie.ai/v1/organization/servicesNoneGEThttps://api.sophiie.ai/v1/organization/productsNone

### Security & Privacy

The SOPHIIE_API_KEY is never logged, printed, or echoed in output
All requests use HTTPS only
No data is cached locally — every command fetches live from the API
All user input is sanitized via jq -n (never string-interpolated into JSON bodies)
The skill has read-only access to SOPHIIE_API_KEY — it cannot modify or delete the environment variable

### Command Reference

All commands are run via scripts/sophiie.sh <domain> <action> [options].

### Leads

leads list — List all leads in the pipeline

--page <n>    Page number (default: 1)
--limit <n>   Items per page (default: 50, max: 100)

Use when the user wants to see their pipeline, check leads, or browse contacts.

leads get <id> — Get full details for a specific lead
Use when the user asks about a specific lead by name or ID. Lead IDs start with ld_.

leads create — Create a new lead

--firstName <name>      Required (min 2 chars)
--suburb <suburb>       Required
--lastName <name>       Optional
--email <email>         Optional (valid email)
--phone <number>        Optional (E.164 format, e.g. +61412345678)
--businessName <name>   Optional
--instagram <handle>    Optional
--facebook <handle>     Optional

Use when the user wants to add a new contact or lead to their pipeline.

leads update <id> — Update an existing lead
Same options as create, but all are optional. At least one field must be provided.
Use when the user wants to change lead details.

leads delete <id> — Delete a lead (soft delete)
Use when the user explicitly asks to remove a lead. Always confirm before deleting.

leads notes <id> — List notes for a lead

--page <n>    Page number (default: 1)
--limit <n>   Items per page (default: 50, max: 100)

Use when the user asks about notes or history on a specific lead.

leads activities <id> — List activity log for a lead

--page <n>    Page number (default: 1)
--limit <n>   Items per page (default: 50, max: 100)

Use when the user wants to see what happened with a lead (timeline, events).

### Inquiries

inquiries list — List all inquiries

--page <n>       Page number (default: 1)
--limit <n>      Items per page (default: 50, max: 100)
--leadId <id>    Filter by lead ID (ld_...)
--expand <type>  Expand related data: "external", "lead", or "both"

Use when the user asks about incoming inquiries, messages, or calls received.

inquiries get <id> — Get full inquiry details with source data
Returns the inquiry with expanded source data (call transcripts, SMS messages, webform submissions, etc.) depending on the inquiry source type (CALL, SMS, EMAIL, CHATBOT, WEBFORM).
Use when the user wants details on a specific inquiry.

### FAQs

faqs list — List all FAQs

--page <n>    Page number (default: 1)
--limit <n>   Items per page (default: 50, max: 100)

Use when the user wants to see their knowledge base or FAQ entries.

faqs create — Create a new FAQ

--question <text>    Required (max 255 chars)
--answer <text>      Required
--isActive <bool>    Optional (true/false)

Use when the user wants to add to their AI agent's knowledge base.

faqs update <id> — Update an FAQ (ID is a number)
Same options as create, all optional.
Use when the user wants to change an existing FAQ entry.

faqs delete <id> — Delete an FAQ (soft delete)
Always confirm before deleting.

### Policies

policies list — List all policies

--page <n>    Page number (default: 1)
--limit <n>   Items per page (default: 50, max: 100)

Use when the user asks about their business policies.

policies create — Create a new policy

--title <text>      Required (min 2, max 255 chars)
--content <text>    Required (min 2 chars)
--isActive <bool>   Optional (true/false)

Use when the user wants to add a business policy for their AI agent.

policies update <id> — Update a policy (ID is a number)
Same options as create, all optional.

policies delete <id> — Delete a policy (soft delete)
Always confirm before deleting.

### Communication

calls send — Initiate an outbound AI call

--name <name>                 Required — name of person being called
--phoneNumber <number>        Required — E.164 format (e.g. +61412345678)
--mode <mode>                 Optional — "normal" (default) or "transfer_only"
--custom_instructions <text>  Optional — required when mode is "transfer_only"

Use when the user wants to call someone. Always confirm the phone number before calling.

sms send — Send an SMS message

--userId <id>             Required — sender user ID (usr_...)
--leadId <id>             Required — recipient lead ID (ld_...)
--message <text>          Required — message text (min 2 chars)
--messageThreadId <n>     Optional — existing thread ID (number); omit to start new thread

Use when the user wants to text a lead. You need to know the userId — use members list first if needed.

### Appointments

appointments list — List all appointments

--page <n>       Page number (default: 1)
--limit <n>      Items per page (default: 50, max: 100)
--leadId <id>    Filter by lead ID (ld_...)

Use when the user asks about upcoming appointments or scheduled meetings.

### Organization

org get — Get organization details (name, timezone, currency, etc.)
Use when the user asks about their org settings or business info.

org availability — Get business hours / availability schedules
Use when the user asks about working hours or availability.

org members — List organization members with roles

--page <n>    Page number (default: 1)
--limit <n>   Items per page (default: 50, max: 100)

Use when the user asks about team members (returns membership-level data with positions/avatars).

org services — List services offered (grouped by category)
Use when the user asks about their service offerings.

org products — List products offered (grouped by category)
Use when the user asks about their product catalog.

### Members

members list — List all organization members

--page <n>    Page number (default: 1)
--limit <n>   Items per page (default: 50, max: 100)

Use when you need user IDs (usr_...) for operations like sending SMS. Returns user-level data with roles.

### Decision Guide

User intentCommand(s)"Check my pipeline" / "Show leads"leads list"Tell me about [lead name]"leads list → find by name → leads get <id>"Add a new lead" / "New contact"leads create"Update [lead]'s phone number"leads update <id> --phone <number>"Remove this lead"leads delete <id> (confirm first)"What inquiries came in?"inquiries list"Show me that call transcript"inquiries get <id>"Any appointments today?"appointments list"Call [person]" / "Ring [number]"calls send (confirm number first)"Text [lead] about [topic]"members list → get userId → sms send"Update the knowledge base"faqs list → then faqs create or faqs update"Add a refund policy"policies create"What are our business hours?"org availability"Who's on the team?"members list or org members"What services do we offer?"org services

### Pagination

All list endpoints return paginated responses:

{
  "items": [...],
  "totalPages": 5,
  "currentPage": 1,
  "totalCount": 237
}

Default: page 1, 50 items per page
Maximum: 100 items per page
Always check totalPages — if there are more pages, tell the user and offer to fetch the next page

### Error Reference

CodeMeaningWhat to tell the user401Invalid or missing API key"Your API key appears to be invalid. Check SOPHIIE_API_KEY."404Resource not found"That [lead/inquiry/etc.] wasn't found. Double-check the ID."409Conflict (duplicate lead)"A lead with that info already exists."429Rate limited"Too many requests. Wait a moment and try again."500Server error"Something went wrong on Sophiie's end. Try again shortly."

Error responses have this shape:

{
  "success": false,
  "message": "...",
  "error": { "status": 401, "message": "..." }
}
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: tomc98
- Version: 0.0.3
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/sophiie)
- [Send to Agent page](https://openagent3.xyz/skills/sophiie/agent)
- [JSON manifest](https://openagent3.xyz/skills/sophiie/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/sophiie/agent.md)
- [Download page](https://openagent3.xyz/downloads/sophiie)