Přejít na hlavní obsah

Otevřít v administraci TWICE

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

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

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

Související články

Webhooky

Události, obsah, opakování, protokol doručení a ověření podpisu.

Integrace & API

Klíče API, webhooky a konektory, sekce po sekci.

Sbírejte údaje u pokladny

Rozhodněte, na co se pokladna ptá a kam která odpověď dorazí.

Klíče API

Dejte integraci, která čte TWICE, vlastní klíč a rozsahy.

Vlastní skripty

Proč měření nákupů běží z tohoto webhooku, a ne z prohlížeče.

Export zákazníků

Přesuňte segment zákazníků do e-mailového nástroje jako soubor.