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

> Adiciona o Brevo ao teu projeto Macaly

O Brevo (antigo Sendinblue) é uma plataforma de email marketing que também inclui SMS, campanhas de WhatsApp e um CRM integrado. Se precisares de mais do que apenas newsletters, o Brevo reúne vários canais de comunicação numa só ferramenta.

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

<Note>
  **Precisas mesmo do Brevo?** O Macaly tem uma [base de dados integrada](/docs/pt/features/databases) e notificações por email. Se só precisares de um formulário de contacto ou de uma lista de espera, não precisas de uma ferramenta externa. O Brevo vale a pena quando precisas de newsletters, sequências automatizadas, campanhas de SMS ou de um CRM para gerir os teus contactos.
</Note>

## Porquê usar o Brevo

* **Envia newsletters e emails de marketing.** Usa o editor de arrastar e largar ou modelos HTML sem tocar em código.
* **Automatiza os teus seguimentos.** Cria séries de boas-vindas, emails de carrinho abandonado e campanhas de reativação que funcionam sozinhas.
* **Chega às pessoas em vários canais.** Envia campanhas de email, SMS e WhatsApp a partir da mesma plataforma.
* **Gere contactos sem um CRM separado.** Acompanha negócios e segmenta o teu público, tudo num só lugar.

## O que precisas

Antes de começares, garante que tens:

* Uma **conta Brevo**. Cria uma gratuitamente em [brevo.com](https://www.brevo.com)
* Uma **lista de contactos** no Brevo para recolher subscritores

Há duas formas de ligar o Brevo ao teu site:

* **Formulário de subscrição incorporado.** Cola no teu site o código do formulário gerado pelo Brevo. Ideal para uma recolha simples de emails.
* **API do Brevo.** Liga os teus formulários à API do Brevo para teres controlo total sobre os dados que envias. Ideal quando queres formulários personalizados que combinem com o teu design.

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

A abordagem mais simples. O Brevo gera um formulário que podes incorporar no teu site.

<Steps>
  <Step title="Obtém o código de incorporação do formulário">
    No Brevo, vai a **Contacts** e depois a **Forms**. Cria um novo formulário de subscrição (ou usa um já existente), personaliza-o e copia o código de incorporação.
  </Step>

  <Step title="Pede ao agente para o adicionar">
    Abre o chat no teu projeto Macaly e pede:

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

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

  <Step title="O agente posiciona o formulário">
    O agente adiciona o formulário ao teu projeto. Diz-lhe onde o queres: rodapé, barra lateral, página dedicada ou um popup.
  </Step>
</Steps>

<Tip>
  Se quiseres que o formulário combine com o design do teu site, diz ao agente: *"Adapta o estilo do formulário do Brevo ao resto do meu site."*
</Tip>

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

Para mais controlo, o agente pode criar um formulário personalizado que envia subscritores para o Brevo através da respetiva API.

<Steps>
  <Step title="Adiciona as tuas credenciais do Brevo aos Segredos">
    Vai a **Definições** e depois a **Segredos** no teu projeto Macaly. Adiciona dois segredos:

    * `BREVO_API_KEY`, a tua chave API do Brevo
    * `BREVO_LIST_ID`, a lista de contactos à qual queres adicionar subscritores

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

      1. No Brevo, clica no teu nome no canto superior direito e depois em **SMTP & API**
      2. Vai ao separador **API Keys**
      3. Clica em **Generate a new API key** e copia-a

      **ID da lista:**

      1. Vai a **Contacts** e depois a **Lists**
      2. Clica na lista que queres usar
      3. O teu **List ID** aparece no URL e nos detalhes da lista
    </Accordion>
  </Step>

  <Step title="Pede ao agente para criar o formulário">
    Abre o chat e pede:

    ```
    Cria um formulário de subscrição da newsletter no rodapé. Quando
    alguém se subscrever, adiciona-o à minha lista de contactos do
    Brevo usando a API. Já adicionei a minha chave API e o ID da
    lista aos Segredos.
    ```
  </Step>
</Steps>

<Warning>
  Nunca coles chaves API diretamente no chat. Usa sempre **Definições** e depois **Segredos** para guardar credenciais sensíveis. O agente consegue lê-las a partir daí em segurança.
</Warning>

## Verifica que está a funcionar

<Steps>
  <Step title="Envia uma subscrição de teste">
    Visita o teu site e introduz um endereço de email de teste no formulário de subscrição.
  </Step>

  <Step title="Verifica os teus contactos no Brevo">
    Vai a **Contacts** no Brevo. O teu email de teste deve aparecer na lista que ligaste.
  </Step>
</Steps>

## Boa a saber

* Se só precisares de recolher emails, a [base de dados integrada](/docs/pt/features/databases) do Macaly é mais simples e não requer uma conta externa
* Para conformidade com o RGPD, ativa o **double opt-in** nas definições do teu formulário do Brevo
* A API do Brevo também consegue enviar emails transacionais (confirmações de encomenda, reposição de palavra-passe). Pede ao agente se também precisares desses


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