Integrations¶
Catalog of external systems CloudXM integrates with. Each entry lists the product(s) that use it and where the credentials live.
| Integration | What it is | Used by | Credentials in |
|---|---|---|---|
| Vendure | Headless commerce backend | SupraMax | VPS .env (GitLab CI vars) |
| Chatwoot | Customer support platform (self-hosted) | SupraMax site, CloudXM support | VPS .env, Cloudflare Pages env vars |
| Marlim | Payment gateway (Brazil) | WooCommerce plugins, Pay | GitLab CI vars (masked) |
| EnvioZ | Shipping & tracking | SupraMax, woo-envioz | GitLab CI vars (masked) |
| iDrive e2 | S3-compatible object storage | Convert | GitLab CI vars (CONVERT_*_S3_*) |
| LiteLLM | LLM proxy / model routing | Convert | VPS .env (GitLab CI vars) |
| Google Workspace | Identity provider (SSO) | This wiki (Cloudflare Access), e-mail | Google Cloud Console (OAuth client) |
| Meta Pixel | Analytics proxy (privacy-first) | CloudXM site | Cloudflare Pages env vars |
| Composer (Satis) | Private PHP package repo | WordPress plugins | packages.cloudxm.com.br |
Adding a new integration¶
- Add it to the table above (this page is the catalog — keep it current).
- Create the integration page/section with: purpose, auth model, env vars, owners.
- Store credentials only in secret stores (GitLab CI variables, Cloudflare dashboard secrets, vault) — never in the wiki.
Marlim¶
Payment gateway integration used by the WooCommerce plugin suite (and Pay).
- [TODO: endpoint/API doc reference, webhook flow, sandbox keys process]
- Reference:
marlim-api-v3skill (CloudXM internal).
EnvioZ¶
Shipping and order tracking.
- [TODO: API reference, webhook events, label flow]
- Used by SupraMax storefront (
rastreiopage) andwoo-envioz.
Chatwoot¶
Self-hosted support platform running on VPS prd1 (Docker).
- Production port
3100, staging13100; admin viachatwoot.supramax.log.br. - Webhooks from SupraMax storefront (Cloudflare Pages Functions) upsert contacts and conversations.