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

# Brevo

> Přidejte Brevo do svého projektu v Macaly

Brevo (dříve Sendinblue) je platforma pro e-mailový marketing, která zahrnuje i SMS, kampaně na WhatsAppu a integrovaný CRM. Pokud potřebujete víc než jen newslettery, Brevo spojuje několik komunikačních kanálů do jednoho nástroje.

<Note>
  **Potřebujete vůbec Brevo?** Macaly má [integrovanou databázi](/cs/features/databases) a e-mailové notifikace. Pokud chcete jen kontaktní formulář nebo waitlist, externí nástroj možná ani není potřeba. Brevo se vyplatí, když chcete posílat newslettery, automatizované sekvence, SMS kampaně nebo potřebujete CRM pro správu kontaktů.
</Note>

## Proč používat Brevo

* **Posílejte newslettery a marketingové e-maily.** Použijte vizuální editor nebo HTML šablony bez úprav kódu.
* **Zautomatizujte své e-maily.** Vytvářejte uvítací série, e-maily k opuštěnému košíku a reaktivační kampaně, které běží samy.
* **Oslovujte lidi napříč kanály.** Posílejte e-mailové, SMS i WhatsApp kampaně z jedné platformy.
* **Spravujte kontakty bez samostatného CRM.** Sledujte obchody a segmentujte své publikum, to vše na jednom místě.

## Co budete potřebovat

Než začnete, ujistěte se, že máte:

* **Účet Brevo**. Zdarma si ho vytvoříte na [brevo.com](https://www.brevo.com)
* **Seznam kontaktů** v Brevu, do kterého budete odběratele sbírat

Brevo můžete s webem propojit dvěma způsoby:

* **Vložený registrační formulář.** Vložíte na web kód formuláře, který Brevo vygeneruje. Nejlepší možnost pro jednoduchý sběr e-mailů.
* **Brevo API.** Propojíte své formuláře s API Breva pro plnou kontrolu nad tím, jaká data posíláte. Ideální řešení, když chcete vlastní formuláře, které ladí s vaším designem.

## Možnost 1: Vložený registrační formulář

Nejjednodušší cesta. Brevo vygeneruje formulář, který vložíte na web.

<Steps>
  <Step title="Získejte kód pro vložení formuláře">
    V Brevu přejděte na **Contacts** a poté **Forms**. Vytvořte nový registrační formulář (nebo použijte existující), upravte ho a zkopírujte kód pro vložení.
  </Step>

  <Step title="Požádejte agenta o přidání">
    Otevřete chat ve svém projektu v Macaly a požádejte:

    ```
    Přidej na můj web tento registrační formulář Brevo. Tady je kód:

    [sem vložte kód z Breva]
    ```
  </Step>

  <Step title="Agent umístí formulář">
    Agent přidá formulář do projektu. Řekněte mu, kam ho chcete: do patičky, postranního panelu, na samostatnou stránku nebo do popupu.
  </Step>
</Steps>

<Tip>
  Pokud chcete, aby formulář ladil s designem webu, řekněte agentovi: *„Uprav styl Brevo formuláře, ať sedí ke zbytku webu."*
</Tip>

## Možnost 2: Vlastní formulář přes Brevo API

Pro větší kontrolu může agent vytvořit vlastní formulář, který posílá odběratele do Breva přes jeho API.

<Steps>
  <Step title="Přidejte přihlašovací údaje Breva do Secrets">
    V projektu v Macaly přejděte do **Settings** a poté **Secrets**. Přidejte dva secrety:

    * `BREVO_API_KEY` — váš API klíč Breva
    * `BREVO_LIST_ID` — seznam kontaktů, do kterého chcete odběratele přidávat

    <Accordion title="Jak najít API klíč a list ID">
      **API klíč:**

      1. V Brevu klikněte vpravo nahoře na své jméno a poté **SMTP & API**
      2. Přejděte na záložku **API Keys**
      3. Klikněte na **Generate a new API key** a zkopírujte ho

      **List ID:**

      1. Přejděte na **Contacts** a poté **Lists**
      2. Klikněte na seznam, který chcete použít
      3. **List ID** najdete v URL a v detailech seznamu
    </Accordion>
  </Step>

  <Step title="Požádejte agenta o vytvoření formuláře">
    Otevřete chat a požádejte:

    ```
    Vytvoř v patičce registrační formulář k newsletteru. Když se někdo
    přihlásí, přidej ho do mého seznamu kontaktů v Brevu přes API.
    API klíč a list ID mám přidané v Secrets.
    ```
  </Step>
</Steps>

<Warning>
  Nikdy nevkládejte API klíče přímo do chatu. Citlivé údaje vždy ukládejte přes **Settings** a **Secrets**. Agent je odtud umí bezpečně načíst.
</Warning>

## Ověřte, že vše funguje

<Steps>
  <Step title="Odešlete testovací registraci">
    Navštivte svůj web a zadejte do registračního formuláře testovací e-mailovou adresu.
  </Step>

  <Step title="Zkontrolujte své kontakty v Brevu">
    V Brevu přejděte na **Contacts**. Váš testovací e-mail by se měl objevit v seznamu, který jste propojili.
  </Step>
</Steps>

## Dobré vědět

* Pokud potřebujete jen sbírat e-maily, [integrovaná databáze](/cs/features/databases) v Macaly je jednodušší a nevyžaduje externí účet
* Kvůli souladu s GDPR zapněte v nastavení formuláře v Brevu **double opt-in**
* API Breva umí posílat i transakční e-maily (potvrzení objednávky, reset hesla). Pokud je potřebujete, řekněte agentovi