Audiencias

Listas de contactos para marketing y segmentación (`publiq.audiences`).

El recurso audiences representa listas de contactos usadas para marketing y segmentación: crea una audiencia para agrupar contactos y lista las audiencias de la organización.

Referencia de métodos

`audiences.create`

audiences.create(params) → Promise<Audience>

Crea una nueva audiencia (lista de contactos). La audiencia nace vacía — agrégale contactos después de crearla.

Parámetros

Parámetro	Tipo	Descripción
`name`Obligatorio	`string`	Nombre de la audiencia (1 a 200 caracteres).

Devuelve: La audiencia creada — { object: "audience", id, name, ... }.

const audience = await publiq.audiences.create({
name: 'Newsletter subscribers',
});
console.log(audience.id, audience.name); // "aud_...", "Newsletter subscribers"

Las audiencias guardan contactos y son el objetivo de los broadcasts. Ver Contactos para agregar contactos y Broadcasts para enviar campañas. Para subconjuntos basados en reglas dentro de una audiencia, ver Segmentos.

`audiences.list`

audiences.list() → Promise<AudienceList>

Lista todas las audiencias de la organización. Sin parámetros — no hay paginación por cursor aquí, solo el alcance de la organización.

Devuelve: Envoltura de lista { object: "list", data: Audience[] } con las audiencias de la organización.

const { data } = await publiq.audiences.list();
for (const audience of data) {
console.log(audience.id, audience.name);
}

Los ejemplos muestran Node, Python y PHP. En Python los métodos son snake_case (ej.: cancel_run, from_spec) y reciben un dict; en PHP son camelCase y reciben un array asociativo. Las claves del cuerpo siempre son camelCase (templateKey, firstName, scheduledAt) — las respuestas de la API vienen en snake_case.