Webhooky v API FoodSoul: CRM sama informuje vaše služby o nových událostech

Nyní FoodSoul sám odesílá upozornění vašim systémům, když se v CRM něco děje. Například přišel nový objednávka, klient zaplatil nebo vrátil peníze, zaregistroval se nový host. Stačí jednou zadat adresu svého servisu a data budou ihned odcházet do účetního systému, vašeho bota, druhého CRM nebo analytiky.

O jakých událostech můžete dostávat upozornění

1. Nová objednávka s úplnou kartou. Hodí se pro účetní systém, kuchyni a analytiku.
2. Změna stavu objednávky. Vhodné pro bota, který informuje klienta o objednávce, a pro call centrum.
3. Změna stavu platby, včetně vrácení. Potřebné pro účetnictví a finanční evidenci.
4. Nový klient a změna jeho údajů. Pro externí CRM a rozesílací služby.
5. Připsání, odečtení a propadnutí bonusů. Pro věrnostní program a komunikaci s hosty.
6. Nová recenze. Pro manažera a oddělení kvality.
7. Přiřazení kurýra. Pro logistiku a upozornění klientovi.
8. Změna stop-listu. Pro web, kuchyni a platformy, na kterých prodáváte.
9. Pobočka zastavila nebo obnovila příjem objednávek. Pro operační kontrolu a vedení sítě.

Vy sami si vybíráte, o jakých událostech chcete dostávat upozornění. Můžete připojit jen ty potřebné, například „nová objednávka“ a „platba“. Nenašli jste potřebnou událost? Napište nám — rádi ji přidáme.

Jak připojit

1. Zapněte webhooky pro požadovanou pobočku — podpisový klíč se vytvoří automaticky.
2. Vyberte události, o kterých chcete dostávat upozornění.
3. Zadejte adresu vašeho servisu, na kterou bude FoodSoul odesílat data. Vhodná je pouze adresa s HTTPS.
4. Přidejte podpisový klíč do servisu, který přijímá upozornění, a nastavte ověření podpisu. Pokud jste při vytváření webhooků zadali různé adresy, přidejte klíč do každého servisu.
5. Ujistěte se, že servis potvrdí přijetí upozornění do 10 sekund, jinak jej FoodSoul odešle znovu.

6. Nastavte kontrolu na opakování: stejné upozornění může přijít několikrát. Všechny opakování mají stejné ID (hlavička X-Webhook-ID). Nechte svůj servis zapamatovat si ID zpracovaných upozornění a opakování ignorovat — tak se jedna platba neprovede dvakrát.

    

Bezpečnost: proč je potřeba podpisový klíč
 

FoodSoul podepisuje každé upozornění pomocí podpisového klíče — sady znaků, kterou máte jen vy a my. Podle tohoto podpisu váš systém ověří, že upozornění přišlo od FoodSoul a nikdo jej po cestě nezměnil.
 

Na adresu vašeho servisu může poslat požadavek kdokoliv. Například podvodník pošle falešné upozornění „objednávka zaplacena“ a vy vydáte nezaplacenou objednávku.
 

S podpisem to neprojde. Váš server vypočítá podpis stejným klíčem a porovná jej s přijatým. Pokud se podpisy neshodují, upozornění je falešné nebo změněné.

 

Pokud se něco pokazí

• Pokud je váš servis dočasně nedostupný, FoodSoul se ještě několikrát pokusí doručit upozornění během 10 hodin. Krátký výpadek nebo restart serveru nepovede ke ztrátě událostí.
• Pokud problém přetrvá, předplatné se vypne a přijde vám e-mail: tak se o problému dozvíte.
• Chcete-li předplatné znovu zapnout, napište na technickou podporu. Tam lze také znovu odeslat upozornění, která během výpadku nedorazila.
   

Podrobný popis událostí a formátu dat najdete v dokumentaci API.

S pozdravem, tým FoodSoul! Pracujeme pro vás!