Go

Envía tu primer correo electrónico desde Go en tres pasos: instala el SDK, escribe un handler que envíe y ejecútalo. Este inicio rápido usa net/http de la biblioteca estándar, sin necesidad de un framework.

1. Instalar

Ejemplo de código

go mod init example.com/bird-quickstart
go get github.com/messagebird/bird-sdk-go

El SDK requiere Go 1.24+. Obtén una clave API en Developers > Claves API en el dashboard y expórtala; el SDK infiere la región a partir del prefijo bk_us1_ / bk_eu1_ de la clave, así que no necesitas configurar nada más:

Ejemplo de código

export BIRD_API_KEY="bk_us1_..."

2. Enviar

Crea main.go con un handler HTTP que envíe a través del dominio de incorporación compartido de Bird, así no necesitas verificar un dominio:

Ejemplo de código

package main

import (
	"encoding/json"
	"errors"
	"log"
	"net/http"
	"os"

	bird "github.com/messagebird/bird-sdk-go"
	"github.com/messagebird/bird-sdk-go/option"
)

func main() {
	client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
	if err != nil {
		log.Fatal(err)
	}

	http.HandleFunc("POST /send", func(w http.ResponseWriter, r *http.Request) {
		msg, err := client.Email.Send(r.Context(), bird.EmailSendParams{
			From:    "onboarding@messagebird.dev",
			To:      []string{"delivered@messagebird.dev"},
			Subject: "Hello from Bird",
			HTML:    "<p>My first Bird email.</p>",
		})
		if err != nil {
			var apiErr *bird.APIError
			if errors.As(err, &apiErr) {
				http.Error(w, apiErr.Error(), apiErr.StatusCode)
				return
			}
			http.Error(w, err.Error(), http.StatusInternalServerError)
			return
		}
		w.Header().Set("Content-Type", "application/json")
		w.WriteHeader(http.StatusAccepted)
		_ = json.NewEncoder(w).Encode(msg)
	})

	log.Fatal(http.ListenAndServe(":3000", nil))
}

El SDK genera una clave de idempotencia por cada llamada a Send y la reutiliza al reintentar tiempos de espera, respuestas 429 y respuestas 5xx. Por lo tanto, un reintento no genera un segundo envío.

3. Probarlo

Ejemplo de código

go run . &
curl -X POST localhost:3000/send

Bird responde con 202, aceptando el correo electrónico para entrega asíncrona, y el handler devuelve el mensaje. Los campos *_count rastrean a los destinatarios a lo largo de los estados de entrega. En la respuesta inicial, un destinatario está aceptado y ninguno entregado:

Ejemplo de código

{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted",
  "category": "marketing",
  "from": { "email": "onboarding@messagebird.dev" },
  "to": [{ "email": "delivered@messagebird.dev" }],
  "subject": "Hello from Bird",
  "accepted_count": 1,
  "processed_count": 0,
  "delivered_count": 0,
  "deferred_count": 0,
  "bounced_count": 0,
  "complained_count": 0,
  "rejected_count": 0,
  "open_count": 0,
  "click_count": 0,
  "track_opens": true,
  "track_clicks": true,
  "created_at": "2026-07-23T13:58:20.866Z"
}

Como el destinatario es la dirección sandbox delivered@messagebird.dev, la entrega está garantizada. Obtén el mensaje por su ID em_ con client.Email.Get y observa cómo el estado cambia a delivered.

Próximos pasos

Referencia del SDK de Go: cada método, parámetro y tipo de error.
Envía tu primer correo electrónico: el mismo flujo con curl y el dashboard.
Dominios de envío: verifica tu propio dominio para envío en producción.
Referencia de API de email: el esquema completo de solicitud y respuesta.

Recursos relacionados

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Ver la guíaTesting email without spamming anyone Explorar la funcionalidadTest email delivery Seguir la ruta de aprendizajeOperate messaging reliably

Prueba el ejercicio y obtén un resumen de implementación