KlickTipp Integration in Node-RED

Node-RED is a powerful open-source platform originally developed by IBM and today offers a versatile solution for workflow automation. Today, Node-RED offers a flexible solution that allows you to automate your workflows individually. It connects seamlessly with KlickTipp and over 6,000 other software tools. Thanks to the intuitive drag-and-drop interface, you can easily create even complex automations. If you are tech-savvy, you also have maximum flexibility to expand and customize your workflows.

Since Node-RED has an open architecture, you can run it on your own server for free. This gives you full control over your automations and data. If you are technically adept, Node-RED offers you a major advantage. You can set it up exactly according to your needs, customize it and manage your infrastructure independently - without any external dependencies. You have full control at all times and can carry out an unlimited number of transactions. At the same time, you remain flexible and can scale your automations as required.

Node-RED is comparable to Zapier on your own server, with the important difference that you can manage the entire infrastructure yourself.

Advantages of Node-RED Integration

  • Maximum flexibility and control: Node-RED gives tech-savvy users complete control to create complex automations that are tailored to their needs. You can define triggers and actions and extend the platform at any time.
  • Simple, visual workflow creation: With the user-friendly drag-and-drop interface, you can intuitively put together automations and test them immediately - without any in-depth programming knowledge.
  • Unlimited integrations: Node-RED connects to over 6,000 software tools, allowing you to extend your automations beyond KlickTipp and seamlessly integrate with your entire infrastructure.
  • Data protection and complete control: By using Node-RED on your own server, you retain control over your data and infrastructure. This ensures maximum security and protects against unwanted access by third parties.
  • Free and scalable: As an open source tool, you can operate Node-RED free of charge and scale it as you wish without additional license fees or financial burdens. It is suitable for both small and large automation projects.

Step-by-Step Instructions

Prerequisites

  • KlickTipp account with API access: Check if you are using a Premium plan or higher to get access to the API.
  • Node-RED installation: Make sure that Node-RED and the KlickTipp node are installed and ready to use.
  • Take a look at our article on how to set up Node-RED using elestio as an example. Alternatively, you can also host your own server with Node-RED.
  • How to install the KlickTipp Community Node.

Connect KlickTipp with Node-RED

  • Open Node-RED and install the KlickTipp Node package via the Palette Manager.
  • Create a new flow and add a KlickTipp node.
  • Double-click on the KlickTipp node and click on the → + icon next to → KlickTipp Config.
  • Enter your username and password for KlickTipp in the node configuration. Click on → Add  and then on → Done  to complete the setup.
  • Test the connection by adding an → Inject Node  (you can find it in the bar on the left under → General) and connecting it to the KlickTipp node. Then click on → Deploy  and on the Inject Node to send a sample request. Below the KlickTipp node, you will see feedback on whether the request was successful.

Exemplary Automations

Create KlickTipp Triggers

Create flow

  • Create a new flow in Node-RED.
  • Drag and drop the KlickTipp → Watch New Events  node into the editor window and place it as the first node.
  • Open the node with a double-click and give it a name via → Name. Then select your access data under → KlickTipp Config .
  • Finally, copy the URL of the webhook to your clipboard.

Important to Know:

The webhook links from Node-RED are not publicly accessible from the Internet. If you install the service via Elestio, you can set up the authentication so that the URL is extended with parameters, as in the following example:

→ https://username:password@node-red-xxx-xxx.vm.elestio.app/klicktipp-webhook/{unique-id}

In this example, the user name and password are transmitted in the URL without encoding, which represents a security risk that should not exist in productive operation. These instructions are for testing purposes only. To close the security gap, you should implement your own security solutions.

Add Debug Node

  • Add a debug node at the end of the flow to check the return values of KlickTipp.

Set up Webhook in KlickTipp

  • Create a new outbound in KlickTipp.
  • Give the outbound a name.
  • Select an activation tag, for example → Smartlink clicked,  and select the appropriate KlickTipp element from the drop-down menu.
  • Paste the activation link from your clipboard (this was previously copied in the Node-RED KlickTipp Node and, if necessary, adjusted according to the note).
  • Click on → Create outbound  to create the outbound.

Test Workflow

  • Click on → Save and test  in outbound.
  • Then check the debug node in Node-RED. It should now display the transferred payload from the outbound.

