Quick facts
- Price
- $249.00 USD
- Odoo versions
- 17, 18, 19
- Setup time
- 21 min
- License
- One-time perpetual
- Languages
- 11 languages
One-time Purchase
TikTok Lead Generation Connector
Capture TikTok Instant Form submissions straight into Odoo CRM with attribution, auto-assignment and dedup. Built to order for Odoo 17/18/19.
$249.00USD
No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.
Key Features
TikTok Lead Generation API integration with OAuth token storage, encrypted access/refresh tokens, and automated token refresh via a scheduled ir.cron action
Real-time lead webhook capture through a dedicated Odoo controller endpoint that receives TikTok's push notifications the instant a form is submitted
Signature/HMAC verification and payload validation on every inbound webhook so only authentic TikTok events create records
Configurable Instant Form field mapping model — map each TikTok question (name, email, phone, custom fields) to any crm.lead field or custom field, no code changes per campaign
Automatic crm.lead creation with the mapped contact details, source, medium and a link back to the originating TikTok form and lead ID
Full ad-level attribution: campaign, ad group, ad, form name and TikTok advertiser ID stored on each lead for closed-loop reporting
UTM and marketing attribution capture (utm_source, utm_medium, utm_campaign) resolved against Odoo's utm.source / utm.medium / utm.campaign records
Rule-based auto-assignment to salespeople or sales teams by campaign, form, region or round-robin, using Odoo's assignment and team routing
Deduplication engine that matches incoming leads on email/phone against existing crm.lead and res.partner records to update instead of duplicating
Enrichment hooks — a documented extension point (Python method + automated action) to call your enrichment provider or run @api.depends compute logic before the lead is saved
Idempotent processing keyed on TikTok lead ID so webhook retries never create duplicate CRM leads
Retry-safe ingestion queue with a fallback polling job (ir.cron) that back-fills any leads missed during downtime
Full audit log of every received payload, mapping result and created lead for troubleshooting and compliance
Backend configuration screens (XML/OWL views) for connections, form mappings, assignment rules and logs — all managed from within Odoo, no external dashboard
Multi-form and multi-advertiser support so several TikTok campaigns and ad accounts feed one Odoo instance with per-form rules
Optional XML-RPC/JSON-RPC exposure so external systems can read the captured, attributed leads programmatically
About this Product
Right now, when someone fills in a TikTok Instant Form on one of your ad campaigns, that lead sits inside TikTok Ads Manager — disconnected from the pipeline your sales team actually works in. You export CSVs by hand, paste rows into Odoo, and by the time a rep calls, the prospect has forgotten they ever tapped your ad. There is no maintained module on apps.odoo.com that closes this gap, which is exactly why we build it for you.
Why Choose TikTok Lead Generation Connector
TikTok Lead Generation API integration with OAuth token storage, encrypted access/refresh tokens, and automated token refresh via a scheduled ir.cron action
Real-time lead webhook capture through a dedicated Odoo controller endpoint that receives TikTok's push notifications the instant a form is submitted
Signature/HMAC verification and payload validation on every inbound webhook so only authentic TikTok events create records
Configurable Instant Form field mapping model — map each TikTok question (name, email, phone, custom fields) to any crm.lead field or custom field, no code changes per campaign
Automatic crm.lead creation with the mapped contact details, source, medium and a link back to the originating TikTok form and lead ID
Full ad-level attribution: campaign, ad group, ad, form name and TikTok advertiser ID stored on each lead for closed-loop reporting
The TikTok Lead Generation Connector is a net-new Odoo module that ECOSIRE designs, builds, installs and supports specifically for your instance. It is NOT an instant download — after purchase we scope your fields and campaigns, then deliver a working integration within a typical 2–4 week lead time. The result: every TikTok Lead Gen submission lands in Odoo CRM (crm.lead) within seconds, correctly mapped, attributed, deduplicated, and routed to the right salesperson.
Under the hood the module registers with TikTok's Lead Generation API and subscribes to the lead webhook so submissions are pushed to a dedicated controller endpoint in Odoo the moment they happen. A signature-verified handler fetches the full lead payload, resolves your Instant Form's questions to Odoo fields through a configurable mapping model, and creates the crm.lead record with full ad-, ad-group- and campaign-level attribution plus any UTM parameters carried on the form. We build it as a proper Odoo module — its own __manifest__.py, Python models extending models.Model, computed fields with @api.depends, security via ir.model.access.csv and record rules, backend views in XML/OWL, and QWeb-ready data — so it upgrades cleanly and behaves like native Odoo, not a bolted-on script.
Because it is custom-built, the field mapping, assignment logic, deduplication rules and enrichment hooks are shaped around how YOUR team already works in Odoo. We support Community and Enterprise editions on Odoo 17, 18 and 19, hand you the full source, document everything, train your team, and stay on to support and adjust it after go-live.
What you get
- Complete, production-ready Odoo module source (Python models, controllers, XML/OWL views, ir.model.access.csv, record rules and data files) packaged with its own __manifest__.py, delivered to your repository
- Installation and deployment on your Odoo 17, 18 or 19 instance (Community or Enterprise), including the TikTok App/API credentials wiring and webhook registration
- Configured Instant Form field mappings, assignment rules and deduplication logic tailored to your campaigns and existing CRM structure
- Technical documentation covering architecture, the field-mapping model, webhook endpoint, security rules, cron jobs and how to add new forms yourself
- A live team training session (recorded) for marketing and sales admins on managing connections, mappings and troubleshooting the lead log
- A defined post-launch support and bug-fix window with a named point of contact for adjustments, TikTok API changes and edge cases
- A short runbook for TikTok token renewal, webhook re-subscription and health checks so the integration stays live
- Version compatibility notes and upgrade guidance so the module moves cleanly across Odoo 17 → 18 → 19
Who this is for
Performance Marketer running TikTok Lead Gen campaigns
You're spending real budget on TikTok Instant Forms but leads are stuck in Ads Manager. You want every submission in Odoo within seconds, tagged with the exact campaign, ad group and ad that drove it, so you can finally report cost-per-qualified-lead and true ROI inside your ERP instead of stitching spreadsheets together.
Sales Operations Manager owning the Odoo CRM pipeline
You care about clean, deduplicated, correctly-routed leads. Manual CSV imports create duplicates, stale data and slow follow-up. You want TikTok leads to auto-create crm.lead records, dedupe against existing contacts, and land on the right rep's desk instantly with SLA-friendly speed-to-lead.
Odoo Admin / IT lead at an SMB or agency
You need an integration that behaves like a proper Odoo module — real security via ir.model.access.csv and record rules, upgrade-safe code, a maintainable field-mapping model, and no fragile third-party middleware. You want source you own, on Odoo 17/18/19, with a partner who supports it when TikTok changes their API.
Installation overview
Download from ECOSIRE
Buy the license on ecosire.com and download the TikTok Lead Generation Connector module ZIP from your account dashboard.
Upload to Odoo
Extract the ZIP into your Odoo custom addons folder on the server (or upload via Apps > Install from file on Odoo.sh / runbot).
Install the module
Activate Developer Mode, open Apps, click Update Apps List, search for TikTok Lead Generation Connector, and press Install.
Configure settings
Open the new menu, paste your ECOSIRE license key, connect any external credentials (Shopify, Amazon, Stripe, etc.), and save.
Verify & go live
Run the built-in connection test, sync your first 10 records, and schedule the recurring cron. Contact support if anything fails.
How TikTok Lead Generation Connector Compares
| Criterion | ECOSIRE | Custom Build | Competitor | Odoo Native |
|---|---|---|---|---|
| Captures TikTok Instant Form leads directly into Odoo CRM | ||||
| Real-time webhook ingestion (no manual CSV export/import) | ||||
| Full ad / ad-group / campaign + UTM attribution on each lead | ||||
| Configurable Instant Form field mapping for custom fields | ||||
| Dedup against existing crm.lead / res.partner and auto-assignment | ||||
| Built as a proper, upgrade-safe Odoo module (manifest, ORM, security rules) | ||||
| Supported across Odoo 17, 18 and 19, Community & Enterprise | ||||
| Vendor support when TikTok changes its Lead Generation API | ||||
| You receive and own the full source code |
Frequently Asked Questions about TikTok Lead Generation Connector
+How long until the connector is live — is this an instant download?
No. This is a build-to-order module, not an apps.odoo.com download, so nothing installs instantly. After purchase we scope your TikTok ad accounts, Instant Form fields and CRM structure, then build, install and test the integration on your instance. Typical lead time is 2–4 weeks depending on the number of forms, custom fields and assignment/dedup rules. You'll get a timeline confirmed during kickoff and a working, verified integration at delivery — not a zip file to figure out yourself.
+What do I get for support and updates after go-live?
Every build includes a defined post-launch support and bug-fix window with a named contact. During it we fix defects, adjust field mappings and assignment rules, and adapt the module to any TikTok Lead Generation API changes (token, webhook or payload changes). We also hand you the full source and documentation so you own it. After the included window, ongoing support and enhancements are available as a maintenance retainer or on request — including moving the module across Odoo 17, 18 and 19 upgrades.
+Which Odoo versions and editions does this work with?
We build and support the connector for Odoo 17, 18 and 19, on both Community and Enterprise. Because it's custom-built for your instance, we compile it against your exact version and confirm compatibility with your existing CRM, UTM and any customizations before delivery. If you're mid-upgrade, tell us your target version and we'll target that.
+How exactly do TikTok leads reach Odoo — polling or real-time?
Real-time. The module registers with TikTok's Lead Generation API and subscribes to the lead webhook, so TikTok pushes each submission to a dedicated, signature-verified controller endpoint in your Odoo the moment the Instant Form is completed. A secure handler validates the payload, maps the fields and creates the crm.lead within seconds. We also add a fallback ir.cron polling job that back-fills any leads missed during downtime, so nothing is lost even if your server was briefly unreachable.
+Will it create duplicate leads, and can it map my custom form fields?
No duplicates by design. Processing is idempotent on the TikTok lead ID (retries won't double-create), and a deduplication engine matches incoming email/phone against existing crm.lead and res.partner records to update rather than duplicate. For fields, we build a configurable mapping model so every TikTok Instant Form question — including custom questions — maps to any Odoo field. Adding a new form or field later is a configuration step, documented for your team, not a code rewrite.
+Do you need access to my TikTok Ads and Odoo, and is it secure?
Yes to both, handled securely. We need TikTok Business/API app credentials (or we guide you through creating them) to register the webhook and pull lead data, plus access to your Odoo instance to install and configure the module. Tokens are stored encrypted, the webhook endpoint verifies TikTok's signature on every call, and access inside Odoo is governed by proper ir.model.access.csv permissions and record rules. You keep ownership of the credentials and can revoke access at any time.
Why Customers Trust ECOSIRE
SOC 2 Aligned
GDPR Compliant
Secure Stripe Payment
30-Day Money Back
Lifetime Updates
LGPL-3.0 License
Related Modules
Request a quote
TikTok Lead Generation Connector
Capture TikTok Instant Form submissions straight into Odoo CRM with attribution, auto-assignment and dedup. Built to order for Odoo 17/18/19.
- TikTok Lead Generation API integration with OAuth token storage, encrypted access/refresh tokens, and automated token refresh via a scheduled ir.cron action
- Real-time lead webhook capture through a dedicated Odoo controller endpoint that receives TikTok's push notifications the instant a form is submitted
- Signature/HMAC verification and payload validation on every inbound webhook so only authentic TikTok events create records
- Configurable Instant Form field mapping model — map each TikTok question (name, email, phone, custom fields) to any crm.lead field or custom field, no code changes per campaign