# Serviço de envio de e-mail

Source: https://docs.rooquiz.com/pt-BR/connectors/email-smtp

> Configure os serviços de envio pelos quais sai o e-mail da sua equipe — uma conta do Gmail conectada ou o seu próprio servidor SMTP — para que conectores e e-mails a respondentes cheguem do seu endereço. Limites por plano, configuração e verificação.

Os e-mails da sua equipe — as notificações do [conector de e-mail](https://docs.rooquiz.com/pt-BR/connectors/channels) e os e-mails que você envia aos respondentes — saem pelos **seus próprios serviços de envio**. O RooQuiz não faz o repasse, então as mensagens chegam do seu próprio endereço.

Configure-os em **Configurações → Equipe → Envio de e-mail**. Somente o proprietário e os administradores da equipe podem gerenciar os serviços de envio.

| Plano    | Serviços de envio por equipe |
| -------- | ---------------------------- |
| **Free** | 1                            |
| **Pro**  | Até 3                        |

Contas do Gmail e servidores SMTP ocupam as mesmas vagas. Cada conector de e-mail escolhe um deles em **Serviço de envio**.

<Callout type="warning">
  Um conector de e-mail sem um serviço de envio **verificado** ainda é salvo, mas nunca entrega nada. O cartão dele mostra uma tag vermelha "Sem serviço de envio".
</Callout>

## Opção 1: Conectar Gmail (recomendado para Gmail)

Clique em **Conectar Gmail** e autorize o acesso na janela do Google. Não há SMTP para configurar e **nenhuma senha de app** — o RooQuiz recebe apenas permissão para enviar e-mails; ele não consegue ler a sua caixa de entrada.

* Cada conta do Gmail envia **até 500 e-mails por dia** pelo RooQuiz. E-mails em massa para respondentes que passarem disso ficam em pausa e **continuam automaticamente no dia seguinte**; notificações de conectores acima desse limite falham até o dia seguinte.
* **Testar** envia uma mensagem da conta do Gmail para o seu próprio endereço.
* Se o status mostrar **Precisa reconectar**, clique em **Reconectar** e autorize novamente.
* Para enviar de outro endereço do Gmail, conecte outra conta do Gmail.

<Callout type="info">
  **Desconectar** exclui o acesso do RooQuiz a essa conta do Gmail. Desative antes os conectores de e-mail que a utilizam.
</Callout>

## Opção 2: Adicionar servidor SMTP

Clique em **Adicionar servidor SMTP** para enviar pelo SMTP do seu provedor — útil para usar o domínio da sua marca por meio de um serviço como o Resend, ou o servidor de e-mail da sua empresa.

### O que preencher

| Campo                     | Observações                                                                                 |
| ------------------------- | ------------------------------------------------------------------------------------------- |
| **Servidor SMTP**         | O hostname do seu provedor, por exemplo `smtp.gmail.com`                                    |
| **Porta**                 | `587` (STARTTLS), `465` (SSL/TLS) ou `2525`                                                 |
| **Usuário**               | Normalmente o seu endereço de e-mail completo; alguns provedores usam um valor fixo         |
| **Senha**                 | A senha SMTP ou a chave de API. Ao editar depois, deixe em branco para manter a senha salva |
| **Endereço do remetente** | Precisa ser um endereço que o seu servidor SMTP tenha permissão para usar como remetente    |
| **Nome do remetente**     | Nome de exibição mostrado aos destinatários                                                 |
| **Endereço de resposta**  | Opcional, caso as respostas devam ir para outro lugar                                       |

<Callout type="info">
  **A porta 25 não pode ser usada.** Nossa plataforma de hospedagem bloqueia conexões de saída nessa porta. Use 587 ou 465.
</Callout>

### Configuração por provedor

<Tabs items="['Resend', 'Servidor de e-mail da empresa', 'Gmail (alternativa via SMTP)']">
  <Tab value="Resend">
    | Campo                 | Valor                                                        |
    | --------------------- | ------------------------------------------------------------ |
    | Servidor SMTP         | `smtp.resend.com`                                            |
    | Porta                 | `587 (STARTTLS)`                                             |
    | Usuário               | `resend` — a palavra literal                                 |
    | Senha                 | Uma chave de API do Resend (`re_…`)                          |
    | Endereço do remetente | Qualquer endereço em um domínio que você verificou no Resend |

    Esta é a opção mais simples se você quer que as notificações venham do **domínio da sua própria marca** em vez de uma caixa de e-mail pessoal, e não há limite diário como o do Gmail.
  </Tab>

  <Tab value="Servidor de e-mail da empresa">
    Peça a quem administra o e-mail da empresa o **hostname SMTP, a porta e as credenciais**. Prefira a porta 587 com STARTTLS; use a 465 se for a única oferecida.

    Dois pontos costumam causar problemas:

    * O usuário geralmente é o **endereço completo da caixa de e-mail**, não apenas a parte antes do `@`.
    * O **endereço do remetente precisa pertencer ao seu próprio domínio**. A maioria dos servidores corporativos se recusa a repassar e-mails que dizem vir de outro lugar.
  </Tab>

  <Tab value="Gmail (alternativa via SMTP)">
    Prefira **Conectar Gmail** acima — não precisa de senha de app. Use o SMTP apenas se não puder usar a conexão com o Google.

    | Campo                 | Valor                                                                         |
    | --------------------- | ----------------------------------------------------------------------------- |
    | Servidor SMTP         | `smtp.gmail.com`                                                              |
    | Porta                 | `587 (STARTTLS)`                                                              |
    | Usuário               | Seu endereço completo do Gmail                                                |
    | Senha                 | Uma **senha de app de 16 caracteres**                                         |
    | Endereço do remetente | O **mesmo** endereço do Gmail, ou um alias verificado em "Enviar e-mail como" |

    Crie a senha de app em [myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords). Ela é exibida uma única vez, em quatro grupos de quatro caracteres — **remova os espaços** antes de colá-la.

    <Callout type="warning">
      A senha normal da sua conta não funciona. O Google desativou o login com senha para clientes de e-mail, então é obrigatório usar uma senha de app — e as senhas de app só existem depois que a **Verificação em duas etapas** é ativada.
    </Callout>

    Se essa página disser *"A configuração que você está procurando não está disponível para sua conta"*, um destes casos se aplica: a Verificação em duas etapas está desativada; é uma conta do Google Workspace cujo administrador desativou as senhas de app; ou a conta está inscrita no Programa Proteção Avançada, que as bloqueia completamente.

    O Gmail também limita o envio a cerca de **500 destinatários por dia** em contas pessoais e **2.000** no Workspace. É mais do que suficiente para notificações da equipe, mas não para envios em massa.
  </Tab>
</Tabs>

## Salvar e verificar

Esta seção e a seguinte se aplicam a servidores SMTP; uma conexão com o Gmail é verificada pelo login do Google.

<Steps>
  ### Preencha os campos e clique em "Salvar e verificar"

  Salvar e verificar são uma única ação, então você nunca fica com uma configuração salva, mas não testada.

  ### Procure o e-mail de teste na caixa de entrada

  <Callout type="warning">
    O e-mail de teste vai para **o endereço da sua própria conta RooQuiz** — aquele com o qual você está conectado — e **não** para o endereço do remetente que acabou de configurar. Se nada chegar, verifique essa caixa de entrada e a pasta de spam antes de mudar qualquer coisa.
  </Callout>

  ### Confirme que o status mostra "Verificado"
</Steps>

**Verificado** significa que o seu servidor SMTP aceitou a mensagem e retornou um código de sucesso. Isso não é o mesmo que entregue: um servidor SMTP primeiro aceita a mensagem e só depois a encaminha, então ela ainda pode ser filtrada como spam ou devolvida mais tarde. Se a verificação der certo, mas nada chegar, o problema está do lado de quem recebe — comece pela pasta de spam e depois procure uma devolução (bounce) na caixa de e-mail de onde você está enviando.

## Quando a verificação falha

O **erro exato do seu servidor SMTP** é exibido na página, propositalmente sem alterações, para que você possa agir diretamente sobre ele. Os mais comuns:

| Erro                                             | O que significa                                                                                                                              |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `535 Username and Password not accepted`         | Credenciais incorretas. No Gmail: você usou a senha da conta em vez de uma senha de app, ou deixou espaços nela                              |
| `553 Sender address rejected: not owned by user` | O endereço do remetente não é um que este servidor possa usar. Troque-o por uma caixa de e-mail ou alias que a conta realmente possua        |
| `550 relay not permitted`                        | O servidor não faz repasse para você de jeito nenhum — geralmente o usuário está errado ou o acesso SMTP não está ativado na caixa de e-mail |
| Tempo esgotado / falha na conexão                | Hostname ou porta incorretos, ou o servidor não aceita conexões de fora da sua rede                                                          |

## Bom saber

* A senha **nunca mais é exibida** depois de salva. Deixe o campo em branco ao editar qualquer outra coisa, e ela permanece intacta.
* Alterar o servidor, a porta, o usuário, a senha ou o endereço do remetente volta o status para **Não verificado** até a próxima verificação bem-sucedida.
* Salvar e verificar tem **limite de frequência** de algumas tentativas por hora por equipe — cada uma realmente se conecta ao seu servidor e realmente envia uma mensagem.
* **Remover** o serviço de envio exclui a senha armazenada. Você não precisa removê-lo para mudar as configurações — basta salvar por cima. A remoção é recusada enquanto um conector de e-mail **ativado** ainda usar esse serviço de envio, para que você não interrompa suas próprias entregas sem perceber.
* Se uma entrega posterior falhar de forma permanente — as credenciais deixam de funcionar ou o endereço do remetente é rejeitado —, o status muda para **Falha na verificação** e os conectores de e-mail param de entregar até você corrigir. Um único endereço de destinatário inválido **não** causa isso; apenas aquela mensagem falha.
