Saltar al contenido
Documentación para desarrolladores Guías prácticas Soporte Solicitar demo Iniciar sesión
Pushwoosh.com

Importar contactos

Sube un único archivo CSV para registrar contactos como suscriptores en correo electrónico, SMS, WhatsApp y Viber a la vez. Asigna cada columna que contenga una dirección de contacto al canal al que pertenece. La misma columna, como un número de teléfono, se puede asignar a más de un canal, por lo que ya no necesitas un archivo separado para los números de SMS y WhatsApp que son el mismo número.

Prepara tu archivo CSV

Anchor link to

Reglas de formato CSV

Anchor link to

Estructura general

Anchor link to
  • La primera fila debe contener los encabezados de las columnas que describen los datos en cada columna.
  • Cada fila subsiguiente representa un único contacto, con valores correspondientes a los encabezados.
  • Los valores deben estar separados por comas.
  • Guarda el archivo en codificación UTF-8 para asegurar la correcta visualización de los caracteres.
  • El tamaño máximo del archivo es de 100 MB.

Columnas de contacto

Anchor link to

Incluye al menos una de las siguientes columnas, dependiendo de los canales en los que quieras registrar el contacto:

  • Email: la dirección de correo electrónico del destinatario.
  • Número de teléfono (para SMS, WhatsApp y Viber): debe estar en formato internacional, comenzando con + seguido del código del país, por ejemplo +120XXXXX234. Introduce el número de teléfono sin formato. Pushwoosh añade internamente el prefijo whatsapp: o viber: una vez que asignas la columna a ese canal, así que no lo añadas tú mismo.

Un número de teléfono que no esté en un formato internacional válido se descarta para ese canal durante la importación, en lugar de hacer que falle toda la fila.

Columnas opcionales

Anchor link to
  • User ID: un identificador único para el usuario (p. ej., nombre o correo electrónico). No es obligatorio, pero se recomienda para que los canales del contacto compartan un perfil de usuario en lugar de varios.
  • Cualquier otra columna se puede asignar a una etiqueta del sistema para segmentación y personalización, por ejemplo Ubicación, Cumpleaños, Idioma o Tipo de cliente.

Archivo CSV de ejemplo

Anchor link to
Email,Mobile,User ID,Name,Location
john.smith@email.com,+120XXXXX234,john.smith@email.com,John Smith,New York
jane.smith@email.com,+131XXXXX890,jane.smith@email.com,Jane Smith,Los Angeles

Sube y asigna el archivo CSV

Anchor link to
  1. Ve a Audience → Import CSV → Import Contacts.

Centro de Importación de CSV en la sección de Audiencia que muestra la tarjeta de Importar Contactos junto con Actualizar valores de etiquetas, Importar suscriptores push, Importar eventos e Importar categorías de suscripción

  1. Haz clic en Upload CSV y selecciona tu archivo. Para reemplazarlo, haz clic en Upload Another CSV.

  2. Introduce un Segment name para los contactos importados.

  3. En Contact column in CSV, selecciona una columna y, junto a ella, elige el Channel en el que se registra (Email, SMS, WhatsApp o Viber). Haz clic en + Add channel para asignar otra columna, o para asignar la misma columna a un canal adicional.

  4. En UserId column in CSV, selecciona la columna con identificadores de usuario únicos, si tu archivo tiene una.

  5. Para incluir datos adicionales para la segmentación, selecciona un Column Name de tu CSV y asígnale una Tag. Haz clic en + Add Column para asignar más atributos.

Paso de asignación del asistente de Importación de Contactos con una columna asignada a Email, una columna de Móvil asignada a SMS, WhatsApp y Viber, y una columna de Ciudad asignada a una etiqueta

  1. Haz clic en Start Import para comenzar a procesar el archivo.

Después de la importación, los contactos están disponibles para campañas en los canales que asignaste. Aparecen como un nuevo segmento en la lista de Segmentos y también se puede acceder a ellos a través del User Explorer.

Filas omitidas durante la importación

Anchor link to

La pantalla de finalización agrupa las filas omitidas por motivo:

  • La dirección de correo electrónico no es válida
  • El número de teléfono no es válido
  • No hay dirección de contacto en la fila: cada columna asignada estaba vacía

Una fila puede ser importada parcialmente y aun así aparecer en este desglose. Por ejemplo, la columna de correo electrónico tiene éxito, pero la columna de teléfono falla la validación.

Haz clic en Download skipped rows para obtener un CSV solo de esas filas. El archivo añade el motivo de la omisión como una columna extra para que puedas corregir las filas y volver a subirlas.

Filas que la importación no pudo registrar

Anchor link to

Algunas filas parecen correctas en el archivo pero aun así no se procesan. Por ejemplo, una dirección de correo electrónico puede estar escrita correctamente y aun así ser rechazada porque pertenece a un dominio desechable o que ha rebotado. Pushwoosh cuenta filas como esta como Fallidas, por separado de las Añadidas u Omitidas.

Las filas fallidas no se desglosan por motivo y no se incluyen en la descarga de filas omitidas. Para encontrarlas, compara tu CSV de origen con el segmento importado. Corrige las direcciones que faltan (por ejemplo, elimina un dominio desechable o que ha rebotado), luego vuelve a subir solo esas filas en una nueva importación.