spoki

Connect your WhatsApp Business to Claude. Spoki lets you send messages, manage contacts, launch marketing campaigns, build automations, and

Open source Repository Open in the app JSON README (API)

About

Connect your WhatsApp Business to Claude. Spoki lets you send messages, manage contacts, launch marketing campaigns, build automations, and track performance... all through natural conversation. You can go from "send a birthday coupon to my VIP list" to done in seconds. No dashboard switching, no manual exports. Just ask Claude.

Details

Kind: Plugins
Topic: Marketing & analytics
Publisher: spoki-app
Origin: marketplace
Category: ferramentas
Last push: 2026-04-08T09:42:47Z
Repository state: ativo
Language: Shell
Added: 2026-08-30 01:48:58
Updated: 2026-08-30 01:48:58
Origin id: spoki-app/spoki-claude-plugin/spoki

README

# Spoki — Claude Plugin

Connect your [Spoki](https://spoki.com) WhatsApp Business Platform to Claude. Send messages, manage contacts, launch campaigns, build automations, and track performance — all through natural conversation.

**59 tools** | **5 skills** | **2 agents** | **5 platforms**

## Installation

### From Claude Marketplace

```
/install spoki
```

### Manual Install

```
/plugin marketplace add Spoki-App/spoki-claude-plugin
/plugin install spoki@spoki-marketplace
```

## Configuration

The plugin requires a Spoki API key:

1. Log into [Spoki](https://app.spoki.it)
2. Go to **Settings** → **Developers** → **API Keys**
3. Copy your API key

Claude will prompt you for the key on first use.

## Skills

| Skill | Command | What it does |
|-------|---------|-------------|
| **Send Message** | `/spoki:send-message` | Send WhatsApp messages — free text, templates, or internal notes |
| **Create Campaign** | `/spoki:create-campaign` | Create and schedule WhatsApp marketing campaigns |
| **Manage Contacts** | `/spoki:manage-contacts` | Search, create, sync, update, and delete contacts |
| **Create Automation** | `/spoki:create-automation` | Build automation workflows with delays, messages, tags, and conditions |
| **Analytics** | `/spoki:analytics` | View account reports, usage metrics, and campaign performance |

## Agents

| Agent | What it does |
|-------|-------------|
| **WhatsApp Campaign Manager** | Plans multi-step campaigns — template selection, list segmentation, scheduling, performance analysis |
| **Customer Support Setup** | Sets up ticket categories, statuses, automated responses, and escalation paths |

## Example Usage

Just ask Claude naturally:

- *"Send a WhatsApp message to +39123456789 saying their order is ready"*
- *"Show me all my active automations and how they're performing"*
- *"Create a marketing campaign with the birthday coupon template for my VIP list"*
- *"Sync these 50 new leads into my contacts and tag them as 'Trade Show 2026'"*
- *"Which templates are approved and ready to use?"*
- *"Pull my account report — how many messages this month?"*
- *"Set up a webhook to notify my CRM when a contact opts in"*
- *"List all open support tickets"*

## Available Tools (59)

### Contacts (6)
`list_contacts` · `get_contact` · `sync_contact` · `sync_contacts_bulk` · `update_contact` · `delete_contact`

### Automations (7)
`list_automations` · `get_automation` · `get_automation_steps` · `start_automation` · `update_automation` · `delete_automation` · `get_automation_analytics`

### Campaigns (5)
`list_campaigns` · `get_campaign` · `create_campaign` · `update_campaign` · `delete_campaign`

### Templates (4)
`list_templates` · `clone_template` · `submit_template` · `template_back_to_draft`

### Lists (8)
`list_lists` · `get_list` · `create_list` · `update_list` · `delete_list` · `sync_contacts_to_list` · `remove_contacts_from_list` · `remove_all_contacts_from_list`

### Tags (5)
`list_tags` · `get_tag` · `create_tag` · `update_tag` · `delete_tag`

### Media (3)
`list_media` · `get_media` · `delete_media`

### Webhooks (5)
`list_webhooks` · `get_webhook` · `create_webhook` · `update_webhook` · `delete_webhook`

### Tickets (2+)
`list_tickets` · `create_ticket` *(includes category and status management)*

### Custom Fields (5)
`list_custom_fields` · `get_custom_field` · `create_custom_field` · `update_custom_field` · `delete_custom_field`

### Reports & Accounts (4)
`list_reports` · `list_accounts` · `get_account_report` · `list_contact_lists`

### Groups (4)
`list_automation_groups` · `create_automation_group` · `list_template_groups` · `create_template_group`

### Messages (1)
`send_message`

## Supported Platforms

| Platform | Binary |
|----------|--------|
| macOS (Apple Silicon) | `spoki-mcp-darwin-arm64` |
| macOS (Intel) | `spoki-mcp-darwin-amd64` |
| Linux (x86_64) | `spoki-mcp-linux-amd64` |
| Linux (ARM64) | `spoki-mcp-linux-arm64` |
| Windows (x86_64) | `spoki-mcp-windows-amd64.exe` |

## Troubleshooting

### "No binary found for OS/ARCH"
Your platform may not have a pre-built binary. Install [Go 1.23+](https://go.dev/dl/) and the plugin will auto-build from source via the `scripts/build.sh` fallback.

### "Authentication credentials were not provided"
Your API key is invalid or expired. Generate a new one at [app.spoki.it](https://app.spoki.it) → Settings → Developers → API Keys.

### Plugin not responding
1. Check your internet connection
2. Verify `https://app.spoki.it` is reachable
3. Reinstall the plugin: `/plugin uninstall spoki` then `/plugin install spoki`

## Links

- **Spoki Platform**: [spoki.com](https://spoki.com)
- **Spoki App**: [app.spoki.it](https://app.spoki.it)
- **Source Code**: [Spoki-App/spoki-mcp](https://github.com/Spoki-App/spoki-mcp) (Go MCP server)
- **Support**: support@spoki.it

## License

MIT

spoki

About

Details

README

More