Importar contactos a una audiencia
La importación CSV de la página de la audiencia, a través de la API. Cada dirección bien formada se convierte en contacto si aún no lo es, y todas acaban en esta audiencia, hasta 500 filas por llamada. Envía una lista más larga en varias llamadas.
Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.
POST /audiences/{id}/import
La importación CSV de la página de la audiencia, a través de la API. Cada dirección bien formada se convierte en contacto si aún no lo es, y todas acaban en esta audiencia, hasta 500 filas por llamada. Envía una lista más larga en varias llamadas.
Ejemplo
Necesita audiences:write y contacts:write, porque crea contactos. Cada fila es un email y un name opcional de hasta 200 caracteres.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/import" -H "$AUTH" -H 'content-type: application/json' -d '{ "contacts": [ { "email": "[email protected]", "name": "Grace Hopper" }, { "email": "[email protected]", "name": "Katherine Johnson" }, { "email": "not-an-address" } ]}'{ "object": "audience_import", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "created": 1, "added": 1, "skipped": 1, "invalid": ["not-an-address"]}created cuenta los contactos nuevos, added las membresías nuevas en esta audiencia, y skipped las filas que no se importaron. invalid lista las direcciones mal formadas tal como se enviaron. Un contacto nuevo se guarda como manual y también se une a la audiencia por defecto.
Una dirección que ya es contacto se reutiliza, nunca se duplica, y conserva su nombre: un name aquí solo rellena uno vacío. Una dirección que se eliminó de la libreta vuelve a ser contacto, y la misma dirección dos veces en una llamada cuenta una vez.
Se puede repetir sin riesgo: una segunda llamada idéntica no crea nada ni añade nada. No se envía nada a nadie y nadie queda suscrito a nada.