Agenda

Los clientes de PBX virtual tienen acceso a una agenda simple para almacenar contactos, que se puede usar para integraciones de terceros.

Los contactos para los usuarios de vPBX son creados y gestionados automáticamente por el sistema, pero los administradores del cliente pueden agregar otros números externos a los contactos existentes.

Datos personales

Nombre

Nombre del contacto.

Apellido

Apellido del contacto.

Email

Email del contacto.

Teléfonos

Teléfono Trabajo

Número de trabajo externo público del contacto.

Teléfono Móvil

Número de móvil externo público del contacto.

Otro Teléfono

Número en formato libre del contacto (Extensión interna, Fax, etc)

Formato de importación CSV

Los contactos se pueden crear y actualizar de forma masiva con la opción Importar contactos del menú del listado de la Agenda. El diálogo describe el formato, ofrece una plantilla CSV descargable y muestra el resultado de cada línea. Solo se muestra a los administradores con permiso para crear y actualizar contactos.

El fichero puede estar codificado en UTF-8, con o sin BOM, o en Windows-1252, de modo que se aceptan tanto el formato CSV UTF-8 como el CSV normal de Excel. Su primera fila debe ser una cabecera con el nombre de las columnas, que se pueden separar con comas (,) o punto y coma (;).

Columna

Obligatoria

Notas

id

No

Con valor, se actualiza el contacto con ese id. Vacía o ausente, se crea un contacto nuevo.

name

Al crear

No puede quedar vacío. Máximo 100 caracteres.

lastname

No

Máximo 100 caracteres.

email

No

Dirección de email válida. Máximo 100 caracteres.

workPhoneCountry, mobilePhoneCountry

No

Código ISO del país (por ejemplo ES). Si hay teléfono y no hay país, se usa el país del cliente.

workPhone, mobilePhone

No

Número sin prefijo internacional. Máximo 20 caracteres.

otherPhone

No

Texto libre. Máximo 25 caracteres.

Fichero CSV de ejemplo

id,name,lastname,email,workPhoneCountry,workPhone,mobilePhoneCountry,mobilePhone,otherPhone
,Ana,García,ana@example.com,ES,944048182,ES,600000000,
,Juan,Pérez,,,,,,Fax 2010
,Marta,López,,,944000111,,,

La importación sigue estas reglas:

  • Una fila sin id siempre crea un contacto nuevo, aunque ya exista uno idéntico.

  • Una fila con id actualiza ese contacto. Si el id no existe o pertenece a otro cliente, la fila falla.

  • Una columna presente en la cabecera pero vacía en una fila borra el valor de ese campo.

  • Una columna que no está en la cabecera no se modifica al actualizar.

  • Los contactos vinculados a un usuario solo actualizan sus teléfonos y sus países: el nombre, los apellidos, el email y el otro teléfono se ignoran, ya que se mantienen sincronizados con el usuario.

  • Las filas válidas se guardan y las erróneas se informan con su número de línea en el fichero y el motivo.

Advertencia

Una vez corregidas, importa de nuevo solo las líneas fallidas. Importar otra vez el fichero completo duplicaría los contactos creados desde filas sin id.

Exportación CSV

La opción Exportar contactos del menú del listado de la Agenda descarga un fichero CSV con todos los contactos que cumplen los filtros activos, no solo los que se muestran en la página actual. Solo se muestra a los administradores con permiso para leer contactos.

El fichero está pensado para editarlo y volverlo a importar, así que tiene exactamente las columnas del formato de importación, en el mismo orden, y cada fila lleva su id. Los países se exportan como códigos ISO y los teléfonos sin prefijo internacional, tal como están guardados. Los contactos vinculados a un usuario se incluyen como el resto.

Está codificado en UTF-8 con BOM y usa punto y coma (;) como separador, de modo que se abre directamente en Excel conservando los acentos y las columnas.

Exportar, editar y volver a importar

  1. Exporta los contactos, filtrando antes el listado si solo algunos necesitan cambios.

  2. Edita los valores en el fichero exportado conservando la columna id: es lo que hace que la importación actualice cada contacto en lugar de crear uno nuevo.

  3. Importa el fichero con la opción Importar contactos. Los contactos que no se han cambiado se actualizan con sus propios valores, así que quedan como estaban.

Nota

Un teléfono guardado sin país se exporta con la columna de país vacía. Al importar de nuevo el fichero, ese teléfono toma el país del cliente, como cualquier teléfono sin país.