1. Escolher o provedor
Em Configurações → Canais → Email, a tela mostra um card para cada provedor liberado na sua conta. Clique em Configurar no provedor desejado.
Um provedor por vez fica ativo: é o último que você salvou, marcado como Ativo no card. Salvar outro provedor passa o envio para ele. O provedor ativo vale para todos os e-mails da conta: API, automações e campanhas.
Os provedores disponíveis são liberados por conta. Se o que você usa não aparecer, fale com a OctaSend.
Depois de preencher, clique em Testar Conexão para validar as credenciais e em Salvar. Credenciais já salvas voltam mascaradas na tela: deixe o campo como está para manter o valor guardado, ou digite um novo para trocá-lo.
- Amazon SES
- SMTP
- SendGrid
- SendPulse
Testar Conexão confere as credenciais na região informada, sem enviar e-mail. Exige também o Email do Remetente preenchido. Mensagens de erro: “Access Key ID inválido”, “Secret Access Key incorreto”, “Credenciais AWS inválidas” e “Preencha todos os campos obrigatórios”.
2. Templates de header e rodapé
Em Configurações → Templates de Email você monta o header e o rodapé que envolvem o corpo dos e-mails.- Abas por idioma — a aba Padrão (todos os idiomas) vale para qualquer idioma. Use + Adicionar idioma para criar versões específicas (ex.: um header em inglês para
en). - Vários templates por idioma — cada aba tem as listas Templates de Header e Templates de Footer, com o botão Novo template. A estrela marca o padrão daquele idioma.
- Editor — cada template tem nome, editor visual de arrastar e soltar e prévia ao vivo. No header, a opção Centralizar imagens automaticamente centraliza todas as imagens dele nos e-mails enviados.
- Ações — Salvar template, Definir como padrão e Remover. O último template de um idioma não pode ser removido.
Qual header e rodapé vão em cada e-mail
No template de e-mail de cada comunicação, os campos Header do email e Footer do email têm três opções:
No mesmo lugar, o campo Design system define qual design system o corpo segue: Padrão do tenant, Nenhum ou um design system escolhido. No Builder, o corpo usa as cores e fontes da marca e também a seção E-mail do design system: largura, cor de fundo do e-mail, cor de fundo do conteúdo e cor dos links. Um valor definido nas Configurações do e-mail do próprio template vale por cima do design system; apague o valor do campo para voltar a seguir o design system. Templates criados antes disso mantêm os valores que já tinham.
3. Criar o corpo do e-mail
Cada comunicação tem seu próprio editor de e-mail: Texto simples ou Builder (visual), com a opção Importar do Claude Design. O corpo é montado dentro do header e do rodapé escolhidos e aceita variáveis{{var}} em qualquer campo de texto. Veja Comunicações.
Logo abaixo do Assunto fica o campo Preheader: o texto de prévia que a caixa de entrada mostra ao lado do assunto. Ele aceita variáveis {{var}} e vale para e-mails com HTML.
- Se o HTML já trazia um preheader oculto (por exemplo, num layout importado), ele é trocado pelo texto do campo, para a prévia não sair duplicada.
- Blocos visíveis do e-mail não são alterados, mesmo que usem uma classe de preheader, como o “Ver no navegador” de layouts do Mailchimp.
- Com o campo vazio, o e-mail sai como está.
4. Enviar
recipient.emailé obrigatório para o canal. Sem ele, o e-mail não é enviado; se você pediu o canal explicitamente emchannels, o resultado vem comoskippedcom o campo que faltou.- Se o canal não estiver configurado, o envio nem começa: o resultado vem como
skippedcom o erroCanal não configurado, e nada é registrado em Logs.
5. Entrega, aberturas e cliques
E-mails com HTML são rastreados automaticamente: um pixel invisível registra a abertura e os linkshttp e https passam por um redirecionamento que registra o clique antes de levar ao destino. Os resultados aparecem no detalhe do envio, em Logs de Mensagens, em três marcas, cada uma com a sua data:
Na API de Consultar logs, as três marcas estão nos campos
delivered_at, read_at e clicked_at.
- Links
mailto:,tel:esms:, âncoras (#secao) e endereços relativos ficam como estão: abrem direto e não contam como clique.
- Acessos nos primeiros 15 segundos após o envio são ignorados — nesse intervalo, quem acessa costuma ser o verificador automático do servidor de e-mail, não uma pessoa.
- Acessos de scanners de segurança conhecidos (como os de proteção de links de e-mail corporativo) são ignorados. O cache de imagens de webmails como o Gmail conta como abertura, porque só busca o pixel quando a pessoa abre a mensagem. A abertura no Outlook para Windows também conta.
6. Descadastro
O descadastro vale para os e-mails de marketing. Mensagens transacionais, sobre um pedido ou a conta do próprio contato, continuam chegando a quem se descadastrou. Os e-mails de marketing saem com uma linha de descadastro no fim da mensagem: “Não quer mais receber estes e-mails? Descadastre-se”. Nas campanhas, a linha sai em português; nos demais, segue o idioma da mensagem (português, inglês ou espanhol). A linha também entra na versão em texto do e-mail.- O link abre uma página que pede confirmação. Só o clique em Confirmar descadastro descadastra a pessoa: abrir o link sozinho não muda nada, então antivírus e pré-visualizadores de link não descadastram ninguém.
- Pelo SendGrid e pelo SMTP, os e-mails de marketing também levam os cabeçalhos de descadastro em um clique (
List-UnsubscribeeList-Unsubscribe-Post), usados por Gmail e Yahoo para mostrar a opção de cancelar a inscrição. Pelo Amazon SES e pela SendPulse, levam só a linha no rodapé. - Quando um e-mail de marketing não sai porque o contato se descadastrou, o envio fica Ignorada no log, com o motivo “Contato descadastrado”. Veja o descadastro de cada contato em Contatos.
E-mails enviados pela API (
send-message com o access token) não levam a linha de descadastro, nem com respect_opt_out: true. Com respect_opt_out: true, o e-mail para um contato descadastrado não sai e volta com status: "skipped". Se você usa a API para marketing, oferecer o descadastro é responsabilidade do seu sistema. Veja Descadastro de contatos.