n8n-nodes-kwikchat

n8n community node for kwikCHAT — send WhatsApp templates, manage contacts, and interject into live conversations from n8n workflows.

Installation

In n8n: Settings → Community Nodes → Install, and enter n8n-nodes-kwikchat.

Credentials

You'll need an API key from your kwikCHAT account:

1. Log in to kwikCHAT and go to Settings → API Keys.
2. Click New API Key, name it (e.g. "n8n"), and copy the key shown — it's only displayed once.
3. In n8n, create a KwikChat API credential using that key and your kwikCHAT API base URL.

Important: the API base URL is not the web app URL you log in to — it's wherever the backend itself is hosted, which may be a path prefix on the same domain (e.g. https://app.kwikchat.co.za/api) or a separate subdomain, depending on how your instance is deployed. If you're not sure, check your kwikCHAT API docs URL — it'll look like https://<your-domain>/api/v1/docs — and use everything before /v1/docs as the Base URL. Pointing this at the web app by mistake will return the app's HTML instead of API data.

Supported operations

• Channel: List, Get
• Contact: List, Get, Create, Update
• Conversation: List, Get, Get by Contact, Interject (send a manual message into an active conversation)
• Template: List, Send Template, Send Test Message
• Flow: List, Get

Example workflows

• Send an order-confirmation WhatsApp template when a new order comes in (Template → Send Template).
• Create a kwikCHAT contact when a form is submitted elsewhere (Contact → Create).
• Have a human agent step into an automated conversation from another system (Conversation → Interject).

Development

This node's operation list is generated from kwikCHAT's OpenAPI schema via a curated resource map — see codegen/resource-map.ts and codegen/generate-n8n-node.ts. Re-run npm run codegen after updating codegen/openapi.snapshot.json from a running kwikCHAT backend, then npm run build.

License

MIT