Create KlickTipp Action

Create Flow

  • Create a new flow in Node-RED.
  • Drag and drop an Inject node into the editor window and place it as the first node.
  • Open the inject node with a double-click and enter → payload.email  under → msg  within the node. Next to it, enter the email address of an existing example contact in KlickTipp.

Insert and configure KlickTipp node

  • Add the KlickTipp node → Subscriber Tag  and open it with a double click to select a suitable tag from your KlickTipp account.
  • Connect the KlickTipp node to the Inject node.

Add debug node

  • Add a debug node at the end of the flow to check the return values of KlickTipp.

Test workflow

  • Click on the Inject node so that the defined email address is transferred to the KlickTipp node and the contact is marked with the appropriate tag.
  • The debug node should display → { success: true }  and the contact in KlickTipp should have received the matching tag.

KlickTipp Modules in Node-RED

Available Triggers

  • Watch New Events: This function monitors a webhook that you create in Node-RED and reach via an outbound in KlickTipp. This allows you to use triggers for every update of a contact, whether manual tags or smart tags such as → email received, opened, clicked,  registration form entry or click on a smart link.
  • Campaign (Marketing Cockpit) started
  • Campaign (Marketing Cockpit) ended
  • E-mail (Marketing Cockpit) received
  • E-mail (Marketing Cockpit) opened
  • E-mail (Marketing Cockpit) clicked
  • Email (marketing cockpit) viewed in browser
  • Newsletter / follow-up e-mail received
  • Newsletter / follow-up e-mail opened
  • Newsletter / follow-up e-mail clicked
  • Newsletter / follow-up e-mail viewed in browser
  • SMS (Marketing Cockpit) received
  • SMS (Marketing Cockpit) clicked
  • Smart link
  • Tagging pixel triggered
  • Conversion pixel triggered
  • Outbound triggered
  • Kajabi membership activated
  • Kajabi membership deactivated
  • Referral program
  • Entered via registration form
  • Registered via Facebook button
  • Registered via SMS registration
  • Registered via API key
  • Entered via Business Card Reader Pro (obsolete)
  • Entered via KlickTipp Business Card Reader Event
  • Entered via entry by e-mail
  • DigiStore24 Affiliate
  • Entered via landing page

Available Actions

Contact

  • Add or Update Contact: Creates a new contact. If a contact with the same e-mail already exists, it will be updated.
  • Update Contact: Updates a contact.
  • Delete Contact: Deletes a contact.
  • Unsubscribe Contact: Unsubscribes a contact and prevents further communication.
  • Get Contact: Returns the complete data of a contact.
  • Get Contact ID: Returns the contact ID for the requested e-mail address.
  • List Contacts: Lists the IDs of all active contacts.
  • List Tagged Contacts: Lists the IDs and tagging times of all tagged contacts.

Contact Tagging

  • Tag Contact: Links a contact with one or more tags.
  • Untag Contact: Removes a tag from a contact.

Tags

  • Create Tag: Creates a new manual tag.
  • Update Tag: Updates a tag.
  • Delete Tag: De letes a tag.
  • Get Tag: Returns the name and description of a tag.
  • List Tags: Lists the IDs and names of all tags.

Opt-In Process

  • Get Opt-in Process: Returns the complete data of an opt-in process.
  • List Opt-in Processes: Lists the IDs and names of all opt-in processes.
  • Get Redirect URL: Returns the redirect URL for a specific opt-in process.

Data Fields

  • Get Data Field: Returns the ID and name of a specific data field.
  • List Data Fields: L ists the IDs and names of all data fields.

Troubleshooting

Common Problems and Solutions

  • Access invalid
    • Message → Login request failed: Request failed with status code 401
    • Check whether your API access is active and whether the user name and password have been entered correctly.
  • Missing input e.g. e-mail address
    • Message → Missing email:invalid input
    • Check whether all mandatory fields are filled in, especially the email address.

Further Resources

Node-REDNode-RED Community & Forums

Set up n8n and Node-RED with elestio

Install KlickTipp Node-RED Community Node

The combination of KlickTipp and Node-RED offers an easy way to efficiently automate marketing workflows. With the steps described, you can create custom flows to optimize email marketing processes and simplify contact management.

Did this post help you?

Back to overview: Automated Workflows & Organization

Related Posts: