Tento návod popisuje postup, jak propojit FAPI s platformou ngemailing.cz přes Zapier. Důležité je vědět, že ngemailing.cz používá platformu MailWizz (technicky je to MailWizz „pod kapotou“). V Zapieru tedy budete pracovat s integrací MailWizz, aby uživatel nebyl zmatený názvem.

Referenční stránka k integraci MailWizz v Zapieru: https://zapier.com/apps/mailwizz/integrations

Přehled architektury integrace

  • Trigger: FAPI – vznik nebo zaplacení objednávky
  • Middleware: Zapier (Webhooks)
  • Akce: MailWizz (ngemailing.cz) – vytvoření / aktualizace subscriberu a zařazení do listu

Krok 1: Příprava MailWizz / ngemailing.cz

1.1 Aktivace API přístupu

  1. V administraci ngemailing.cz (MailWizz) otevřete Settings → API.
  2. Vytvořte nový API klíč.
  3. Uložte si:
    • API URL (typicky https://app.ngemailing.cz/customer/api-keys/index)
    • API klíče

1.2 Příprava mailing listu

Vytvořte list (seznam) a připravte pole. Doporučení je držet názvy polí konzistentně, aby šly snadno mapovat v Zapieru.

  • Povinná pole: EMAIL, FNAME
  • Doporučená vlastní pole: PRODUCT, ORDER_ID, PRICE, STATUS

Krok 2: Nastavení webhooku ve FAPI

2.1 Vytvoření webhooku

  1. Ve FAPI otevřete Nastavení → Webhooky.
  2. Vytvořte nový webhook.
  3. Jako událost doporučuji nastavit order_paid (aby se zpracovaly pouze zaplacené objednávky).
  4. Pole URL zatím nechte prázdné – doplníte jej ze Zapieru.

Krok 3: Zapier – Trigger (Webhooks by Zapier)

3.1 Vytvoření Zapu

  1. V Zapieru vytvořte nový Zap.
  2. Jako Trigger app vyberte Webhooks by Zapier.
  3. Event nastavte na Catch Hook.
  4. Zapier vygeneruje Webhook URL.

3.2 Propojení se FAPI + test

  1. Vložte vygenerovanou Webhook URL do webhooku ve FAPI a uložte.
  2. Ve FAPI vytvořte testovací objednávku (ideálně tak, aby proběhla platba / stav „paid“).
  3. V Zapieru klikněte na Test trigger.
  4. Ověřte, že dorazila data (minimálně): email, jméno, order_id, produkt, cena, payment_status.

Krok 4: Zapier – Akce (MailWizz přes API)

Protože MailWizz v Zapieru typicky neřeší vše přes nativní akce, je spolehlivá cesta použít Webhooks by Zapier → Custom Request a volat MailWizz API.

4.1 Přidání akce

  1. V Zapu přidejte další krok (Action).
  2. Vyberte Webhooks by Zapier.
  3. Event nastavte na Custom Request.

4.2 Nastavení requestu (Create/Update subscriber)

Method: POST

URL:

https://app.ngemailing.cz/api/lists/LIST_UID/subscribers

Headers:

X-MW-API-KEY: VAS_API_KEY
Content-Type: application/json

Body (JSON):

{
  "EMAIL": "{{email}}",
  "FNAME": "{{jmeno}}",
  "PRODUCT": "{{produkt}}",
  "ORDER_ID": "{{order_id}}",
  "PRICE": "{{price}}",
  "STATUS": "paid"
}

Poznámky:

LIST_UID získáte z URL detailu listu v MailWizz / ngemailing.cz.

Hlavička musí být přesně X-MW-API-KEY.

E-mail musí být validní, jinak může MailWizz vytvoření odmítnout.

Chování je typicky: existující e-mail = update, nový e-mail = create (záleží na konfiguraci a endpointu).

Krok 5: Filtrace a větvení (doporučeno)

5.1 Filtrace pouze zaplacených objednávek

Přidejte krok Filter by Zapier a nastavte podmínku:

payment_status je rovno paid

Tím zabráníte přidávání neplatičů do listu.

5.2 Více produktů (Paths)

Pokud prodáváte více produktů, použijte Paths by Zapier:

  • Produkt A → list A / automation A
  • Produkt B → list B / automation B

Krok 6: Automatizace v MailWizz (ngemailing.cz)

  1. V MailWizz nastavte automatizaci s triggerem Subscriber added to list.
  2. Přidejte podmínku podle pole PRODUCT (nebo podle tagu/listu).
  3. Nastavte sekvenci: welcome e-mail, onboarding, následné nabídky.

Nejčastější chyby

  • Chybějící povinné pole v listu: subscriber se nevytvoří.
  • Použití události order_created místo order_paid: vznikají duplicity a dostanete do listu neplatiče.
  • Špatný LIST_UID: API vrací 404.
  • Chybná hlavička API klíče: musí být přesně X-MW-API-KEY.

Shrnutí

  • FAPI odešle data webhookem do Zapieru.
  • Zapier provede filtraci a mapování polí.
  • MailWizz (ngemailing.cz) vytvoří nebo aktualizuje subscriber a spustí automatizace.