# tawk-to-api-wasp-drone

tawk-to-api-wasp-drone — a subagent for tawk.to REST API calls: API key or OAuth2 auth, work with chats, tickets, knowledge base, and webhooks.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/growth-and-customer-tools/agents/tawk-to-api-wasp-drone.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/tawk-to-api-wasp-drone

## What it does

The subagent loads the `tawk-to-api-stinger` skill and calls `api.tawk.to/v1` for Property, Widgets, Members, Chats, Tickets, Tabs, Metrics, Contacts, and Knowledge-Base operations. It picks Basic Auth for server scripts and OAuth2 for apps acting on behalf of a user. Before any resource call, it resolves `propertyId` via `property.list`; for knowledge base operations, it also fetches `siteId` from `knowledge-base.site.list`.

tawk.to's knowledge base accepts an ordered array of typed blocks (header, paragraph, image, code, video, divider, table), not raw markdown. Image and banner blocks need a URL: the subagent uploads files to Cloudflare R2 or DigitalOcean Spaces first, then inserts the public link into the block. Articles are published as `draft`, verified in the dashboard, then flipped to `published` via `knowledge-base.article.update`. The API lacks idempotency keys: retriable writes go through `update`, not `create`.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install growth-and-customer-tools@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/agents/tawk-to-api-wasp-drone.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/tawk-to-api-wasp-drone.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/tawk-to-api-wasp-drone.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/growth-and-customer-tools/agents/tawk-to-api-wasp-drone.md

## When to use it
- integrate tawk.to REST API into an app
- create a knowledge base article from content blocks
- sync markdown files into tawk.to knowledge base with hosted images
- set up tawk.to webhooks in both directions
- fetch chat, ticket, and metrics data via API

## Example prompts
- Integrate tawk.to API with Basic Auth, fetch chats for `propertyId`
- Build a knowledge base article from `docs/faq.md`, upload images to R2
- Set up a tawk.to webhook at `/webhook/tawk`, verify the signature

## Similar
- [typespec-create-api-plugin](https://affpapa.org/en/nevibecode/skills/typespec-create-api-plugin.md) — skill · 8700 installs
- [docyrus-api-dev](https://affpapa.org/en/nevibecode/skills/docyrus-api-dev.md) — skill · 900 installs
- [x-api-integration](https://affpapa.org/en/nevibecode/agents/x-api-integration.md) — subagent · ★ 26718 repo stars
- [api-integration-surface-strategy](https://affpapa.org/en/nevibecode/skills/api-integration-surface-strategy.md) — skill · 10400 installs
- [api-documentation](https://affpapa.org/en/nevibecode/skills/api-documentation.md) — skill · 385 installs
- [Moderation API](https://affpapa.org/en/nevibecode/mcp/moderation-api.md) — MCP server

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
