Integrace SimpleShop

Nastavili jsme přímé automatické propojení mezi SimpleShopem a Email Machine. Tady je přehledný manuál, jak ho rozjet a na co si dát pozor, abys neztrácel čas.

Jak to rozjet

Zapomeň na složité kódování. Propojení zvládneš na pár kliknutí přímo v administraci Email Machine. Než se do toho pustíš, budeš potřebovat:

• API klíč z administrace SimpleShop
• vytvořený seznam kontaktů v Email Machine, kam budeš chtít sypat data

Návod krok za krokem:

1. Jdi do: Nastavení účtu ➔ SimpleShop propojení ➔ Připojit nový SimpleShop účet.
2. Vyplň pole:
   • Název (pojmenuj si účet, abys v tom měl pořádek).
   • Přihlašovací e-mail do SimpleShopu.
   • API klíč (najdeš ho v administraci SimpleShopu).
   • Cílový seznam kontaktů.
3. Ulož to.

DŮLEŽITÉ PRAVIDLO 1: Seznam kontaktů musí existovat ještě předtím, než formulář otevřeš! Ve formuláři si ho jen vybíráš z roletky, systém za tebe nový seznam nevytvoří.

DŮLEŽITÉ PRAVIDLO 2: Jedna integrace = jeden seznam. Na jeden seznam kontaktů v Email Machine jde napojit výhradně jedno SimpleShop propojení (unikátnost contact_list_id). Chceš napojit víc SimpleShop účtů? Musíš si pro každý vytvořit vlastní seznam kontaktů.

A bezpečnost? Tvůj API klíč se ukládá v šifrované podobě, takže je v bezpečí.

Jak synchronizace funguje

Data tečou jednosměrně: ze SimpleShopu do Email Machine. Zpátky do SimpleShopu nezapisujeme nic.

Co přenášíme:

• E-mail (základní identita kontaktu)
• Jméno a příjmení
  
• Telefon
  
• Kompletní adresa (ulice + město + PSČ se spojí do jednoho přehledného pole)
  
• ID kontaktu
  

Praktické info: Všechna tato pole jsou v Email Machine systémová. Nemusíš ztrácet čas zakládáním vlastních atributů seznamu.

Co NEPŘENÁŠÍME:

• Firma, IČ, DIČ
• Poznámky k zákazníkovi

Jak často automat běží?

Synchronizace běží spolehlivě na pozadí: každých 30 minut (vždy v :00 a :30).

Není to inkrementální import, který by hledal jen změny. Při každém běhu systém projde a stáhne kompletně všechny kontakty ze SimpleShopu (stránkuje po 100).

Pozor na první spuštění: První import proběhne v nejbližší celou nebo půlhodinu. Ruční spuštění hned po uložení není potřeba, nech systém na pozadí pracovat.

8 věcí, na které je dobré myslet

Abys nebyl překvapený, tady jsou přesná pravidla, kterými se synchronizace řídí:

1. Chybějící e-maily: Kontakt bez e-mailu nebo s neplatným e-mailem systém přeskočí.
2. E-mail jako unikátní klíč: Identita se určuje podle e-mailu (převedeného na malá písmena). Případné duplicity v SimpleShopu se sloučí do jednoho profilu.
3. Doplňování dat: Pokud e-mail v Email Machine už existuje z jiného zdroje, kontakt se přidá i do SimpleShop seznamu a údaje se doplní. Prázdná hodnota ze SimpleShopu ale nikdy nepřepíše už vyplněnou hodnotu.
4. Datum registrace: Datum registrace se u existujícího kontaktu nemění – zůstává původní z prvního importu. U nových kontaktů se nastaví čas aktuálního importu.
5. Mazání kontaktů: Když smažeš kontakt v SimpleShopu, v Email Machine zůstává. Sync kontakty přidává a aktualizuje, ale nepromazává.
6. Ochrana odhlášených: Pokud se od tebe zákazník v Email Machine odhlásil nebo e-mail bouncoval, opakovaný import ho nikdy znovu nepřihlásí. Globální odhlášení má přednost.
7. Smazání propojení: Když se rozhodneš SimpleShop propojení smazat, kontakty v seznamu Email Machine samozřejmě zůstanou nedotčené.
8. Bezdrátový provoz: Jakmile integraci jednou nastavíš, dál běží vše plně automaticky.