Description
TGP 360 connects your WordPress website to your TGP 360 workspace.
Lead capture
- The plugin’s own form — add
[tgp360_form]to any page or post (name, email, phone, optional company, message and an optional consent box). - Contact Form 7 — submissions that Contact Form 7 accepts (after its own validation and spam checks) are sent too.
- MetForm — new submissions of the MetForm forms you tick, after MetForm accepted and stored them. MetForm keeps its own entries, e-mails and integrations; entries it stored before are never imported.
- Submissions are sent from your website’s server to TGP 360 (never from the visitor’s browser), with the source “website” and a form name starting with “WordPress”, so they are easy to recognise in the Lead Center.
- Each submission has its own idempotency key: a retry never creates a second lead.
- If TGP 360 cannot be reached, the visitor still sees “sent” and the submission is retried automatically (after 5 minutes, 30 minutes, 2 hours, 6 hours and 12 hours), then given up.
- A “Recent deliveries” log on the settings screen shows what happened to the last 50 submissions — without any personal data.
WooCommerce (optional, off by default)
- Synchronises this store’s products (with variations, prices and stock), customers and orders (with their items, payment and refund status) with the Commerce app of your TGP 360 workspace, so your team sees a customer’s orders beside their conversations.
- An initial import sends what the store already has, in the background and in small steps; it continues where it stopped after a timeout, and nothing is ever duplicated. After that, new and changed products, customers and orders are sent within moments.
- WooCommerce stays the owner of its products, prices, stock, payments and refunds. An order is shown as paid only when WooCommerce recorded a payment, and never as delivered unless a shipment record says so.
- Optionally — only if you allow it — your team can set an order’s status (On hold, Processing, Completed, Cancelled) from TGP 360. Your website asks TGP 360 for such changes; TGP 360 never connects to your website. A change is refused when the order has changed in the store since.
- Works with High-Performance Order Storage (HPOS) and with the legacy order storage. If WooCommerce is not active, this part of the plugin does nothing at all.
Website chat
- Shows your TGP 360 AI agent’s chat on every page of the website. You only enter the agent’s public ID; no key or password is ever put in your pages.
Security
- The workspace API key is stored on your website only, is never shown again after saving (only “tgp_…” and its last 4 characters), and is never sent to visitors’ browsers. For extra safety you can define it in wp-config.php instead.
- Only administrators can see or change the settings.
External services
This plugin connects your website to TGP 360, a customer-communication and lead-management service run by The Growth Pillars (https://www.tgp360.com). It does nothing until an administrator enters a TGP 360 API key in Settings → TGP 360, and it only uses the TGP 360 address shown there (normally https://www.tgp360.com).
- Lead submission — when a visitor submits a form the administrator turned on (the plugin’s
[tgp360_form], a Contact Form 7 form or a ticked MetForm form), the website’s server sends the submission toPOST <TGP 360 address>/api/v1/leads: the details the visitor typed (name, email, phone, company, country, message and the form’s other answers — never files, passwords, payment, captcha or hidden fields), the form’s name, the page address, the referring page, campaign parameters (utm_source, utm_medium, utm_campaign, utm_term, utm_content) and, when the consent box is used, its text and the time. The API key is sent in the request’s Authorization header. Failed sends are retried for about a day. - Test connection — when the administrator clicks Test connection, the website’s server calls
GET <TGP 360 address>/api/v1/mewith the API key, to learn which workspace the key belongs to. No visitor data is sent. - WooCommerce synchronisation — only when WooCommerce is active AND the administrator turns Synchronise this WooCommerce store with TGP 360 on: the website’s server sends to
POST <TGP 360 address>/api/v1/commerce/storesthe store’s name, address, currency and the WooCommerce and plugin versions; toPOST <TGP 360 address>/api/v1/commerce/syncthe store’s products (name, SKU, description, prices, stock, categories, image addresses, variations), customers (name, email address, phone number, company, city, country) and orders (number, status, amounts, payment method and transaction reference, the customer’s name, email address, phone number and delivery address, the items, refunds and the customer’s note); and, only if the administrator allowed order status changes, asksGET <TGP 360 address>/api/v1/commerce/commandsfor them and reports the outcome toPOST <TGP 360 address>/api/v1/commerce/commands/ack. Disconnecting callsPOST <TGP 360 address>/api/v1/commerce/stores/disconnect. No card number or other payment credential is ever read or sent. - Website chat — only when the administrator turns Show the TGP 360 chat on: every page loads the chat script from
<TGP 360 address>/widget/v1.jsin the visitor’s browser, which then talks to TGP 360 to show the AI agent’s chat. The chat keeps an anonymous session identifier in the visitor’s browser, and what the visitor writes in the chat is sent to TGP 360.
TGP 360 terms: https://www.tgp360.com/terms — privacy policy: https://www.tgp360.com/privacy-policy
Privacy
Form submissions (the details the visitor typed, the page address and campaign parameters) are sent to TGP 360. A submission waits on this website only while it is being retried (about one day at most). The plugin adds suggested text to Settings → Privacy → Policy Guide. The website chat is provided by TGP 360 and keeps an anonymous session identifier in the visitor’s browser.
If the WooCommerce integration is turned on, the store’s customers and orders (names, contact details, delivery addresses, what was ordered and its payment status) are sent to TGP 360 as described under “External services”; only the ids of what is still to be sent are kept on this website.
Installation
You need a TGP 360 workspace (https://www.tgp360.com) whose plan includes the Developer API and the Lead Center, and its Owner to create the API key.
- Install the plugin:
- from WordPress: Plugins → Add New Plugin, search for TGP 360, click Install Now (once the plugin is listed in the WordPress.org directory); or
- from a ZIP: download it in TGP 360 (Integrations → Available → WordPress, or Workspace Settings → Developer), then in WordPress go to Plugins → Add New Plugin → Upload Plugin, choose the ZIP and click Install Now.
- Click Activate.
- In TGP 360, open Workspace Settings → Developer.
- Create an API key with only the leads:write permission. Copy it — it is shown once.
- In WordPress, go to Settings → TGP 360, paste the API key and save. The key is never part of the plugin’s files: it is stored on your website only. For extra safety you can define it in wp-config.php instead:
define( 'TGP360_API_KEY', 'tgp_…' ); - Click Test connection: the status should become Connected. Set the Default country (for example JO) if visitors may type phone numbers without the +country code.
- Turn on the form sources: add
[tgp360_form]to a page, and/or turn on Contact Form 7, and/or turn on MetForm and tick the MetForm forms to send (none is ticked until you do). - Submit one form on your website and check that the lead appears in TGP 360’s Lead Center (and in Settings → TGP 360 → Recent deliveries).
WooCommerce (optional): create an API key with the commerce:sync permission (add leads:write to the same key if this website also sends forms), save it, then in Settings → TGP 360 → WooCommerce turn on Synchronise this WooCommerce store with TGP 360, choose what to send and click Import now. The workspace’s plan must include Commerce and its Admin must have turned the Commerce app on.
Website chat (optional): if the TGP 360 chat is already on your website (added another way), leave Show the TGP 360 chat off — turning it on as well shows two chats. Otherwise, in TGP 360 → AI Agents → your agent → Widget settings, make sure the agent is active and its widget enabled, add your website’s hostname to Allowed domains (or leave the list empty), copy the agent ID (wa_…) into Agent ID and turn the chat on.
Updating: a newer version replaces the plugin’s files only. Your settings, the API key, the delivery log and the retry queue stay as they are — also when you move from a ZIP you installed by hand to updates from WordPress.org (the plugin folder, tgp-360, is the same).
FAQ
Does Test connection create a lead?
No. It only asks TGP 360 which workspace the key belongs to and what it may do. Because no lead is created, it cannot confirm that the Lead Center is turned on for the workspace — the first real submission does (see “Recent deliveries”).
What happens if TGP 360 is down?
The visitor’s form works as usual. The submission waits in a small queue on your website and is retried with the same idempotency key, so it is never recorded twice. After the last retry (about 21 hours) it is given up and deleted.
Is the consent box a marketing opt-in?
No. When the box is ticked, “Consent: Yes”, the box’s text and the time are sent as one of the form’s answers. TGP 360 does not record it as marketing consent. You can choose to send a submission only when the box is ticked.
Which Contact Form 7 fields are used?
Name, email, phone, company and country are found by field name (configurable; the defaults match Contact Form 7’s own your-name, your-email, …). Every other field of the form becomes an answer, except files, captcha and quiz fields and the consent field.
Which MetForm fields are used?
Name, email, phone, company and country are found by the field names above first, then by MetForm’s own field types (email, telephone, first / last name) and by field labels such as Name, Phone, Company or Country (also in Arabic, e.g. الاسم, رقم الجوال). Every other field becomes an answer under its label (choices as the option text the visitor saw). Files, passwords, signatures, payment and card fields, captcha and hidden fields are never sent — also when they have custom names. If MetForm’s field list for a form can’t be read, nothing is sent and “Recent deliveries” says so.
Will my existing MetForm entries be imported?
No. Only new submissions of the ticked forms are sent, from the moment you turn MetForm on. MetForm’s stored entries are never read.
Is MetForm’s newsletter opt-in a marketing opt-in in TGP 360?
No. It is recorded as its own “Newsletter opt-in” answer (Yes / No), separate from the consent answer, and never counts as consent. TGP 360 never sets marketing consent from a lead.
I already added the TGP 360 chat to my site another way
Leave Show the TGP 360 chat off (it is off by default); turning it on as well shows two chat widgets.
The chat does not appear
Check in TGP 360 that the agent is active, its widget is enabled, and your website’s hostname is in the widget’s Allowed domains (or the list is empty). Page-optimisation plugins that combine or delay scripts can also stop it: exclude widget/v1.js from them.
I installed the plugin from a ZIP. Will I get updates from WordPress.org?
Yes, once the plugin is listed there: WordPress matches plugins by their folder and main file (tgp-360/tgp-360.php), so a copy installed from a TGP 360 ZIP is updated from WordPress.org like any other plugin. Updating keeps your settings and API key. Don’t delete the plugin to update it — deleting removes its settings (see below).
Does the WooCommerce integration change my store?
No, unless you allow one thing. By default the plugin only reads your store (through WooCommerce’s own functions) and sends products, customers and orders to TGP 360. If you tick “Allow TGP 360 to change the status of orders in this store”, an order’s status can be set from TGP 360 — only On hold, Processing, Completed or Cancelled, and only if the order has not changed in the store meanwhile. Prices, stock, payments and refunds are never changed from TGP 360.
What does the WooCommerce integration store on my website?
Its settings, a short status (last synchronisation, counts, the last error code) and a small table listing WHICH products, customers and orders still have to be sent — their ids only, never their content. Each one is read fresh from WooCommerce at the moment it is sent.
What happens to the data in TGP 360 if I disconnect or delete the plugin?
Nothing. Disconnecting stops the synchronisation; products, customers and orders already in TGP 360 stay there until they are removed in TGP 360.
What is removed when I delete the plugin?
Only what the plugin stored on this website: its settings, the API key, its log, its retry queue and its scheduled task. Nothing is ever deleted in TGP 360: leads and contacts already there are not affected. Deactivating the plugin keeps the settings.
Changelog
1.2.0
- New: WooCommerce integration (optional, off by default, and inactive when WooCommerce is not installed). Synchronises products with variations, prices and stock, customers, and orders with their items, payment and refund status with the Commerce app of your TGP 360 workspace. Needs an API key with the commerce:sync permission.
- New: initial import of the store’s existing products, customers and orders, in the background, resumable, and without duplicates; a “Sync now” action and a status panel (last synchronisation, what is waiting, the last error).
- New: optional order status changes from TGP 360 (On hold, Processing, Completed, Cancelled), pulled by the website and refused when the order changed in the store meanwhile. Off by default.
- Compatible with WooCommerce High-Performance Order Storage (declared); orders are read only through WooCommerce’s own functions.
- Forms (the TGP 360 form, Contact Form 7, MetForm), the lead delivery, the retry queue and the website chat work exactly as in 1.1.2.
1.1.2
- Translations: the plugin no longer calls
load_plugin_textdomain(). WordPress loads its translations itself, and language packs from translate.wordpress.org take priority; the Arabic translation shipped with the plugin is used only when no language pack is installed for the site’s language. - Translations: the bundled Arabic loads again on WordPress 6.0 to 6.4. Since 1.1.0 its compiled file had a header those versions reject, so they showed English; WordPress 6.5 and later were not affected. The translations themselves are unchanged.
- MetForm: a redundant query argument flagged by Plugin Check was removed from the list of forms on the settings page. The same forms are listed.
1.1.1
- WordPress.org packaging: an “External services” section describing exactly what is sent to TGP 360 and when, with links to TGP 360’s terms and privacy policy; installation from the plugin directory or a TGP 360 ZIP; how updates keep settings and the API key. No change to how the plugin works.
1.1.0
- MetForm: new submissions of the forms you tick are sent to the TGP 360 Lead Center (MetForm’s
metform_after_store_form_datahook), with answers under their labels, consent and the newsletter opt-in kept apart, the same retries and duplicate protection. Off by default; no historical import. English and Arabic.
1.0.0
- First release: TGP 360 form, Contact Form 7, retry queue, recent-deliveries log, website chat, English and Arabic.