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

> Adicione o Brevo ao seu projeto no Macaly

O Brevo (antes chamado de Sendinblue) é uma plataforma de e-mail marketing que também inclui SMS, campanhas de WhatsApp e um CRM integrado. Se você precisa de mais do que newsletters, o Brevo reúne vários canais de comunicação em uma única ferramenta.

<Callout icon="user">
  Disponível em todos os planos
</Callout>

<Note>
  **Você realmente precisa do Brevo?** O Macaly tem um [banco de dados integrado](/docs/pt-BR/features/databases) e notificações por e-mail. Se você só precisa de um formulário de contato ou de uma lista de espera, não precisa de uma ferramenta externa. O Brevo vale a pena quando você precisa de newsletters, sequências automatizadas, campanhas por SMS ou um CRM para gerenciar seus contatos.
</Note>

## Por que usar o Brevo

* **Envie newsletters e e-mails de marketing.** Use o editor de arrastar e soltar ou modelos em HTML sem mexer em código.
* **Automatize seus acompanhamentos.** Crie séries de boas-vindas, e-mails de carrinho abandonado e campanhas de reengajamento que funcionam sozinhas.
* **Alcance as pessoas em vários canais.** Envie campanhas de e-mail, SMS e WhatsApp da mesma plataforma.
* **Gerencie contatos sem um CRM separado.** Acompanhe negócios e segmente seu público em um só lugar.

## O que você precisa

Antes de começar, confira se você tem:

* Uma **conta no Brevo**. Crie uma gratuitamente em [brevo.com](https://www.brevo.com)
* Uma **lista de contatos** no Brevo para reunir os inscritos

Há duas formas de conectar o Brevo ao seu site:

* **Formulário de inscrição incorporado.** Cole no seu site o código do formulário gerado pelo Brevo. Ideal para uma coleta de e-mails simples.
* **API do Brevo.** Conecte seus formulários à API do Brevo para ter controle total sobre os dados enviados. Ideal quando você quer formulários personalizados que combinem com o seu design.

## Opção 1: formulário de inscrição incorporado

A forma mais simples. O Brevo gera um formulário que você pode incorporar ao seu site.

<Steps>
  <Step title="Pegue o código de incorporação do formulário">
    No Brevo, vá em **Contatos** e depois em **Formulários**. Crie um novo formulário de inscrição (ou use um existente), personalize-o e copie o código de incorporação.
  </Step>

  <Step title="Peça ao agente para adicioná-lo">
    Abra o chat no seu projeto do Macaly e peça:

    ```
    Adicione este formulário de inscrição do Brevo ao meu site. Aqui está o código de incorporação:

    [cole aqui o seu código de incorporação do Brevo]
    ```
  </Step>

  <Step title="O agente posiciona o formulário">
    O agente adiciona o formulário ao seu projeto. Diga onde você quer que ele fique: rodapé, barra lateral, página dedicada ou pop-up.
  </Step>
</Steps>

<Tip>
  Se quiser que o formulário combine com o design do seu site, diga ao agente: *"Estilize o formulário do Brevo para combinar com o resto do meu site."*
</Tip>

## Opção 2: formulário personalizado com a API do Brevo

Para ter mais controle, o agente pode criar um formulário personalizado que envia os inscritos ao Brevo pela API.

<Steps>
  <Step title="Adicione suas credenciais do Brevo em Segredos">
    Vá em **Configurações** e depois em **Segredos** no seu projeto do Macaly. Adicione dois segredos:

    * `BREVO_API_KEY`: sua chave de API do Brevo
    * `BREVO_LIST_ID`: a lista de contatos à qual você quer adicionar os inscritos

    <Accordion title="Como encontrar sua chave de API e o ID da lista">
      **Chave de API:**

      1. No Brevo, clique no seu nome no canto superior direito e depois em **SMTP e API**
      2. Vá para a aba **Chaves de API**
      3. Clique em **Gerar uma nova chave de API** e copie-a

      **ID da lista:**

      1. Vá em **Contatos** e depois em **Listas**
      2. Clique na lista que você quer usar
      3. O **ID da lista** aparece na URL e nos detalhes da lista
    </Accordion>
  </Step>

  <Step title="Peça ao agente para criar o formulário">
    Abra o chat e peça:

    ```
    Crie um formulário de inscrição na newsletter no rodapé. Quando alguém se inscrever,
    adicione a pessoa à minha lista de contatos do Brevo usando a API.
    Já adicionei minha chave de API e o ID da lista em Segredos.
    ```
  </Step>
</Steps>

<Warning>
  Nunca cole chaves de API diretamente no chat. Use sempre **Configurações** e depois **Segredos** para guardar credenciais sensíveis. O agente consegue lê-las de lá com segurança.
</Warning>

## Confira se está funcionando

<Steps>
  <Step title="Faça uma inscrição de teste">
    Acesse seu site e digite um e-mail de teste no formulário de inscrição.
  </Step>

  <Step title="Confira seus contatos no Brevo">
    Vá em **Contatos** no Brevo. Seu e-mail de teste deve aparecer na lista que você conectou.
  </Step>
</Steps>

## Bom saber

* Se você só precisa coletar e-mails, o [banco de dados integrado](/docs/pt-BR/features/databases) do Macaly é mais simples e não exige uma conta externa
* Para estar em conformidade com o GDPR, ative o **double opt-in** nas configurações do formulário do Brevo
* A API do Brevo também pode enviar e-mails transacionais (confirmações de pedido, redefinições de senha). Peça ao agente se precisar deles também


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