> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Jak posílat každou novou objednávku do CRM

> Zaregistrujte webhook order.created, aby vaše CRM přímo nebo přes Make či Zapier dostalo každou novou objednávku i se zákazníkem a jeho odpověďmi z pokladny.

> [card] [Otevřít v administraci TWICE](https://admin.twicecommerce.com/settings/connect/integrations)
>
> settings/connect/integrations

Zaregistrujte webhook `order.created` a TWICE bude posílat každou novou objednávku do vašeho CRM, případně cestou přes Make nebo Zapier, i se zákazníkem a odpověďmi, které zadal u pokladny. [Webhooky](https://www.twicecommerce.com/docs/cs/concepts/integrations/webhooks.md) vysvětlují obsah, opakování a podpis.

Leady držte přímo v CRM. TWICE nemá žádný krok registrace před objednávkou a jeho webhooky nesou jen události objednávek, takže zákazník vytvořený jinak, například přes přihlášení e-mailem v zápatí online obchodu, nepošle nic. První objednávka člověka je první věc, kterou se o něm vaše CRM dozví.

## Předpoklady

> [!WARNING]
>
> **Potřebná oprávnění:**
>
> * **Spravovat integrace a API klíče** (`account_settings:webhooks`) pro vytvoření webhooku a přečtení jeho signing secretu. Mají ho Vlastník a Admin. Viz [Uživatelé a role](https://www.twicecommerce.com/docs/cs/settings/users-roles.md).

> [!NOTE]
>
> **Mějte připravené, než začnete:**
>
> * **Adresu HTTPS, která události přijímá**, například adresu spouštěče webhooku v Make nebo Zapier. TWICE posílá jen na adresy `https://`.
> * **Pravidlo v CRM, které páruje kontakty podle e-mailu.** TWICE drží jednoho zákazníka na e-mailovou adresu, takže stejný klíč udrží v CRM jeden kontakt na člověka.

## Postup

**1. Otevřete Webhooky**

Otevřete v hlavní nabídce **Nastavení** a v nabídce nastavení vlevo zvolte **Integrace & API** pod nadpisem **Připojit**. Sjeďte za sekci **Klíče API** k sekci **Webhooky**.

![Nastavení Integrace & API posunuté na sekci Webhooky se zvýrazněnou položkou Integrace & API v nabídce nastavení a sekcí Webhooky](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-01.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=03c7e94823812445dbe52f96a56ff50f)

**2. Začněte nový webhook**

Klikněte na **Vytvořit webhook** v pravém horním rohu sekce **Webhooky**. Otevře se dialog **Vytvořit webhook** na svém prvním kroku, **Vybrat událost**.

![Sekce Webhooky se zvýrazněným tlačítkem Vytvořit webhook v pravém horním rohu](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-02.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=83e00e78c4dafab111c7f7f59b88a267)

**3. Zvolte order.created**

Otevřete seznam **Vybrat událost** a zvolte `order.created`, událost spuštěnou při vytvoření nové objednávky. Klikněte na **Další**. Dialog přejde na druhý krok, **URL endpointu**.

![Dialog Vytvořit webhook v kroku Vybrat událost s otevřeným seznamem událostí a zvýrazněnou order.created](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-03.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=23400faaa6769b2968b075712ea1d0ba)

**4. Zadejte přijímající adresu**

Vložte svou adresu HTTPS do pole **Zadejte URL**. Adresa, která nezačíná `https://`, ukáže pod polem chybu a tlačítko **Vytvořit webhook** zůstane šedé.

![Dialog Vytvořit webhook v kroku URL endpointu s adresou HTTPS v poli Zadejte URL a bez chyby pod ním](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-04.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=475376f8573782f5373765db442894a3)

**5. Vytvořte webhook**

Klikněte na **Vytvořit webhook** dole v dialogu. Potvrdí to hláška **Webhook vytvořen** a tabulka v sekci **Webhooky** ukáže nový webhook s `order.created` ve sloupci **Událost** a **Aktivní** ve sloupci **Stav**.

![Tabulka Webhooky se zvýrazněným řádkem nového webhooku order.created a jeho štítkem Aktivní](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-05.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=a8330fc612e8498f5f81ab3fb01589a9)

**6. Zkopírujte signing secret**

Otevřete nabídku na pravém konci řádku webhooku a zvolte **Zobrazit signing secret**. Klikněte na tlačítko kopírování vedle secretu a předejte ho tomu, kdo staví přijímající stranu. Ta s ním ověřuje hlavičku `X-Twice-Signature` každého doručení.

![Dialog Webhook signing secret se rozmazaným tajemstvím a zvýrazněným tlačítkem pro kopírování vedle něj](https://mintcdn.com/twicecommerce/XzdcmB1NxT-YAMjE/images/guide-send-new-orders-to-a-crm-06.webp?fit=max\&auto=format\&n=XzdcmB1NxT-YAMjE\&q=85\&s=78569a61e0a4e4ec4fce5d61d4c88744)

**7. Zkontrolujte první doručení**

Až vznikne další objednávka, klikněte na řádek webhooku. Jeho stránka ukáže událost `order.created` a ve sloupci **Výsledek** bude **Doručeno**, jakmile váš endpoint odpověděl. Klikněte na doručení a přečtěte si jeho obsah v části **Payload**.

## Jak poznám, že to fungovalo?

* **Webhook je v seznamu** v sekci **Webhooky**, s `order.created` ve sloupci **Událost** a **Aktivní** ve sloupci **Stav**.
* **Každá nová objednávka přidá doručení** na stránku webhooku, s **Doručeno** ve sloupci **Výsledek**.
* **Obsah nese zákazníka.** Každá položka v `data.customers` má e-mail zákazníka, jméno, telefon, marketingový souhlas a vestavěná pole, na která se ptala vaše pokladna, a `attributes` obsahuje jeho odpovědi do atributů zákazníka. Odpovědi na vlastní otázky nabídky jsou na jejím řádku v `data.lineItems`.
* **Vaše CRM má jeden kontakt na e-mail**, který každá objednávka aktualizuje.

## Řešení potíží a časté chyby

> [accordion] Vytvořit webhook zůstává šedé
>
> Použijte adresu HTTPS, kterou vám dá přijímající strana. Zadaná adresa nezačíná `https://` a TWICE posílá jen na adresy HTTPS. Viz [Webhooky](https://www.twicecommerce.com/docs/cs/concepts/integrations/webhooks.md#správa-webhooků).

> [accordion] Doručení hlásí Selhalo nebo webhook hlásí Zakázáno
>
> Váš endpoint neodpověděl stavem 2xx. Když tři události po sobě selžou ve všech pokusech, TWICE webhook zakáže. Opravte endpoint, zvolte v nabídce řádku **Povolit** a selhané doručení pošlete znovu z jeho detailu tlačítkem **Znovu doručit**. Viz [Webhooky](https://www.twicecommerce.com/docs/cs/concepts/integrations/webhooks.md#doručení-a-opakování).

> [accordion] Vaše CRM má dva kontakty pro jednoho člověka
>
> Párujte kontakty v CRM podle e-mailu, stejným klíčem, podle kterého TWICE pozná vracejícího se zákazníka. CRM, které páruje podle čehokoli jiného, vytvoří druhý kontakt, a stejně tak člověk, který objedná s jinou adresou. Viz [Sbírejte údaje u pokladny](https://www.twicecommerce.com/docs/cs/guides/customers/collect-customer-data-at-checkout.md).

## Související články

> [card] [Webhooky](https://www.twicecommerce.com/docs/cs/concepts/integrations/webhooks.md)
>
> Události, obsah, opakování, protokol doručení a ověření podpisu.

> [card] [Integrace & API](https://www.twicecommerce.com/docs/cs/settings/integrations.md)
>
> Klíče API, webhooky a konektory, sekce po sekci.

> [card] [Sbírejte údaje u pokladny](https://www.twicecommerce.com/docs/cs/guides/customers/collect-customer-data-at-checkout.md)
>
> Rozhodněte, na co se pokladna ptá a kam která odpověď dorazí.

> [card] [Klíče API](https://www.twicecommerce.com/docs/cs/concepts/integrations/api-keys.md)
>
> Dejte integraci, která čte TWICE, vlastní klíč a rozsahy.

> [card] [Vlastní skripty](https://www.twicecommerce.com/docs/cs/sales-channels/online-store/custom-scripts.md)
>
> Proč měření nákupů běží z tohoto webhooku, a ne z prohlížeče.

> [card] [Export zákazníků](https://www.twicecommerce.com/docs/cs/guides/customers/export-customers.md)
>
> Přesuňte segment zákazníků do e-mailového nástroje jako soubor.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.