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, manage contacts and conversations, and publish social content 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 |
| Social Post | Publish, Get Publishing Targets, 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}})
“AI content + image → LinkedIn + Instagram + Facebook”
- Use an AI node to generate the caption.
- Use an image-generation or download node to produce an image URL or binary image.
- Tenreply → Social Post → Publish.
- Select the connected profiles/pages, map the caption, and choose Image URL or Binary Image to match the previous node’s output.
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.