TikTok Lead Generation Connector

Name: TikTok Lead Generation Connector
Brand: ECOSIRE
SKU: tiktok-lead-ads-connector

Fonctionnalités clés

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

Fait sur commande, clé en main

Aucune configuration à faire vous-même — une app fonctionnelle conçue, installée et prise en charge par ECOSIRE.

Vous commandez

Commencez par un prix de développement unique. Nous cadrons le projet avec vous au lancement.

Nous développons et installons

ECOSIRE la développe, la configure et l'installe sur votre Odoo.

Mise en ligne + assistance

Vous êtes en ligne en 2–4 semaines environ, avec une période d’assistance après le lancement.

À propos de ce produit

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.

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.

Ce que vous obtenez

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

Pour qui c'est

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.

Comment TikTok Lead Generation Connector se compare

Critère	ÉCOSIRE	Construction personnalisée	Concurrent
Captures TikTok Instant Form leads directly into Odoo CRM	Inclus	Prise en charge partielle	Non inclus
Real-time webhook ingestion (no manual CSV export/import)	Inclus	Prise en charge partielle	Non inclus
Full ad / ad-group / campaign + UTM attribution on each lead	Inclus	Prise en charge partielle	Non inclus
Configurable Instant Form field mapping for custom fields	Inclus	Prise en charge partielle	Non inclus
Dedup against existing crm.lead / res.partner and auto-assignment	Inclus	Prise en charge partielle	Non inclus
Built as a proper, upgrade-safe Odoo module (manifest, ORM, security rules)	Inclus	Prise en charge partielle	Prise en charge partielle
Supported across Odoo 17, 18 and 19, Community & Enterprise	Inclus	Prise en charge partielle	Prise en charge partielle
Vendor support when TikTok changes its Lead Generation API	Inclus	Non inclus	Prise en charge partielle
You receive and own the full source code	Inclus	Inclus	Non inclus

Foire aux questions sur 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.