Esta funcionalidad conecta SenseData con Zenvia Customer Cloud (Zenvia Customer Cloud) para sincronizar automáticamente tus contactos y su información todos los días. Tú eliges qué contactos enviar y qué información transferir de un sistema al otro. Utiliza esta funcionalidad para que tus campañas y flujos de mensajes en Zenvia Customer Cloud utilicen datos de SenseData siempre actualizados, sin necesidad de realizar tareas manuales.
Cómo funciona:
Creas la conexión en 5 pasos y confirmas la configuración en la pantalla Resumen.
Todas las noches, a partir de las 00:00, el sistema envía los contactos válidos a Zenvia Customer Cloud (ventana prevista: de 00:00 a 05:00).
En la lista de conexiones, puedes consultar cuántos contactos se enviaron y cuántos no se enviaron. También puedes descargar la lista de errores desde la pestaña Resultados.
💡Tip: El envío no se realiza en tiempo real. Al crear una conexión, el primer envío se realiza durante la siguiente ventana nocturna. Los cambios realizados en SenseData también se envían a Zenvia Customer Cloud durante esa ventana.
2. Antes de comenzar
Esta funcionalidad está disponible para los perfiles SenseData y Administrador. Si no ves el menú, ponte en contacto con el administrador de tu cuenta. El menú Conexión Zenvia Customer Cloud solo aparece cuando está habilitado el parámetro general correspondiente.
Para habilitarlo:
En SenseData, ve al menú Configuración.
Haz clic en Parámetros generales.
Haz clic en la pestaña Feature Flag.
Busca la opción Conexión Zenvia Customer Cloud y actívala.
Una vez habilitada, tendrás acceso a la opción del conector. Después de activar la feature flag, asegúrate de tener a mano la siguiente información:
El token de acceso a la API de tu cuenta de Zenvia. Puedes encontrarlo en la configuración de tu cuenta de Zenvia (la propia pantalla de creación incluye un enlace a esa página).
Los criterios que definen qué clientes y contactos deseas enviar (por ejemplo, clientes con estado "Activo").
La lista de campos de información de SenseData que deseas transferir a Zenvia Customer Cloud.
El estado de los campos personalizados de tu cuenta de Zenvia Customer Cloud. Si tu cuenta ya utiliza muchos campos (más de 97), es posible que se rechace la autenticación del token (consulta la sección 6).
⚠️ Atención: Guarda el token en un lugar seguro. Volverás a necesitarlo cuando crees una nueva conexión a partir de una existente.
3. Dónde encontrarla
Configuración > Conexión Zenvia Customer Cloud
La pantalla Conexión con Zenvia Customer Cloud muestra todas tus conexiones. Si todavía no has configurado ninguna, aparecerá el mensaje Ninguna conexión configurada y el botón Nueva conexión.
4. Instrucciones paso a paso
4.1. Cómo consultar tus conexiones
Accede a Configuración > Conexión Zenvia Customer Cloud.
En la tabla, consulta cada conexión, el estado del último envío y las cantidades de contactos (total, enviados y no enviados).
Utiliza la paginación, en la parte inferior de la pantalla, para ver más conexiones. En el campo Mostrar, elige cuántas conexiones deseas ver por página (10, 20 o 30).
4.2. Cómo crear una conexión
La creación se realiza en 5 pasos, que aparecen en la parte superior de la pantalla: Autenticación, Público objetivo, Campos básicos, Campos personalizados y Resumen. Los pasos completados se marcan con un ✔.
Paso 1: Autenticación
Accede a Configuración > Conexión Zenvia Customer Cloud.
Haz clic en Nueva conexión.
Completa el campo Nombre de la conexión.
El campo Tipo ya viene configurado como XAPIToken y no se puede modificar.
Completa el campo Token.
Haz clic en Validar y espera el mensaje Token válido.
Haz clic en Continuar.
💡Tip: Pasa el cursor sobre el icono de ayuda (?) situado junto a Token. Allí se explica dónde encontrar la información y se incluye el enlace Acceder a la configuración →, que te lleva a la configuración de tu cuenta de Zenvia.
El botón Continuar solo se habilita después de validar el token.
El sistema valida el token y comprueba cuántos campos personalizados utiliza actualmente tu cuenta de Zenvia Customer Cloud. Si la cuenta tiene demasiados campos para que la conexión pueda ajustarse al límite disponible, se rechazará la validación (consulta la sección 7).
Paso 2: Público objetivo
Completa el campo Nombre del envío (obligatorio, hasta 120 caracteres). Este nombre identifica la conexión en la columna Público definido de la lista.
En el Grupo A, define la primera regla seleccionando Categoría, Campo, Operación y Valor. Ejemplo: Cliente > Estado > igual a > Activo.
Para añadir otra condición al mismo grupo, haz clic en Añadir regla. Dentro de un grupo, el contacto debe cumplir todas las reglas.
Para crear otro conjunto de condiciones, haz clic en Añadir grupo.
Si hay más de un grupo, elige Y u O para definir cómo se combinan.
Haz clic en Buscar contactos. El sistema valida los contactos y muestra:
La franja verde Listos para el envío, con la cantidad de contactos y clientes que se enviarán.
La franja amarilla Error de envío, con la cantidad de contactos y clientes que no podrán enviarse.
(Opcional) Haz clic en Ver →, en cualquiera de las franjas, para consultar los clientes identificados (consulta la sección 5.3).
Haz clic en Continuar.
💡Tip: Si cambias las reglas después de realizar la búsqueda, las franjas se deshabilitarán y aparecerá el aviso Condiciones modificadas. Vuelve a buscar los contactos haciendo clic en Buscar contactos.
Paso 3: Campos básicos
En la tabla, consulta los campos de Zenvia Customer Cloud, sus categorías y los campos de SenseData de los que se obtendrá cada dato.
Los campos obligatorios ya vienen seleccionados y no se pueden desmarcar.
Para cada campo opcional que desees enviar, selecciona la Categoría y, en la columna SenseData, elige el campo de origen. La casilla se marcará cuando el mapeo esté completo.
(Opcional) Haz clic en Desmarcar todos los campos para borrar la selección de los campos opcionales.
Haz clic en Continuar.
Paso 4: Campos personalizados
Selecciona los campos adicionales que deseas transferir a Zenvia Customer Cloud.
Para cada campo, selecciona la Categoría y, en la columna SenseData, elige el campo de origen. La casilla se marcará cuando el mapeo esté completo.
Consulta el contador Campos seleccionados (por ejemplo, 45 de 97).
Utiliza la paginación, en la parte inferior de la tabla, para ver todos los campos. Utiliza Buscar para localizar un campo específico.
Haz clic en Continuar.
Paso 5: Resumen
Revisa las secciones Credenciales de acceso, Público objetivo, Campos básicos y Campos personalizados.
Para modificar algún dato, haz clic en Volver hasta llegar al paso correspondiente.
Cuando todo esté correcto, haz clic en Conectar.
Espera el mensaje Conexión guardada correctamente. El sistema volverá a la lista de conexiones.
La conexión se guarda y aparece en la lista con el estado Activo y el envío Pendiente. El primer envío se realiza durante la siguiente ventana nocturna. Después de ese envío, el estado cambia a Completado. La conexión puede tardar unos instantes en aparecer en la lista.
💡Tip: El resultado del envío aparece en la columna Envío. El sistema no envía notificaciones cuando el proceso finaliza.
4.3. Cómo crear una nueva conexión a partir de una existente
Utiliza esta opción para reutilizar la configuración de una conexión existente y modificar únicamente lo necesario:
En la lista de conexiones, haz clic en el icono ⋮ de la columna Acciones, en la fila de la conexión deseada.
Haz clic en Crear nueva a partir de esta plantilla.
La nueva conexión se abre con los campos rellenados previamente y el nombre termina en "copia".
En el paso Autenticación, introduce el token nuevamente y valídalo.
Realiza los ajustes necesarios en los demás pasos y haz clic en Conectar en la pantalla Resumen.
Cuando la nueva conexión esté funcionando, elimina la conexión anterior (sección 4.6).
⚠️ Atención: El token no se copia a la nueva conexión. Debes introducirlo nuevamente.
Sobre las modificaciones: En esta versión, las conexiones guardadas no se pueden editar. Para modificar una conexión, utiliza Crear nueva a partir de esta plantilla y después elimina la conexión anterior.
4.4. Cómo consultar los detalles de una conexión
En la lista de conexiones, haz clic en la fila de la conexión deseada.
En la pestaña Información, consulta el tipo, el estado, el token (parcialmente oculto), el público objetivo y la cantidad de campos seleccionados.
Para consultar el mapeo de campos, haz clic en 06/06 Ver lista → (campos básicos) o 45/97 Ver lista → (campos personalizados). Se abrirá el panel Campos.
Para cerrar el panel, haz clic en X.
4.5. Cómo consultar los resultados y descargar la lista de errores
En la lista de conexiones, consulta las columnas Total de contactos, Contactos enviados y Contactos no enviados.
Para ver los detalles, haz clic en la conexión y abre la pestaña Resultados.
Consulta Total sincronizados, Correctos y Con errores, incluidos los porcentajes.
Para identificar los contactos que tuvieron problemas, haz clic en Descargar lista, dentro del recuadro Con errores.
Espera mientras el sistema genera un enlace seguro. El archivo CSV se abrirá en una nueva pestaña del navegador.
⚠️ Atención: La lista de errores solo se puede descargar desde la pestaña Resultados. Esta opción no está disponible en la tabla principal.
💡Tip: Los números de la pestaña Resultados abarcan todo el período transcurrido desde la creación de la conexión.
La lista de errores indica el motivo por el que no se envió cada contacto. El enlace de descarga es válido durante 5 minutos. Si caduca, haz clic nuevamente en Descargar lista. Los encabezados de las columnas siguen el idioma de la persona que creó la conexión (portugués, inglés o español). Si corriges en SenseData un contacto que tenía un error, este dejará de aparecer en la lista de errores en la siguiente ejecución.
4.6. Cómo desactivar, reactivar o eliminar una conexión
En la lista de conexiones, haz clic en el icono ⋮ de la columna Acciones, en la fila de la conexión deseada.
Selecciona Desactivar (o Activar, si la conexión está inactiva) o Eliminar.
Confirma la acción en la ventana que aparece. La activación no requiere confirmación.