# Contactos (SyBox)

Dónde: Configuración > Equipo y clientes > Contactos

Para qué sirve:

Esta pantalla importa clientes desde un archivo CSV o Excel, exporta tus clientes a un archivo CSV, sincroniza los nombres de los clientes desde Contactos de Google y limpia los contactos que nunca enviaron ni recibieron ningún mensaje.

Quién puede abrirlo:

Los usuarios que tienen el permiso "Administrar la configuración de la organización". Para importar también se necesita "Mostrar el número del contacto". Para exportar también se necesitan "Ver el directorio de contactos" y "Mostrar el número del contacto".

### Cómo importar contactos desde un archivo

1. Ve a Configuración > Contactos. En "Importar contactos desde un archivo", haz clic en "Elegir un archivo".
2. Elige un archivo CSV o un archivo de Excel (.xlsx). Cada fila corresponde a un cliente. En un archivo de Excel, se lee la primera hoja. Un archivo puede contener hasta 20,000 filas. Un archivo CSV guardado desde Excel se lee correctamente, incluidos los nombres en árabe, tanto si se guardó como "CSV UTF-8" como en formato "CSV" normal.
3. Deja marcada la opción "La primera fila contiene los nombres de las columnas" si la primera fila tiene encabezados como "Nombre" y "Teléfono". Desmárcala si la primera fila ya corresponde a un cliente.
4. En "País de los números escritos sin código de país", elige el país de los números locales como 01001234567. Los números escritos con su código de país (+20…, 0020… o 20…) se leen tal como están. Al principio aparece seleccionado el país de tu espacio de trabajo.
5. En "Qué contiene cada columna", elige para cada columna su contenido: "Nombre", "Número de teléfono", "Correo", "Etiquetas", "Departamentos", uno de tus campos de contacto o "No importar". SyBox completa estos campos a partir de los títulos de las columnas cuando puede. Cada opción solo puede usarse en una columna. Es obligatorio incluir una columna de número de teléfono.
6. Para reemplazar los nombres y correos electrónicos que tus clientes ya tienen en SyBox, marca "Reemplazar los nombres y correos electrónicos que ya están guardados". De lo contrario, el nombre o correo importado solo completará los campos que estén vacíos. Para reemplazar datos se necesita el permiso "Editar contacto"; sin él, solo se completan los nombres y correos vacíos.
7. Haz clic en "Comprobar el archivo". Todavía no se guarda nada. Verás cuántos clientes son nuevos, cuántos ya están en SyBox y se actualizarán, y cuántas filas tienen algún problema. Una tabla muestra las primeras filas y todas las filas con problemas.
8. Haz clic en "Importar". Solo se guardan las filas aceptadas en la comprobación. El progreso se muestra mientras se ejecuta y, al terminar, aparece un resumen.
9. Para corregir las filas que no se importaron, haz clic en "Descargar las filas con algún problema", corrígelas en el archivo y vuelve a importarlo.

Qué hace la importación:

- Un número que ya existe en SyBox se actualiza. Nunca se añade por segunda vez, y su conversación e historial se mantienen intactos.
- Un número nuevo crea su propio cliente, listo para iniciar una conversación.
- Las etiquetas y los departamentos se suman a los que el cliente ya tiene; no se elimina nada. Escribe varios en una misma celda separados por comas, por ejemplo "VIP, El Cairo". Cada uno debe existir previamente con el mismo nombre (en cualquiera de los dos idiomas) en Configuración > Etiquetas o Configuración > Departamentos. Solo puedes añadir departamentos que tengas permiso para asignar. Las etiquetas y los departamentos requieren el permiso "Editar contacto", y las etiquetas requieren además "Asignar etiquetas al contacto"; sin ellos, esas columnas se omiten.
- Los campos de contacto siguen el tipo de cada campo: un número para un campo numérico, una fecha (2026-11-06 o 6/11/2026) para un campo de fecha, una de las opciones para una lista desplegable, y sí o no para un campo de sí / no.
- Una celda vacía nunca borra ningún dato.

Problemas que puede tener una fila:

- "No es un número de teléfono válido": el número está incompleto, o no tiene código de país y el país elegido no coincide con él.
- "Este número ya está en una fila anterior": el mismo cliente aparece dos veces en el archivo. Se importa la primera fila.
- "No hay ninguna etiqueta con este nombre" / "No hay ningún departamento con este nombre": el nombre del archivo no coincide con ninguna etiqueta ni departamento. El resto de la fila se importa igualmente.
- "No puedes añadir clientes a este departamento": tus permisos no te permiten asignarlo.
- "Este valor no corresponde al campo": la celda no se ajusta al tipo de ese campo de contacto. El resto de la fila se importa igualmente.
- "No es una dirección de correo electrónico válida": se omite el correo electrónico. El resto de la fila se importa igualmente.
- "Este cliente está fuera de las conversaciones que puedes ver": el número pertenece a un cliente que tus permisos no cubren. La fila no se importa.

