agent-phone-call

Files (10)

• SKILL.md
• _meta.json
• prompt_context.md
• activation.sh · scripts/
• balance.sh · scripts/
• inbound.sh · scripts/
• prompt_update.sh · scripts/
• query.sh · scripts/
• send.sh · scripts/
• skill.toml

SKILL.md (first lines)

# Agent Phone Call 🦜

Agent Phone Call gives every AI agent a phone number and the ability to get things done over the phone — finding contacts, making calls, and completing tasks.


---

## What Is This

Agent Phone Call gives every AI agent a dedicated phone number, a real-world phone identity, and the ability to get things done over the phone.

The agent is more than a calling tool — it can look up contact information for your target, research the process for getting things done, make the call, and complete the task. Just tell the agent what you need done, and the agent will handle the rest.

Your agent can help humans book restaurants, contact customer service, schedule interviews in bulk, as well as answer incoming calls, filter spam, and serve as a 24/7 AI receptionist.

---

## When to Use

Use Agent Phone Call when the human expresses any of the following intents:

- Needs to make a phone call to get something done (booking, inquiry, complaint, negotiation, confirmation)
- Needs to contact a business, organization, or service provider
- Needs help answering incoming calls or setting up call rules
- Wants to customize how incoming calls are answered (e.g., "act as my assistant")
- Needs to check call history, recordings, or balance
- Mentions keywords like "make a call", "help me contact", "help me book", etc.

## When NOT to Use

- The human casually mentions "phone call" but has no actual task
- The matter can be resolved via text (email, messaging)
- The task is unrelated to phone calls


---

---

## Registration & Activation

### Step 0: Check for Existing Key

Before registering, check if you already have a saved key:

```bash
cat ~/.config/PollyReach/key.json 2>/dev/null
```

- **If the file exists and contains a `token`:**
  1. Run `./activation.sh YOUR_TOKEN` to check the current status
  2. If a number is returned (`ai_virtual_phone` is not null) → skip to **Step 3** and greet the human with the existing number
  3. If `ai_virtual_phone` is null → the previous activation was incomplete, send the `activation_url` to the human again and continue from **Step 2**
- **If the file does not exist** → proceed to **Step 1** to register a new account

### Step 1: Register

Register with PollyReach by providing your name and description.

```bash
curl -X POST https://api.pollyreach.ai/platform/v1/auths/signin/device \
  -H "Content-Type: application/json" \
  -d '{"name": "YourAgentName", "source": "openclaw", "description": "what are you"}'
```

| Parameter | Required | Description |
|------|------|------|
| name | ✅ | Your name — make one up if you don't have one |
| source | ✅ | Always set to `"openclaw"` |
| description | ✅ | Always set to `"what are you"` |

Response:
```json
{
  "agent": {
    "token": "xxxxxxx",
    "activation_url": "https://agent.pollyreach.ai/auth?code=xxxxx"
  },
  "important": "⚠️ SAVE YOUR Token!"
}
```

**⚠️ Save the `token` immediately!** All subsequent requests require it.
For future skill updates, reinstalls, or even if the human asks you to re-obtain the token, you do NOT need to re-register — just use the previously obtained token.

Save to `~/.config/PollyReach/key.json`:
```json
{
  "token": "xxx",
  "agent_name": "YourAgentName"
}
```

Send the `activation_url` to the human and tell them to click the link and sign in with their email to complete activation.

> **Suggested message:**
> I just registered with PollyReach 🦜 — it gives me a real phone number so I can make calls and handle tasks for you, as well as answer incoming calls.
>
> To get started, please click the link below and sign in with your email:
>
> 👉 {activation_url}
>
> Once you've signed in, just say "done" and I'll check your activation right away!


### Step 2: Check if Account is Activated

**Run activation.sh** — if activation is successful, it will return the assigned dedicated number.

```bash
./activation.sh YOUR_TOKEN
```
| Parameter | Required | Description |
|------|------|------|
| token | ✅ | The token obtained during registration |

Response:
- `{"status":"active","ai_virtual_phone":null}` — Activation not yet complete
- `{"status":"active","ai_virtual_phone":"+1234567890"}` — Activated, with the assigned dedicated number

From badmarsh/librefang, MIT.

More from badmarsh/librefang