Introdução ao Gomail

O Gomail é um pacote simples e eficiente para enviar e-mails em Golang. Ele foi minuciosamente testado e documentado.

O Gomail só pode enviar e-mails utilizando servidores SMTP. No entanto, a API é flexível e pode facilmente implementar métodos como o uso de Postfix local, APIs, etc., para enviar e-mails.

Ele utiliza o gopkg.in para controle de versão, portanto, não haverá mudanças incompatíveis dentro de cada versão.

Ele requer o uso de Go 1.2 ou uma versão posterior. No Go 1.5, dependências externas não serão usadas.

Funcionalidades do Gomail

O Gomail suporta as seguintes funcionalidades:

  • Anexos
  • Imagens inline
  • Modelos HTML e texto
  • Codificação automática de caracteres especiais
  • SSL e TLS
  • Envio de vários e-mails usando a mesma conexão SMTP

Instalação

go get gopkg.in/gomail.v2

Exemplo

m := gomail.NewMessage()
m.SetHeader("From", "[email protected]")
m.SetHeader("To", "[email protected]", "[email protected]")
m.SetAddressHeader("Cc", "[email protected]", "Dan")
m.SetHeader("Subject", "Olá!")
m.SetBody("text/html", "Olá <b>Bob</b> e <i>Cora</i>!")
m.Attach("/home/Alex/lolcat.jpg")

d := gomail.NewDialer("smtp.example.com", 587, "user", "123456")

// Enviar um e-mail para Bob, Cora e Dan.
if err := d.DialAndSend(m); err != nil {
    panic(err)
}

Exemplo (Daemon)

Um daemon que escuta um canal e envia todas as mensagens recebidas.

ch := make(chan *gomail.Message)

go func() {
    d := gomail.NewDialer("smtp.example.com", 587, "user", "123456")

    var s gomail.SendCloser
    var err error
    open := false
    for {
        select {
        case m, ok := <-ch:
            if !ok {
                return
            }
            if !open {
                if s, err = d.Dial(); err != nil {
                    panic(err)
                }
                open = true
            }
            if err := gomail.Send(s, m); err != nil {
                log.Print(err)
            }
        // Fechar a conexão com o servidor SMTP se nenhum e-mail tiver sido enviado nos últimos 30 segundos.
        case <-time.After(30 * time.Second):
            if open {
                if err := s.Close(); err != nil {
                    panic(err)
                }
                open = false
            }
        }
    }
}()

// Enviar e-mails usando este canal no seu programa.

// Feche o canal para parar o daemon de e-mail.
close(ch)

Exemplo (Assinatura de e-mail)

Enviar efetivamente assinaturas personalizadas por e-mail para um grupo de destinatários.

// Lista de destinatários.
var list []struct {
    Nome    string
    Endereço string
}

d := gomail.NewDialer("smtp.example.com", 587, "user", "123456")
s, err := d.Dial()
if err != nil {
    panic(err)
}

m := gomail.NewMessage()
for _, r := range list {
    m.SetHeader("From", "[email protected]")
    m.SetAddressHeader("To", r.Endereço, r.Nome)
    m.SetHeader("Subject", "Boletim #1")
    m.SetBody("text/html", fmt.Sprintf("Olá %s!", r.Nome))

    if err := gomail.Send(s, m); err != nil {
        log.Printf("Não foi possível enviar e-mail para %q: %v", r.Endereço, err)
    }
    m.Reset()
}

Exemplo (Sem autenticação)

Enviar e-mails usando um servidor SMTP local.

m := gomail.NewMessage()
m.SetHeader("From", "[email protected]")
m.SetHeader("To", "[email protected]")
m.SetHeader("Subject", "Olá!")
m.SetBody("text/plain", "Olá!")

d := gomail.Dialer{Host: "localhost", Port: 587}
if err := d.DialAndSend(m); err != nil {
    panic(err)
}

Exemplo (Sem SMTP)

Envie e-mails usando a API ou postfix.

m := gomail.NewMessage()
m.SetHeader("From", "[email protected]")
m.SetHeader("To", "[email protected]")
m.SetHeader("Subject", "Olá!")
m.SetBody("text/plain", "Olá!")

s := gomail.SendFunc(func(from string, to []string, msg io.WriterTo) error {
    // Implemente sua função de envio de e-mail chamando uma API ou executando o postfix, etc.
    fmt.Println("De:", from)
    fmt.Println("Para:", to)
    return nil
})

if err := gomail.Send(s, m); err != nil {
    panic(err)
}

Perguntas Frequentes

x509: certificado assinado por autoridade desconhecida

Se você encontrar esse erro, significa que o cliente executando o Gomail considera o certificado usado pelo servidor SMTP como inválido. Como solução alternativa, você pode ignorar a validação da cadeia de certificados do servidor e o nome do host usando SetTLSConfig:

package main

import (
	"crypto/tls"
	
	"gopkg.in/gomail.v2"
)

func main() {
	d := gomail.NewDialer("smtp.example.com", 587, "usuário", "123456")
	d.TLSConfig = &tls.Config{InsecureSkipVerify: true}

    // Use d para enviar e-mails.
}

No entanto, observe que isso é inseguro e não deve ser usado em um ambiente de produção.