Jak propojit produkt z Konverzek s automatizací ve FAPI


Produkt, který prodáváte v Konverzkách, nemusíte znovu nutně vytvářet jako produkt v katalogu FAPI, pokud váš prodej probíhá jen přes Konverzky. Aby však FAPI poznalo, ke kterému produktu se objednávka vztahuje a spustilo správné automatizační pravidla, je potřeba produktu přiřadit jedinečný identifikátor.

Identifikátor je krátký kód produktu, například KURZ2026. Konverzky tento kód odešlou do FAPI společně s objednávkou. FAPI podle něj pozná, která automatizace se má spustit.

Nejde tedy o synchronizaci produktů. Změna názvu, ceny nebo jiných údajů produktu v Konverzkách automaticky neupraví produkt ve FAPI. Identifikátor slouží pouze ke správnému rozpoznání objednané položky.

Celý postup najdete i v této videonápovědě:


Postupujte prosím v těchto krocích:

  1. Nastavte si ve FAPI prodejní formulář

Nejprve si ve FAPI vytvořte prodejní formulář, pod kterým chcete objednávky z Konverzek evidovat.

V tomto formuláři následně nastavíte automatizace, které se mají spustit například po:

    • objednání produktu,
    • zaplacení produktu,
    • stornování objednávky.

  1. Propojte Konverzky s FAPI přes novou integraci FAPI

V levém panelu vyhledejte Integrace, v pravém horním rohu pak klikněte na + Přidat novou integraci.

Z nabídky připravených integrací si vyberte právě FAPI.


Vyplňte a nechte Povolit automatizace. Další nastavení zvolte dle vlastního uvážení a potřeb. FAPI doporučuje všechny volby povolit.

Název - si pojmenujte např. FAPI (máte-li více FAPI účtů dejte např. FAPI 1)

Uživatelské jméno - stejné jako email, na který máte své FAPI registrováno (při generování API klíče se vám zobrazí).

API klíč -  pro propojení s Konverzkami si vytvoříte jedinečný API klíč ve FAPI v sekci Můj účet > API klíče,

Můžete postupovat i pomocí této FAPI nápovědy: Jak získat API klíč

Nastavte si rovněž formulář pro spárování z 1. kroku tohoto návodu.

Nastavení Integrace v Konverzkách uložte.

3. V Konverzkách nastavte u produktu identifikátor

Vytvořte nový produkt v Konverzkách a při vytváření přidejte přes Pokročilá nastavení "Identifikátor", cílovou službu vyberte FAPI. Těchto identifikátorů můžete nastavit neomezeně.

Každý produkt by měl mít vlastní jedinečný identifikátor. Používejte jednoduchý kód bez mezer a diakritiky.

Tento Identifikátor pak použijte v prodejním formuláři ve FAPI ve 4. kroku Akce.

Máte produkt vytvořený ve FAPI i v Konverzkách?


Prodáváte-li stejný produkt v Konverzkách i ve FAPI, pak jako Identifikátor doporučujeme použít kód produktu z FAPI, který najdete kartě Prodej > Produkty, v levém sloupci Kód.

Pokud si tento kód chcete nastavit podle sebe, např. test123, pak v kartě Nastavení > Nastavení fakturace, v sekci ROZŠÍŘENÉ NASTAVENÍ PRODUKTU, si aktivujte Kód položky (EAN/ISBN)

Toto nastavení vám umožní přímo v Úpravě produktu nastavit vlastní kód položky.


  1. Použijte stejný identifikátor v automatizaci FAPI

Ve FAPI v prodejním formuláři vytvořeném v 1. kroku pro Konverzky, přejděte do 4. kroku Akce nastavte nad vytvořeným produktem automatizaci.

    1. Úprava prodejního formuláře, přejděte do 4. kroku Akce.
    2. Vytvořte novou událost a akci. Zadejte požadovanou událost: objednání / zaplacení / stornování položky s kódem.
    3. Do pole kód produktu vyplňte právě "Identifikátor" z 3. kroku

5. FAPI formulář uložte.


Jak propojení funguje

Po vytvoření objednávky proběhne následující:

  1. Zákazník objedná produkt v Konverzkách.
  2. Konverzky odešlou objednávku do FAPI.
  3. Součástí objednávky je identifikátor produktu.
  4. Objednávka se přiřadí k prodejnímu formuláři vybranému v poli Formulář pro spárování.
  5. FAPI porovná identifikátor položky s kódy uvedenými v automatizacích formuláře.
  6. Pokud se kódy shodují, FAPI provede nastavenou akci.

Je nutné vytvořit produkt také ve FAPI?

Pro samotné rozpoznání produktu a spuštění automatizace by měl stačit identifikátor odeslaný z Konverzek. Produkt proto zpravidla není nutné vytvářet také v katalogu FAPI.

Vytvoření stejného produktu ve FAPI může být užitečné, pokud jej chcete používat také:

  • v běžném prodejním formuláři FAPI,
  • při ručním vystavování dokladů,
  • v dalších samostatných prodejích vedených přímo přes FAPI.

Jak ověřit, že propojení funguje

Vytvořte testovací objednávku produktu v Konverzkách a následně ve FAPI zkontrolujte:

  • zda se objednávka ve FAPI zobrazila,
  • zda je přiřazena ke správnému prodejnímu formuláři,
  • zda objednaná položka obsahuje správný identifikátor,
  • zda se spustila očekávaná automatizace.

Pokud se objednávka přenesla, ale automatizace se nespustila, zkontrolujte především přesnou shodu identifikátoru a zapnutí možnosti Povolit automatizace.


Pokud budete provádět testování a formulář bude v testovacím režimu, děkovací stránka se nezobrazuje správně. Zobrazení děkovačky je potřeba otestovat v produkčním režimu.

Může vás též zajímat: JAK VLOŽIT PRODEJNÍ FORMULÁŘ DO PRODEJNÍ STRÁNKY V KONVERZKÁCH

Našli jste odpověď? Děkujeme za zpětnou vazbu. Vaši zpětnou vazbu se nepodařilo odeslat. Zkuste to prosím později.

Potřebujete pomoc? Kontaktujte nás Kontaktujte nás