# webspecto/wp-sync-amocrm architecture

> Architecture diagram of the GitHub repository webspecto/wp-sync-amocrm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/webspecto/wp-sync-amocrm
- Repository: https://github.com/webspecto/wp-sync-amocrm

## Overview

This WordPress plugin syncs Contact Form 7 and WPForms submissions into AmoCRM/Kommo as contacts and leads, linking the records and adding a note. The runtime entry point dispatches WordPress hooks to the relevant connector; the admin screen configures form mappings and CRM settings, while a separate OAuth callback handles authorization. The README also documents WooCommerce and Elementor Forms in Pro, but the supplied excerpts do not establish their runtime wiring. Edges reflect only relationships visible in excerpts or documented in the README.

Main entry points: [`secret`](https://github.com/webspecto/wp-sync-amocrm/tree/master/secret) (Auth Files), [`inc/amocrm_wpcf7.php`](https://github.com/webspecto/wp-sync-amocrm/blob/master/inc/amocrm_wpcf7.php) (Contact Form 7 Sync), [`inc/amocrm_wpforms.php`](https://github.com/webspecto/wp-sync-amocrm/blob/master/inc/amocrm_wpforms.php) (WPForms Sync), [`wp-sync-amocrm.php`](https://github.com/webspecto/wp-sync-amocrm/blob/master/wp-sync-amocrm.php) (Plugin Bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["WordPress Runtime"]
  node_plugin["Plugin Bootstrap<br/>[wp-sync-amocrm.php]"]
end

subgraph group_setup["CRM Setup"]
  node_admin["Admin Settings<br/>[admin.php]"]
  node_oauth["OAuth Callback<br/>[oauth2-amocrm.php]"]
  node_authfiles[("Auth Files")]
end

subgraph group_sync["Form Synchronization"]
  node_cf7["Contact Form 7 Sync<br/>[amocrm_wpcf7.php]"]
  node_wpforms["WPForms Sync<br/>[amocrm_wpforms.php]"]
  node_pro["Pro Form Integrations<br/>[admin.php]"]
end

node_wordpress(("WordPress"))
node_crm{{"AmoCRM / Kommo"}}

node_wordpress -->|"loads plugin"| node_plugin
node_plugin -->|"loads admin"| node_admin
node_plugin -->|"dispatches submissions"| node_cf7
node_plugin -->|"dispatches submissions"| node_wpforms
node_wordpress -.->|"submits forms"| node_cf7
node_wordpress -.->|"submits forms"| node_wpforms
node_admin -->|"reads credentials"| node_authfiles
node_admin -->|"fetches CRM data"| node_crm
node_oauth -->|"saves token"| node_authfiles
node_oauth -->|"authorizes with"| node_crm
node_cf7 -->|"reads token"| node_authfiles
node_cf7 -->|"refreshes token"| node_authfiles
node_cf7 -->|"creates CRM records"| node_crm
node_wpforms -->|"reads token"| node_authfiles
node_wpforms -->|"refreshes token"| node_authfiles
node_wpforms -->|"creates CRM records"| node_crm
node_wordpress -.->|"supports Pro forms"| node_pro

click node_plugin "https://github.com/webspecto/wp-sync-amocrm/blob/master/wp-sync-amocrm.php"
click node_admin "https://github.com/webspecto/wp-sync-amocrm/blob/master/admin/admin.php"
click node_oauth "https://github.com/webspecto/wp-sync-amocrm/blob/master/oauth2-amocrm.php"
click node_authfiles "https://github.com/webspecto/wp-sync-amocrm/tree/master/secret"
click node_cf7 "https://github.com/webspecto/wp-sync-amocrm/blob/master/inc/amocrm_wpcf7.php"
click node_wpforms "https://github.com/webspecto/wp-sync-amocrm/blob/master/inc/amocrm_wpforms.php"
click node_pro "https://github.com/webspecto/wp-sync-amocrm/blob/master/admin/admin.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin toneBlue
class node_admin,node_oauth,node_authfiles toneAmber
class node_cf7,node_wpforms,node_pro toneMint
class node_wordpress,node_crm toneIndigo
```

## Components

### WordPress Runtime

- [Plugin Bootstrap](https://github.com/webspecto/wp-sync-amocrm/blob/master/wp-sync-amocrm.php): `wp-sync-amocrm.php`

### CRM Setup

- [Admin Settings](https://github.com/webspecto/wp-sync-amocrm/blob/master/admin/admin.php): `admin/admin.php`
- [OAuth Callback](https://github.com/webspecto/wp-sync-amocrm/blob/master/oauth2-amocrm.php): `oauth2-amocrm.php`
- [Auth Files](https://github.com/webspecto/wp-sync-amocrm/tree/master/secret): `secret`

### Form Synchronization

- [Contact Form 7 Sync](https://github.com/webspecto/wp-sync-amocrm/blob/master/inc/amocrm_wpcf7.php): `inc/amocrm_wpcf7.php`
- [WPForms Sync](https://github.com/webspecto/wp-sync-amocrm/blob/master/inc/amocrm_wpforms.php): `inc/amocrm_wpforms.php`
- [Pro Form Integrations](https://github.com/webspecto/wp-sync-amocrm/blob/master/admin/admin.php): `admin/admin.php`

### Other components

- **WordPress**
- **AmoCRM / Kommo**

## Connections

- WordPress → Plugin Bootstrap: loads plugin (evidence: `wp-sync-amocrm.php`)
- Plugin Bootstrap → Admin Settings: loads admin (evidence: `wp-sync-amocrm.php`)
- Plugin Bootstrap → Contact Form 7 Sync: dispatches submissions (evidence: `wp-sync-amocrm.php`)
- Plugin Bootstrap → WPForms Sync: dispatches submissions (evidence: `wp-sync-amocrm.php`)
- WordPress → Contact Form 7 Sync: submits forms (evidence: `readme.txt`)
- WordPress → WPForms Sync: submits forms (evidence: `readme.txt`)
- Admin Settings → Auth Files: reads credentials (evidence: `admin/admin.php`)
- Admin Settings → AmoCRM / Kommo: fetches CRM data (evidence: `admin/admin.php`)
- OAuth Callback → Auth Files: saves token (evidence: `oauth2-amocrm.php`)
- OAuth Callback → AmoCRM / Kommo: authorizes with (evidence: `oauth2-amocrm.php`)
- Contact Form 7 Sync → Auth Files: reads token (evidence: `inc/amocrm_wpcf7.php`)
- Contact Form 7 Sync → Auth Files: refreshes token (evidence: `inc/amocrm_wpcf7.php`)
- Contact Form 7 Sync → AmoCRM / Kommo: creates CRM records (evidence: `inc/amocrm_wpcf7.php`)
- WPForms Sync → Auth Files: reads token (evidence: `inc/amocrm_wpforms.php`)
- WPForms Sync → Auth Files: refreshes token (evidence: `inc/amocrm_wpforms.php`)
- WPForms Sync → AmoCRM / Kommo: creates CRM records (evidence: `inc/amocrm_wpforms.php`)
- WordPress → Pro Form Integrations: supports Pro forms (evidence: `readme.txt`)