### Cómo exportar tus contactos

1. Ve a Configuración > Contactos. En "Exportar contactos", haz clic en "Descargar CSV".
2. SyBox prepara el archivo y muestra cuántos contactos ha añadido hasta el momento. Luego, el archivo se descarga.
3. El archivo incluye una fila por cada cliente que tienes permiso para ver: el nombre, el número de teléfono, el correo electrónico, el canal, el país, las etiquetas, los departamentos, la fecha en que se añadió el cliente, la fecha del último mensaje y una columna por cada campo de contacto. Las fechas siguen el horario del país de tu espacio de trabajo.
4. Ábrelo en Excel o Google Sheets. Los números de teléfono se escriben con su código de país y sin el signo "+", por lo que un archivo exportado se puede volver a importar.

Sincronizar con Contactos de Google (si tu espacio de trabajo dispone de esta opción):

### Cómo conectar Contactos de Google

1. Ve a Configuración > Contactos.
   ![Settings, Contacts: the "Connect Google Contacts" button](https://www.sybox.io/res/sybox/help/es/connect-google-contacts-1.webp?v=31cdb100)
2. Haz clic en "Conectar contactos de Google".
3. Se te redirigirá a Google. Elige tu cuenta de Google y concede acceso a tus contactos.
4. Volverás a SyBox y el correo electrónico de Google conectado se mostrará con una marca de verificación verde.

### Cómo sincronizar

- "Sincronizar contactos ahora" importa todos los contactos de Google que tengan un número de teléfono internacional válido. Añade contactos nuevos y completa nombres. Nunca sobrescribe un nombre que tu equipo haya establecido en SyBox. Al finalizar verás "Contactos sincronizados" junto con el número de contactos.
- "Actualizar solo los nombres" solo completa los nombres faltantes para números que ya existen en tu espacio de trabajo. Nunca añade contactos nuevos. Usa esta opción si tu agenda de Google tiene muchos números personales que no quieres en SyBox. Al finalizar verás "Nombres actualizados" junto con el número de nombres.

### Cómo desconectar Contactos de Google

1. Haz clic en "Desconectar".
2. Lee el mensaje y confirma. SyBox dejará de sincronizar y su acceso también se revocará en Google.
3. Los contactos ya importados permanecerán en tu espacio de trabajo. Puedes volver a conectar en cualquier momento.

### Cómo eliminar contactos no usados

1. Haz clic en "Eliminar contactos no usados".
   ![Settings, Contacts: the red "Delete unused contacts" button](https://www.sybox.io/res/sybox/help/es/delete-unused-contacts-1.webp?v=8d36fa68)
2. SyBox cuenta los contactos que no tienen mensajes en ningún canal (WhatsApp, SMS, correo electrónico, Messenger, Instagram).
3. Si no hay ninguno, verás "Unused contacts deleted (0)" y nada cambiará.
4. Si los hay, la confirmación mostrará cuántos son. Confirma para eliminarlos.
5. Esta acción es permanente y no se puede deshacer.

**Q: ¿La sincronización con Contactos de Google cambiará los nombres que mi equipo ya ingresó?**

No. Los nombres introducidos por tu equipo nunca se sobrescriben.

**Q: Solo quiero los nombres de mis clientes actuales, no toda mi agenda.**

Usa "Actualizar solo los nombres".

**Q: No veo la sección de Contactos de Google.**

Solo aparece si tu espacio de trabajo cuenta con esta opción activada.

**Q: No veo "Importar contactos desde un archivo" ni "Exportar contactos".**

Para importar se necesita "Mostrar el número del contacto". Para exportar se necesitan "Ver el directorio de contactos" y "Mostrar el número del contacto". Pídeselos a tu administrador.

**Q: ¿La importación creará clientes duplicados?**

No. Si un número ya está en SyBox, se actualiza, incluso si en el archivo está escrito de otra forma (con espacios, con un 0 inicial o con 00 en lugar de +).

**Q: Mi archivo de Excel muestra los números de teléfono como 2.01E+11.**

Así es como Excel muestra un número largo en una columna estrecha. El número completo sigue estando en la celda y SyBox lo lee entero. Ensancha la columna para verlo.

Source: https://www.sybox.io/es/help/contacts