Docs / SDK / Go / Marketing

Go — módulo Marketing

🚧 En proceso de liberación  El paquete marketing ya existe en el SDK de Go, pero el servidor real de /v1/marketing todavía no está desplegado. El código y los ejemplos de esta página siguen la especificación publicada (listas, segmentos y campañas) como borrador adelantado — los paths y payloads pueden cambiar cuando se construya la API real.

Es un producto distinto al correo transaccional (ver Mail): marketing agrupa envíos masivos a listas/segmentos con plantillas, programación y métricas por campaña.

import (
    "github.com/webability/webability-go/wa"
    "github.com/webability/webability-go/marketing"
)

api := wa.New("tu-client-id", "tu-token-secreto")
mkt := marketing.New(api)

list, err := mkt.CreateList("Clientes Pro", "Lista principal")
// list.ID, list.Name

lists, err := mkt.ListLists()
got, err := mkt.GetList(list.ID)
err = mkt.DeleteList(list.ID)

contact, err := mkt.CreateContact(marketing.Contact{
    Email: "cliente@dominio.com", FirstName: "Ana", Tags: []string{"pro", "mx"},
})
err = mkt.AddContactToList(list.ID, contact.Email)
err = mkt.RemoveContactFromList(list.ID, contact.Email)

seg, err := mkt.CreateSegment(marketing.Segment{
    Name: "México",
    Filters: []marketing.SegmentFilter{
        {Field: "country", Op: "eq", Value: "MX"},
    },
})

cmp, err := mkt.CreateCampaign(marketing.Campaign{
    Name: "Newsletter Enero", FromName: "Tu Empresa", FromEmail: "news@tuempresa.com",
    Subject: "Novedades de enero", ListID: list.ID, HTML: "<h1>Hola {{first_name}}</h1>",
})

got, err := mkt.GetCampaign(cmp.ID)

// envío inmediato:
err = mkt.SendCampaign(cmp.ID, "")
// o programado (RFC3339):
err = mkt.SendCampaign(cmp.ID, "2026-01-10T15:00:00-06:00")

stats, err := mkt.GetCampaignStats(cmp.ID)
// stats.Delivered, stats.Opens, stats.Clicks, stats.Bounces, stats.Unsubscribes

err = mkt.DeleteCampaign(cmp.ID)