NetBaseOS Leads

Description

NetBaseOS is a contact and lead management service for independent sales partners (https://netbaseos.de). This plugin connects your WordPress site to your NetBaseOS account:

  • Forms to leads: Submissions of selected Contact Form 7 or WPForms forms are created as leads in your NetBaseOS account – with the form name and page as origin. You choose per form which field fills which lead field (first name, last name, full name, email, phone, message). Fields without a mapping are never transmitted.
  • Retries on outages: If NetBaseOS cannot be reached, submissions are kept on your site for a limited time and retried automatically (see FAQ). A submission that is retried is created only once.
  • Embed funnels: The block “NetBaseOS Funnel” or the shortcode [netbaseos funnel="your-funnel"] shows a NetBaseOS funnel in your page – or, with display="popup", a button that opens it in a dialog. A link to #netbaseos-your-funnel (e.g. a menu item) opens the dialog as well.

The lead connection requires a NetBaseOS account with the Premium plan (or higher) and an API key, which you create in NetBaseOS under Settings › Integrations. Embedding funnels requires a NetBaseOS account with a published funnel; no API key is needed for that.

The API key can only create leads in your account. It cannot read any data.

External services

This plugin connects to NetBaseOS (https://netbaseos.de), operated by Justin Tückmantel, Am Stationsgarten 43, 42327 Wuppertal, Germany.

  1. Lead API – only after you have saved an API key on the settings page and switched on at least one form:
    • When a visitor submits a switched-on form, your web server sends the mapped fields (first/last/full name, email, phone, message – only those you mapped), the form name, the address of the page the form was submitted on (scheme, domain and path only – query string and fragment are removed before sending), a random submission ID and the source marker wordpress to https://netbaseos.de/api/v1/leads, together with your API key. NetBaseOS keeps only the domain and path of the page address, stores the submission ID only as a derived check value (so a retried submission is created once) and discards fields it does not support. If the first attempt fails, the same data is sent again from the queue (see FAQ).
    • When you save a key or click “Test connection”, the plugin calls https://netbaseos.de/api/v1/verbindung with your key to check it. No visitor data is sent.
    • Like every request made by WordPress, these requests reveal your server’s IP address and WordPress’s standard user agent, which contains your site’s address.
  2. Funnel embedding – only on pages where you placed the block or shortcode: the visitor’s browser loads the funnel from https://netbaseos.de/f/<your-funnel> in an iframe and thereby transmits technically necessary data such as the visitor’s IP address and browser information to NetBaseOS. With the popup display, the iframe is only loaded when the visitor opens the dialog. What the funnel collects is described in the privacy notice linked inside the funnel.

The plugin sends no other data to NetBaseOS or to anyone else – no usage statistics or tracking.

Terms of use: https://netbaseos.de/terms
Privacy policy: https://netbaseos.de/privacy
Data processing agreement and sub-processors: https://netbaseos.de/avv

NetBaseOS processes the transmitted form data as your processor (Art. 28 GDPR) under the data processing agreement you accept when you create the API key. You remain the controller for your website and its forms and are responsible for informing your visitors. A non-binding suggested text is added to the WordPress privacy policy guide (Settings › Privacy); check and adapt it before use – it does not replace legal advice.

Blocks

This plugin provides 1 block.

  • NetBaseOS Funnel Embeds a NetBaseOS funnel, in the page or as a button that opens it in a dialog.

Installation

  1. Upload the plugin folder to /wp-content/plugins/ or install the ZIP via Plugins › Add New › Upload Plugin, then activate it.
  2. In NetBaseOS, go to Settings › Integrations › “Connection for your own forms” and create an API key.
  3. In WordPress, go to Settings › NetBaseOS Leads, paste the key and save.
  4. Switch on the forms that should create leads, check the field mapping and save.

To embed a funnel, add the block “NetBaseOS Funnel” and enter the funnel name (the last part of its address, e.g. my-funnel for netbaseos.de/f/my-funnel).

FAQ

Which form plugins are supported?

Contact Form 7 and WPForms (Lite and Pro).

What happens if NetBaseOS is not reachable?

The submission is kept in a queue in your site’s database (table {prefix}netbaseos_leads_queue) and retried with increasing pauses (5 minutes, growing to at most 6 hours), up to 12 attempts in total. On a site with regular visits that is about a day and a half; WP-Cron only runs when your site is visited, so it can take longer – but no submission waits longer than 3 days; older ones are deleted. The queue also holds at most 500 submissions; further ones are not stored while it is full. Delivered submissions are deleted from the queue immediately; after the last attempt, or if NetBaseOS rejects the data, the submission is deleted without being delivered. Your form plugin’s own email notification is not affected.

While a submission waits, its mapped contact data is stored on your site. That is processing by you as the site operator, not by NetBaseOS – include it in your own documentation (e.g. your record of processing activities) where required. If you deactivate the plugin, waiting submissions are no longer sent but stay in the table until you delete the plugin; deleting the plugin removes the table and all settings.

Can I send health data?

No. Do not ask for health data or other special categories of personal data (Art. 9 GDPR) in forms you connect to NetBaseOS.

Does the plugin add a “powered by” link?

No.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“NetBaseOS Leads” is open source software. The following people have contributed to this plugin.

Contributors

Translate “NetBaseOS Leads” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

0.1.1

  • Translations are now delivered through translate.wordpress.org; bundled language files removed.

0.1.0

  • First version: Contact Form 7 and WPForms to NetBaseOS leads, funnel block and shortcode.