Broadcasts

Envía correos masivos a tus suscriptores.

Enviar Broadcast

Endpoint: POST /api/v1/broadcast
Autenticación: Secret Key (sdk_...)

Parámetros de Petición

Campo	Tipo	Requerido	Descripción
subject	string	Sí	Asunto del correo.
template	string	Sí	Nombre de la plantilla.
filter	object	No	Filtrar destinatarios.

Filtrar Destinatarios

{
  "filter": {
    "status": "confirmed", // active, pending, unsubscribed
    "source": "landing_page" // Coincide con metadata.source
  }
}

Importante

Tu HTML DEBE incluir {{unsubscribe_link}}. Generamos una URL única para cada usuario.

Ejemplo con Plantilla

curl -X POST https://senddock.dev/api/v1/broadcast \
  -H "Authorization: Bearer sdk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Noticias Semanales",
    "template": "newsletter",
    "filter": { "status": "active" }
  }'

Ejemplo con HTML Puro

curl -X POST https://senddock.dev/api/v1/broadcast \
  -H "Authorization: Bearer sdk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Novedades de Noviembre",
    "html": "<h1>Hola {{name}}!</h1><p>...</p><a href=\"{{unsubscribe_link}}\">Cancelar suscripción</a>",
    "filter": { "status": "confirmed" }
  }'

Respuesta (202 Accepted)

{
  "success": true,
  "data": {
    "message": "Broadcast started successfully. We are processing it in the background.",
    "broadcastId": "bc_17098234_clxxx..."
  }
}

Ejemplos de Código

Node.js

await fetch('https://senddock.dev/api/v1/broadcast', {
  method: 'POST',
  headers: { 
    'Authorization': 'Bearer sdk_tu_secret_key',
    'Content-Type': 'application/json' 
  },
  body: JSON.stringify({
    template: 'weekly-digest',
    subject: 'Noticias Tech',
    filter: { status: 'active' }
  })
});

Python

import requests

url = "https://senddock.dev/api/v1/broadcast"
headers = {
    "Authorization": "Bearer sdk_tu_secret_key",
    "Content-Type": "application/json"
}
payload = {
    "template": "weekly-digest",
    "subject": "Noticias Tech",
    "filter": {"status": "active"}
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Go

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	url := "https://senddock.dev/api/v1/broadcast"
	payload := map[string]interface{}{
		"template": "weekly-digest",
		"subject":  "Noticias Tech",
		"filter":   map[string]string{"status": "active"},
	}
	jsonData, _ := json.Marshal(payload)

	req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
	req.Header.Set("Authorization", "Bearer sdk_tu_secret_key")
	req.Header.Set("Content-Type", "application/json")

	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
	fmt.Println("Status:", resp.Status)
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SendBroadcast {
    public static void main(String[] args) throws Exception {
        String json = """
            {
                "template": "weekly-digest",
                "subject": "Noticias Tech",
                "filter": { "status": "active" }
            }
        """;

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://senddock.dev/api/v1/broadcast"))
            .header("Authorization", "Bearer sdk_tu_secret_key")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
    }
}