Hynek Oubrecht 
2025-12-18 11:31:30 
3 min čtení
Mailocator umožňuje přivádět cenné leady z webových kampaní přímo do vašeho e-mailingového nebo CRM systému. Pokud pracujete s vlastním řešením, nebo chcete nabídnout klientům jednoduché napojení na vaši platformu, tento článek vám ukáže, jak správně připravit integraci a jaký rozsah funkcí dává největší smysl.
Konektory vyvíjíme na základě dokumentace třetích stran
Mailocator je navržen tak, aby se dal napojit na jakýkoli systém, který umožní:
- přidat kontakt do databáze,
- ověřit existenci kontaktu,
- případně aktualizovat jeho data.
Integrace je vždy implementována formou konektoru, který vytváříme interně na základě vaší API dokumentace.
Stačí dodat:
- popis API endpointů,
- formát přenosu dat (JSON, XML),
- autorizaci (API klíč, OAuth, Basic Auth, token),
- omezení nebo typické limity (rate limit, batch processing, validace).
Konektor následně nasadíme přímo do Mailocatoru, kde si jej uživatel může vybrat stejně jako jakýkoli jiný předpřipravený e-mailingový nástroj.
Základní předpoklady napojení
Aby bylo možné aplikaci korektně propojit, musí cílový systém umět dvě základní operace:
Ověřit existenci kontaktu
Typicky endpoint typu:
GET /contacts/{email} Smyslem je zabránit duplicitám, rozhodnout o aktualizaci a jednotně pracovat s DOI (double opt-in).
Přidat nový kontakt do seznamu
Standardně:
POST /contacts Očekává se schopnost:
- uložit e-mail,
- přiřadit kontakt do konkrétního seznamu, skupiny nebo segmentu,
- vrátit zpět stavové informace (úspěch, duplicita, nevalidní e-mail).
To je absolutní minimum, které umožní přenášet leady z formulářů Mailocatoru do vašeho systému.
Rozšíření: custom fields a další datová struktura
Ve většině reálných integrací se nepřenáší pouze e-mail, ale i další hodnoty, jako je:
- jméno,
- příjmení,
- telefon,
- kategorie zájmu,
- preference,
- source nebo identifikátor kampaně,
- hodnota voucheru,
- vlastní pole (custom fields).
Jak Mailocator pracuje s daty?
Mailocator předává data v přesně definovaném objektu, který zahrnuje:
- systémová pole (email, name, surname…),
- doplňující metadata o kampani,
- libovolná vlastní pole definovaná ve formuláři.
Konektor musí tato data umět mapovat na strukturu vašeho systému:
- buď na pevně definovaná pole,
- nebo do flexibilních custom fields.
Tím se z Mailocatoru nestává jen sběrač e-mailů, ale bohatý zdroj segmentačních dat, které lze využít např. k personalizaci welcome flow nebo dalším automatizacím.
Automatizace a pokročilé DOI procesy
U pokročilých integrací lze přenášená data využít k automatickému spouštění:
- welcome flow,
- double opt-in procesů,
- kampaní podle segmentu,
- scénářů založených na kategorii produktu,
- scénářů podle výše slevy nebo specifického lead magnetu,
- reklamačních / servisních / registrací produktů,
- newsletterových náborů z různých typů popupů.
Tato možnost je klíčová v integracích typu:
- Targito,
- Maileon,
- Ecomail,
- a dalších pokročilých nástrojů.
Jak to technicky funguje?
Mailocator odešle kontakt i s metadaty.
Vaše API uloží data a přiřadí kontakt do správné skupiny, seznamu nebo workflow.
E-mailingový systém spustí navázanou automatizaci.
Konektor tak musí umožnit:
- přiřazení tagů / segmentů,
- spuštění workflow pomocí API,
- nebo alespoň vložení kontaktu do “nástupního seznamu”.
Pokud systém podporuje DOI, konektor může:
- spustit vlastní potvrzující e-mail,
- nebo respektovat DOI proces řízený přímo e-mailingem.
