n8n — Getting Started
The Tenreply node is published on npm as @pyalm/n8n-nodes-tenreply.
Install the Tenreply community node
- Open your n8n instance and go to Settings → Community Nodes.
- Click Install and enter the package name:
@pyalm/n8n-nodes-tenreply. - Click Install and restart n8n when prompted.
Connect your Tenreply account
- Enable Developer Mode in Tenreply: Settings → Features → Developer Mode.
- Create an API key: Settings → Developer → Create API key. Copy the
trl_live_...key — it is shown only once. - In n8n, open any Tenreply node and click Create new credential.
- Enter your Base URL (
https://app.tenreply.com/apifor cloud; your self-hosted URL otherwise) and paste the API key. - Click Save and test — n8n verifies the key against the Tenreply API.
Available nodes
Tenreply (action node)
Send messages and manage contacts and conversations from any n8n workflow.
| Resource | Operations |
|---|---|
| Message | Send Message, Send Template, Get Messages |
| Contact | Create, Update, Get, Get Many, Delete |
| Conversation | Start, Close, Reopen, Get, Get Many |
| Template | Get Many |
Tenreply Trigger
Start a workflow when a Tenreply event occurs. Select from all 10 supported events:
| Event | Description |
|---|---|
message.received | Customer sent a new message |
message.sent | Agent or automation sent a message |
message.delivered | Message delivered to the customer |
message.read | Customer read a message |
message.failed | Message delivery failed |
conversation.created | New conversation started |
conversation.status_changed | Conversation opened, closed, or pending |
contact.created | New contact added |
contact.updated | Contact record updated |
broadcast.completed | Broadcast finished sending |
Example workflow
“New inbound message → AI reply → send response”
- Tenreply Trigger → event:
message.received - OpenAI → generate reply from
{{$json.content.text}} - Tenreply → Send Message (conversationId:
{{$json.conversationId}}, type: text, text:{{$json.text}})
Webhook security
The Tenreply Trigger node automatically registers and deregisters webhooks with Tenreply when you activate or deactivate a workflow. Each webhook is signed with HMAC-SHA256; the node verifies the X-Tenreply-Signature header by default. You can disable verification in the node’s Options panel if needed.