# Blasty

> Blasty turns your WhatsApp number into an AI agent. Link an existing
> WhatsApp number by scanning a QR code (no WhatsApp Business API approval needed),
> and the agent auto-replies to every customer around the clock, summarizes
> conversations on demand, and blasts personalised campaigns to thousands of
> contacts. Billing is pay-as-you-go: one credit per message sent (from RM0.02),
> no subscription.

## What you can do

- Link one or more WhatsApp numbers as "devices" via QR code.
- Send single or bulk messages, and run broadcast campaigns to contact groups.
- Manage contacts, groups, and reusable message templates.
- Create AI agents (with instructions + knowledge sources) and assign them to a
  device for automatic replies, with a live shared inbox to take over manually.
- Generate an AI summary of any conversation on demand from the shared inbox.

## Connecting an agent

Blasty exposes a REST API and an MCP (Model Context Protocol) server so AI agents
can send messages and manage contacts programmatically.

- All API requests use a Sanctum bearer token: `Authorization: Bearer <token>`.
  Mint a token from the dashboard (Settings → API tokens) or `php artisan wa:token`.
- Sending endpoints require a verified email on the token owner.
- Base URL: https://blasty.my/api/v1

### MCP server

- Discovery document: https://blasty.my/mcp.json
- The MCP server wraps the same REST API; authenticate with the bearer token above.

## API reference

- Human docs: https://blasty.my/api-docs (login required)
- Connection
  - `GET  /api/v1/connection/status` — WhatsApp connection / linked-device state
  - `GET  /api/v1/connection/qr` — login QR (data URL) for linking a number
- Messages
  - `GET  /api/v1/messages` — paginated message log (filter by status, campaign_id)
  - `GET  /api/v1/messages/{id}` — single message status
  - `POST /api/v1/messages/send` — queue one message (verified email required)
  - `POST /api/v1/messages/bulk` — queue up to 1000 messages at once
- Campaigns
  - `GET  /api/v1/campaigns` — paginated campaign log
  - `GET  /api/v1/campaigns/{id}` — single campaign
  - `POST /api/v1/campaigns` — create and dispatch a campaign
- Contacts
  - `GET/POST/PUT/DELETE /api/v1/contacts[/{id}]` — list, upsert, update, delete
- Templates
  - `GET/POST/PUT/DELETE /api/v1/templates[/{id}]` — manage message templates

## Notes for agents

- Phone numbers must parse as Malaysian numbers (e.g. `0123456789`).
- Each sent message costs one credit; check the account balance before bulk sends.
- Message bodies support merge fields like `{{name}}` for personalisation.
- Respect recipients' `opted_out` flag — do not message opted-out contacts.

## Legal

- Terms of Service: https://blasty.my/terms
- Privacy Policy: https://blasty.my/privacy