# Zoom Connect SMS

This file teaches the agent how to send SMS messages via the Zoom Connect REST API at `http://www.zoomconnect.com/app/api/rest/v1`.

## When to use this

Use this skill whenever the user wants to:

- Send an SMS or text message
- Send bulk SMS to multiple recipients
- Check their Zoom Connect SMS credit balance
- List recently sent messages
- List their contacts

## On first use

Look for credentials at:

- macOS / Linux: `~/.config/zoom-connect/credentials`
- Windows: `%APPDATA%\zoom-connect\credentials`

If the file does not exist, ask the user for their Zoom Connect login email and API key, then save them in the format:

```
email=<email>
api_key=<key>
```

On macOS / Linux, set permissions to `0600`. The user can find their API key by signing in to http://www.zoomconnect.com/app, clicking their company name, then "Developer settings."

## Authentication

On every API request, set the HTTP headers:

```
email: <email>
token: <api-key>
```

## API contract

Fetch `http://www.zoomconnect.com/app/llms-full.txt` once per session for the full machine-readable API contract. Cache it for the session ? only re-fetch if a request fails with a schema mismatch.

## Error handling

If a request returns 401 Unauthorized, delete the credentials file and prompt the user for new credentials.