Lead CRM Messenger
A WordPress plugin that brings website enquiries, messenger conversations and call events into one manager workflow.
Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/bogdananisovec/wp-lead-crm-messenger/archive/refs/heads/main.zipEnglish | Deutsch
Overview
WP Lead CRM Messenger is a custom WordPress plugin demo for capturing leads, managing them as CRM records, and synchronizing conversations with external messenger and automation services.
This repository is a sanitized portfolio version. Client-specific data, credentials, production endpoints and proprietary content have been removed or replaced with demo values.
My Role
I designed and implemented the plugin architecture, lead workflow, WordPress admin UI, AJAX submission flow, REST/webhook endpoints, and integration adapters as part of commercial WordPress development work.
Key Features
- Custom post type based lead CRM inside WordPress.
- AJAX lead capture with nonce validation and structured metadata.
- REST API webhook endpoints for messenger and call-tracking callbacks.
- PHP OOP service layer for repository, settings, outbox, messenger clients, and relay endpoints.
- Admin UI for lead status, manager assignment, failed outbox jobs, and integration settings.
- Demo Cloudflare Worker relay adapter for keeping production bot tokens outside WordPress.
Tech Stack
PHP, WordPress Plugin API, REST API, AJAX, JavaScript, Cloudflare Workers, Telegram/MAX-style messenger adapters, webhook integrations.
What This Repository Demonstrates
- Custom WordPress plugin development beyond theme-level form handling.
- Maintainable PHP OOP architecture in a WordPress environment.
- Integration boundaries for messengers, analytics, and call-tracking systems.
- Secure-by-default portfolio sanitization using placeholders instead of real credentials.
Architecture / Implementation
lead-crm-messenger.phpbootstraps the plugin.src/Repository.phpowns lead persistence, AJAX capture, duplicate handling, and CRM metadata.src/Webhooks.phpexposes REST webhook handlers.src/Outbox.phpimplements queued delivery/retry behavior.src/Admin.phprenders integration and CRM admin screens.cloudflare/contains a sanitized relay adapter example.
Setup
- Copy the repository into
wp-content/plugins/wp-lead-crm-messenger. - Activate the plugin in WordPress admin.
- Configure demo values in the plugin settings screen.
- For relay experiments, copy
.env.exampleinto the appropriate secret store and replace placeholders.
No real bot token, OAuth token, webhook secret, chat ID, customer lead, private domain, or production endpoint is included.
Screenshots
Screenshots are not included because the original admin screens contained commercial client context. Add new screenshots from a synthetic WordPress demo install before publishing marketing material.
Notes
This is a portfolio/demo repository, not a production drop-in integration. Review the relay adapter and create fresh demo credentials before testing external services.