--- title: EmailSubscribe: inscrição description: Adicione inscrição em newsletter ou changelog a páginas de documentação com EmailSubscribe: captura nativa para sete provedores e embeds para os demais. --- > **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version. `` adiciona um formulário de inscrição por e-mail diretamente a uma página de documentação usando uma única tag MDX. Depois de [conectar um provedor](/pt/integrations/email-signups) no dashboard, ele renderiza um formulário hospedado pela Jamdesk que envia novos inscritos diretamente para seu público. Sem um provedor conectado, ele também pode hospedar o embed de outra plataforma. O componente foi criado para páginas de changelog e notas de versão, nas quais os leitores querem saber o que há de novo. ## Início rápido Conecte primeiro um provedor no dashboard e, em seguida, adicione a tag com o id desse provedor: ```mdx ``` Isso renderiza um campo de e-mail identificado e um botão Subscribe. Ao enviar, o endereço é adicionado ao público que você conectou. A mesma tag funciona com qualquer provedor nativo (`mailchimp`, `kit`, `loops`, `beehiiv`, `brevo` ou `sendgrid`) depois que ele for conectado. Adicione um título opcional e uma linha de apoio: ```mdx ``` ## Propriedades | Prop | Type | Purpose | |------|------|---------| | `provider` | string | Id do provedor: `resend`, `mailchimp`, `kit`, `loops`, `beehiiv`, `brevo`, `sendgrid`, `buttondown` ou `substack`. | | `title` | string | Título opcional exibido acima do formulário. | | `description` | string | Linha de apoio opcional abaixo do título. | | `collapsed` | boolean | Somente para provedores nativos. Começa como um botão Subscribe compacto que expande para o formulário completo ao ser clicado. | | `username` | string | Nome de usuário da conta Buttondown / Substack (provedores que aceitam apenas embed). | | `snippet` | string | Marcação bruta do embed de qualquer provedor. A alternativa flexível (veja abaixo). | | `className` | string | Classe CSS adicional no contêiner. | ## Nativo vs. embed O `provider` informado determina o comportamento do formulário: - **Provedores nativos** (`resend`, `mailchimp`, `kit`, `loops`, `beehiiv`, `brevo`, `sendgrid`) renderizam um formulário hospedado pela Jamdesk. A Jamdesk captura o endereço e o adiciona usando sua chave conectada. Esse é o caminho que exige um provedor [conectado no dashboard](/pt/integrations/email-signups). - **Provedores que aceitam apenas embed** (`buttondown`, `substack`) renderizam o próprio formulário ou iframe do serviço. Não é necessário conectar uma chave: informe seu `username` e o visitante enviará os dados diretamente ao provedor. Se você informar um provedor nativo que ainda não conectou no dashboard, o formulário não capturará os dados. Conecte primeiro o provedor para que os envios tenham um destino. ### Provedores que aceitam apenas embed Buttondown e Substack funcionam sem uma conexão com o dashboard. Informe o nome de usuário da sua conta: ```mdx ``` ### Alternativa flexível: cole qualquer embed Para um provedor que não tenha uma abreviação na Jamdesk, cole a marcação do embed em `snippet`. Ela será renderizada como está na página publicada: ```mdx ...`} /> ``` Um `snippet` executa o próprio código do provedor na sua página. Alguns provedores fornecem um script executado uma única vez, que não será executado novamente quando o leitor navegar entre páginas sem uma recarga completa. Coloque embeds baseados em script em uma página dedicada e carregada diretamente (como seu changelog), em vez de inseri-los no meio de um fluxo de navegação. ## Modo compacto Um campo de e-mail completo e um botão Subscribe ocupam bastante espaço quando inseridos no meio de uma página. Defina `collapsed` para que o formulário nativo comece apenas como um botão Subscribe. Quando o leitor clicar nele, o campo completo será exibido diretamente na página, sem recarregá-la: ```mdx ``` O rótulo do botão vem de `title` (ele usa "Subscribe to updates" como alternativa quando nenhum título é definido). Esse recurso funciona apenas com provedores nativos. Os provedores de embed renderizam a própria marcação, portanto a Jamdesk não tem nada para compactar. ## Inscritos recorrentes Depois que um leitor se inscreve por meio de um formulário nativo, o navegador se lembra disso. Na próxima visita, em vez do formulário completo, ele verá uma linha curta: *You're subscribed to the newsletter.* Ninguém será convidado a se inscrever novamente em algo que já assinou. Se quiser adicionar um segundo endereço, o leitor encontrará um controle "Use a different email?" que reabre o formulário completo imediatamente. Essa informação é armazenada por navegador (em `localStorage`, não no seu público); portanto, limpar os dados do site ou trocar de navegador fará o formulário aparecer novamente. Não é necessário configurar nada: todo formulário nativo funciona assim. ## Posicionamento automático em páginas de changelog Em vez de adicionar a tag manualmente a cada página de versão, monte o formulário automaticamente nas páginas de changelog. Em `docs.json`, defina `placement` como `changelog` na integração de newsletter: ```json { "integrations": { "newsletter": { "provider": "resend", "title": "Get release notes", "placement": "changelog" } } } ``` Com `placement: "changelog"`, o formulário é montado em todas as páginas de changelog (qualquer página com `rss: true`). Para ignorá-lo em uma dessas páginas, defina `newsletter: false` no frontmatter da página. Se uma página já tiver um `` adicionado manualmente, o posicionamento automático dará preferência a ele, evitando a exibição de dois formulários. O bloco completo `integrations.newsletter` aceita os mesmos campos do componente (`provider`, `title`, `description`, `collapsed`, `username`, `snippet`, `height`), além de `placement` (`none`, o valor padrão, ou `changelog`). Você não precisa definir o título e a linha de apoio em `docs.json`. O cartão **Email Signups** no dashboard tem os campos Form title e Form subtitle, e um formulário posicionado automaticamente usa esses valores quando `docs.json` não os informa. Defina `title`/`description` aqui somente quando quiser que o `docs.json` deste site tenha prioridade sobre o texto do dashboard. ## O que vem a seguir? Configure Resend, Mailchimp, Kit, Loops, beehiiv, Brevo ou SendGrid Escreva as entradas do changelog sobre as quais seus inscritos querem saber