KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #ai-agent #claude-code #mcp #typescript #codex #cli #rust #deepseek-harness

kommo-google-ads-offline-conversion

★ 3 Open GitHub ↗

Serverless application for syncing WhatsApp clicks to Kommo CRM and uploading offline conversions to Google Ads using tracking data.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# kommo-google-ads-offline-conversion
Simple yet production-ready AWS Lambda stack that syncs **Google Ads identifiers (gclid/gbraid)** captured on your landing page WhatsApp buttons to Kommo CRM leads and automatically uploads **offline conversions** back to Google Ads using enriched lead fields.

## How it works?
![flow-diagram](https://raw.githubusercontent.com/canzden/kommo-google-ads-offline-conversion/main/assets/flow-diagram.png)
1. **Track outbound WhatsApp clicks**
- `logOutboundClick` captures click identifiers from the URL and sends the tracking data to the `/outbound-click-logs` endpoint.
2. **AWS Lambda**
- Stores click logs to DynamoDB with specified TTL
- Matches incoming WhatsApp messages with click logs
- Updates and enriches lead with tracking fields
- Uploads offline conversion to Google Ads based on Kommo pipeline stage
3. **Kommo Service**
- Retrieves leads and associated contacts
- Updates custom fields
4. **Google Ads API Service**
- Hashes user identifiers (email/phone)
- Uploads offline conversions using the proper conversion action

## Usage
### Prerequisites
- Docker
- AWS Lambda & API Gateway & DynamoDB
- Kommo API access
- Google Ads API **Basic Level** access
### Build and Package the app
```sh
chmod +x build.sh
./build.sh # produces ~70mb artifact
```
### Deployment
- Deploy the application via S3 upload as specified in [AWS Lambda Python Deployment Docs](https://docs.aws.amazon.com/lambda/latest/dg/python-package.html) 
- Configure the environment variables in `.env.example` using AWS Secret Manager or Lambda environment variable configuration. 
- Wire the endpoints `/outbound-click-logs` and `update-lead?conversion_type=GoogleAdsService.ConversionType` to Lambda function.
- Embed `outboundClickLog.js` into  your website using **Google Tag Manager**(recommended) or attach it to WhatsApp buttons wtih event listeners.

## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

kommo-google-ads-offline-conversion

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README