# Jak automatizovat e-maily životního cyklu z událostí Stripe

Kanonická URL: https://brew.new/cs/blog/how-to-automate-lifecycle-emails-from-stripe-subscription-events
Autor: Philip Sørensen
Publikováno: 2026-09-18
Aktualizováno: 2026-09-29

Stripe vysílá události, když se změní předplatné, faktura nebo platba. Tyto události můžou spouštět užitečné e-maily, ale každá zpráva pořád potřebuje jasně určeného příjemce, účel a pravidlo, podle kterého se rozhodne, jestli je ještě aktuální.

[Integrace Stripe](/cs/browse/integrations/stripe) v Brew se postará o připojení přes OAuth i nastavení webhooku. Tento průvodce se věnuje tomu, jak navrhnout e-mailový program, který na ní postavíš. Sekvence, které nezačínají platbami, ale událostmi v produktu, popisuje článek [Automatizace e-mailů s AI](/cs/blog/ai-email-automation).

## Jedna událost, jedna zpráva

| Cíl | Vhodná událost | Co zkontrolovat před odesláním |
| --- | --- | --- |
| Přivítat předplatitele | `customer.subscription.created` | Aby nepřišlo druhé uvítání z pokladny |
| Vysvětlit konec zkušební verze | `customer.subscription.trial_will_end` | Skutečný termín a jestli dojde k platbě |
| Oznámit neúspěšnou platbu faktury | `invoice.payment_failed` | Aktuální faktura, odkaz na fakturaci, upozornění, která už posílá Stripe |
| Vysvětlit změnu tarifu | `customer.subscription.updated` | Která pole se změnila a jestli na změně záleží |
| Potvrdit zrušení | `customer.subscription.deleted` | Kdy končí přístup a co zákazník požadoval |
| Vysvětlit refundaci | `refund.created` | Pole specifická pro refundaci, která událost obsahuje |

Vycházej z [přehledu událostí Stripe](https://docs.stripe.com/api/events/types) a ze schématu vybraného spouštěče v Brew. Aktualizace předplatného může znamenat několik různých změn; e-mail o změně tarifu proto neposílej při každé aktualizaci bez kontroly jejích dat.

## Připojuj a publikuj s rozmyslem

Na stránce Integrace v Brew autorizuj Stripe. Brew zaregistruje webhook a zřídí podporované spouštěče. Jednotlivé události nejde zapnout ani vypnout. Spustí se jen aktivní automatizace navázané na danou událost.

Pokud potřebuješ naimportovat starší kontakty, zvol Synchronizovat zákazníky ze Stripe. Import fakturačního kontaktu neznamená souhlas s marketingovými e-maily. Nastavení Synchronizovat celé jméno u každé události řídí aktualizace jmen, ne to, jestli se e-maily odešlou.

První automatizaci sestav jako koncept, prohlédni si vygenerovaný e-mail a před publikováním ji otestuj s příjemci, které máš pod kontrolou. Podrobnosti o připojení najdeš v [návodu k nastavení Stripe](https://docs.brew.new/integrations/import/stripe); Brew připojuje ostré účty Stripe a události z testovacího režimu automatizace nespouštějí.

## Neúspěšná platba bez zastaralých připomínek

Okamžité upozornění na neúspěšnou platbu může začínat událostí `invoice.payment_failed`. Vysvětli, co se stalo, a odkaž na vlastní stránku s fakturací. Neslibuj, že Brew zkusí platbu strhnout znovu; platby má na starosti Stripe.

Pro připomínku o tři dny později nech svou aplikaci naplánovat kontrolu stavu faktury. Pokud faktura zůstává nezaplacená a zákazník má na připomínku pořád nárok, vyšli do Brew samostatnou událost pro připomínku. Pokud už platba prošla, kontrola skončí a žádná událost se nevyšle.

Po kroku Čekání obsahují pole události pořád původní payload. Podmínka na `contact.stripe_subscription_status` čte aktuální pole kontaktu v Brew ve chvíli, kdy se daný uzel spustí. Nedotazuje se Stripe a neprokazuje, že právě tato faktura byla zaplacena. Pozdější událost `invoice.paid` starší běh automaticky nezruší. Ani aktualizace platební metody není důkazem platby.

Otestuj tři případy: platba projde ještě před kontrolou připomínky, faktura zůstane nezaplacená a úloha se zopakuje. Pro stejnou logickou událost použij v rámci [zdokumentovaného okna pro opakování](https://docs.brew.new/api-reference/api/idempotency) stejný idempotenční klíč.

## Personalizuj podle deklarovaných polí

Brew umí ke kontaktům synchronizovat fakturační pole, včetně stavu předplatného a tarifu. Payload události a pole kontaktu jsou dva různé zdroje. Než použiješ `amount`, `currency`, `invoiceNumber`, `previousPlan`, `newPlan` nebo `failureMessage`, přečti si schéma spouštěče; ne každá událost obsahuje všechna tato pole.

ID objektů Stripe se z payloadu automatizace vynechávají. Nesestavuj URL fakturačního portálu z předpokládaného ID faktury nebo předplatného. Použij stránku s fakturací ve své aplikaci, která vyžaduje přihlášení, nebo odkaz, který záměrně předáš ve vlastní události. Řiď se [návodem k proměnným](https://docs.brew.new/create-emails/merge-tags).

## Každému systému jeden úkol

Projdi si [nastavení zákaznických e-mailů ve Stripe](https://docs.stripe.com/billing/revenue-recovery/customer-emails). Rozhodni, který systém posílá účtenky, upozornění na neúspěšné platby a připomínky. Zapnutím automatizace v Brew se e-maily ze Stripe nevypnou.

Do oznámení k účtu propagační obsah nepatří, dokud neprověříš účel zprávy a oprávnění. Marketingové připomínky vyžadují odpovídající souhlas a zpracování odhlášení.

## Zkontroluj celou cestu

Ověř, že se událost v Brew zobrazuje, že navázaná automatizace je aktivní a že historie jejích běhů ukazuje očekávaného příjemce a výsledek. Pak si prohlédni doručený e-mail a odkaz na fakturaci. Pokud událost dorazila, ale žádná zpráva neodešla, zkontroluj filtry, blokované adresy a připravenost odesílací domény dřív, než usoudíš, že selhal webhook.

Začni jednou událostí a jedním otestovaným e-mailem. Pozdější připomínky přidávej, až když kontroly aktuálního stavu i chování při opakování pokrývají testy tvé aplikace.