Propojení FAPI a ngemailing.cz přes Zapier (MailWizz)

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

• V administraci ngemailing.cz (MailWizz) otevřete Settings → API.

• Vytvořte nový API klíč.

• 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

• Ve FAPI otevřete Nastavení → Webhooky.

• Vytvořte nový webhook.

• Jako událost doporučuji nastavit order_paid (aby se zpracovaly pouze zaplacené objednávky).

• Pole URL zatím nechte prázdné – doplníte jej ze Zapieru.

Krok 3: Zapier – Trigger (Webhooks by Zapier)

3.1 Vytvoření Zapu

• V Zapieru vytvořte nový Zap.

• Jako Trigger app vyberte Webhooks by Zapier.

• Event nastavte na Catch Hook.

• Zapier vygeneruje Webhook URL.

3.2 Propojení se FAPI + test

• Vložte vygenerovanou Webhook URL do webhooku ve FAPI a uložte.

• Ve FAPI vytvořte testovací objednávku (ideálně tak, aby proběhla platba / stav „paid“).

• V Zapieru klikněte na Test trigger.

• 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

• V Zapu přidejte další krok (Action).

• Vyberte Webhooks by Zapier.

• 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)

• V MailWizz nastavte automatizaci s triggerem Subscriber added to list.

• Přidejte podmínku podle pole PRODUCT (nebo podle tagu/listu).

• 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.