Añadir contactos a una audiencia en bloque
Mete hasta 200 contactos en una audiencia en una sola llamada, por dirección. Como el alta individual, acepta direcciones que ya están en la libreta del espacio de trabajo y nunca crea un contacto: una dirección que no lo es vuelve en `missing` y no se escribe nada para ella, mientras que el resto de la llamada sigue adelante.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
POST /audiences/{id}/contacts/batch
Mete hasta 200 contactos en una audiencia en una sola llamada, por dirección. Como el alta individual, acepta direcciones que ya están en la libreta del espacio de trabajo y nunca crea un contacto: una dirección que no lo es vuelve en missing y no se escribe nada para ella, mientras que el resto de la llamada sigue adelante.
Ejemplo
Necesita audiences:write. emails contiene de 1 a 200 direcciones, recortadas y en minúsculas antes de buscarlas.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/batch" -H "$AUTH" -H 'content-type: application/json' -d '{ "emails": ["[email protected]", "[email protected]", "[email protected]"]}'{ "object": "audience_batch", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "added": 1, "unchanged": 1, "missing": ["[email protected]"]}added cuenta las membresías nuevas, unchanged los contactos que ya estaban en la audiencia, y missing lista las direcciones que no son contactos, en minúsculas y sin repeticiones. Guárdalas con POST /contacts, o envíalas a POST /audiences/{id}/import, que las crea.
Se puede repetir sin riesgo. Una segunda llamada idéntica no añade nada y devuelve a todos como unchanged. Añadir a la audiencia por defecto responde siempre added: 0, porque todos los contactos ya están en ella.
Un emails vacío, más de 200 direcciones o cualquier otra clave en el cuerpo es un 422, y no se escribe nada.