Serviço de envio de e-mail (SMTP)
O conector de e-mail envia pelo seu próprio servidor SMTP — o RooQuiz não faz o repasse. Por isso, as notificações chegam do seu próprio endereço e não há limite de envio da plataforma.
Configure-o uma única vez por equipe em Configurações → Equipe → Envio de e-mail. Todos os conectores de e-mail da equipe o utilizam.
Sem um serviço de envio verificado, o conector de e-mail ainda é salvo, mas nunca entrega nada. O cartão dele mostra uma tag vermelha "Sem serviço de envio".
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 |
A porta 25 não pode ser usada. Nossa plataforma de hospedagem bloqueia conexões de saída nessa porta. Use 587 ou 465.
Configuração por provedor
| 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. Ela é exibida uma única vez, em quatro grupos de quatro caracteres — remova os espaços antes de colá-la.
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.
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.
Salvar e verificar
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
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.
Confirme que o status mostra "Verificado"
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 algum conector de e-mail ainda estiver ativado, 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.
Os cinco canais
Os cinco canais de conectores — e-mail pelo seu próprio SMTP, Webhook, Slack, Zapier e Kit: o que cada um entrega, os destinatários e o formato de mensagem que você define e um conector por canal.
Eventos de gatilho e escopo
Cada conector é acionado por eventos de gatilho e limitado por um escopo — quais quizzes podem acioná-lo. As duas valem juntas: veja o que significa cada evento e como restringir a quizzes específicos.