Third-party integrations & connectors

Configuration · Third-party integrations & connectors

The per-centre connector settings: Connectif (marketing automation API URL and key), cinema listings (theatre API and id, app/web channels), blog URL, cashback (admin, client and store-transaction URLs), Tally and custom forms, PAC Virtual receipt capture with Neodoc or Neuro OCR, email validation, footfall, and the operator app for the play centre.

Area	Configuration
Routes	configuration.centers.new · configuration.centers.edit
Centre modules	app_operator · blog · cashback · connectif · email_validation · form_commerces · forms · movies · tally
Staff levels	root · admin · manager · scmanager
Models	app-module-custom-forms · app-module-email-validation · app-module-pacv · app-module-tally · module-app-operator · module-blog · module-cashback · module-connectif · module-footfall · module-movies
UI label	configuration.center.modules
Coverage	4 use cases · 1 happy · 3 failure

How it works

Each connector is a module toggle plus parameters, validated with the pattern ‘enabled AND value missing/invalid’. PAC Virtual (‘PACV’) is the receipt-upload channel: it has an application key, an automatic-validation switch, a ticket-notification option, a read-name option and an OCR provider; enabling Neodoc OCR makes its token mandatory (configuration.center.neodoc-ocr.token). onChangeEnablePacv / onChangeEnableAppPacv keep the CRM and app sides consistent. The operator app has its own sub-modules (enums/modules-app-operator), currently the play centre. Search modules (store-search, staff-search, category-search) are also toggled here.

Use cases

Why someone opens this (4)

• Sending customer events to Connectif for marketing automation.
• Showing cinema listings in the app from the theatre’s API.
• Letting customers upload receipts via PAC Virtual with OCR so moderators only check exceptions.
• Enabling a cashback programme with separate admin and client portals.

Path map

flowchart LR
    F(["Third-party integrations and connectors"]):::feat
    F --> H1["PAC Virtual with OCR"]:::ok
    F -.-> X1["OCR enabled without token"]:::bad
    F -.-> X2["Integration URL malformed"]:::bad
    F -.-> X3["Wrong API key"]:::bad
    classDef feat fill:#566066,stroke:#566066,color:#ffffff,font-weight:bold
    classDef ok fill:#e3f1ea,stroke:#0d6b42,color:#0d4a2e
    classDef bad fill:#f7e6e2,stroke:#9a2d1c,color:#6e1f13

Happy paths

PAC Virtual with OCR

1. Admin enables PACV on the CRM side, which reveals the app PACV section.
2. Sets the application key, enables Neodoc OCR and pastes its token.
3. Optionally enables automatic validation.
4. Saves; uploaded receipts are read by OCR and land in the receipt queue already parsed.

Failure paths

OCR enabled without token

Cause — Neodoc OCR on, token empty.

What happens — required + configuration.center.neodoc-ocr.token.

Integration URL malformed

Cause — Cashback, Tally, custom forms or chatbase URL fails the regex.

What happens — Per-integration message (configuration.center.cashback-url.error, .tally-url.error, …).

Wrong API key

Cause — Connectif or theatre API credentials incorrect.

What happens — Not tested at save time; failures surface only in the downstream system.

QA checklist

Tick these off while regression-testing this feature. The boxes are plain Markdown, so progress is visible in git diffs.

• ✅ PAC Virtual with OCR
• ⛔ OCR enabled without token
• ⛔ Integration URL malformed
• ⛔ Wrong API key

Implementation

• app/templates/configuration/centers/new.hbs
• app/models/center.js
• app/models/module-connectif.js
• app/models/module-movies.js
• app/models/module-blog.js
• app/models/module-cashback.js
• app/models/module-footfall.js
• app/models/app-module-tally.js
• app/models/app-module-custom-forms.js
• app/models/app-module-pacv.js
• app/models/app-module-email-validation.js
• app/models/module-app-operator.js
• app/models/module-app-operator-playcenter.js
• app/serializers/module-neodoc-ocr.js

Translation keys (28)

Key	English
configuration.center.modules	Modules
configuration.center.connectif	Connectif
configuration.center.connectif.api-url	URL
configuration.center.connectif.api-key	APIKEY
configuration.center.theaters	Theaters
configuration.center.theaters.api-url	API URL
configuration.center.theaters.theater-id	Theater ID
configuration.center.blog	Blog
configuration.center.blog.url	URL
configuration.center.cashback	Cashback
configuration.center.cashback.admin	Admin Store Cashback
configuration.center.cashback.client	Customer Cashback
configuration.center.cashback.store-transactions	Cashback Store transactions
configuration.center.crm.pacv	PAC Virtual
configuration.center.crm.pacv.applicationKey	Application key
configuration.center.crm.pacv.hasAutomaticValidation	Automatic validation
configuration.center.neodoc-ocr	Neodoc OCR
configuration.center.neodoc-ocr.token	Token
configuration.center.neuro-ocr	Neuromobile OCR
configuration.center.ticket-notification	Notify user of ticket status
configuration.center.tally	Interest form
configuration.center.crm.custom-forms	Custom forms
configuration.center.email-validation	Email validation
configuration.center.footfall	Footfall
configuration.center.operator-app	App operator
configuration.modules.store-search	Search store
configuration.modules.staff-search	Search staff
configuration.modules.category-search	Search category

Related

• Same area — Centre list & export · Centre editor (modules, app config, integrations) · Staff member list, deletion & restore · Staff member editor (levels, scope, API token) · Channels · Extra attributes · Email template preview & test send · Dashboard configuration · Influence zones · Server incidents · Server command runner (CLI) · Accessibility statement · Mobile app configuration · Customer login methods (Google, Facebook) · Social wifi & location services

---

Generated from doc/feature-inventory.json · id config-integrations · commit 276788ca6