n8n-nodes-kwikchat
v0.1.2
Published
n8n community node for kwikCHAT — send WhatsApp templates, manage contacts, and interject into conversations from n8n workflows.
Maintainers
Keywords
Readme
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:
- Log in to kwikCHAT and go to Settings → API Keys.
- Click New API Key, name it (e.g. "n8n"), and copy the key shown — it's only displayed once.
- 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
