Joomla es un sistema de gestión de contenido de código abierto para administrar el contenido de sitios web. Utiliza un marco de modelo-vista-controlador, que se puede utilizar por sí solo para crear aplicaciones en línea sólidas. Puede instalar y configurar el paquete de Brevo en su sitio web Joomla para poder:

• Sincronizar sus usuarios y contactos con Brevo,
• Crear un formulario y añadirlo a su sitio web,
• Enviar emails transaccionales a través de Brevo,
• Realizar un seguimiento de la actividad de su sitio web.

Para conectar su cuenta de Brevo con su sitio web de Joomla, siga el procedimiento que se indica a continuación.

Antes de empezar

Reúna la siguiente información antes de la instalación:

• Las credenciales de su cuenta de Brevo.
• Su clave API v3. Para obtener más información, consulte nuestro artículo dedicado Crear o eliminar una clave API.
• Su contraseña SMTP. Para obtener más información, consulte nuestro artículo dedicado ¿ Qué es Brevo SMTP?.
• Acceso al panel de administración de su sitio web de Joomla.

Para aprovechar todas las funcionalidades del paquete, asegúrese de que su cuenta de Brevo se haya validado y de que pueda enviar emails tanto desde la plataforma de emails transaccionales como desde la de envío de campañas.

También puede encontrar el paquete de Brevo en el Directorio de Extensiones de Joomla.

Paso 1: Instalar y configurar el paquete de Brevo

El proceso que debe seguir es el mismo que para otros paquetes de Joomla. Una vez que inicie sesión en su back office de Joomla, haga clic en Extensions (Extensiones) > Manage (Administrar) > Install (Instalar).

El paquete de instalación:

• Añadirá archivos y tablas a su sitio web.
• Creará una pestaña de Brevo en el menú de Componentes.
• Creará elementos de submenú correspondientes a las diferentes secciones del componente Brevo.

En la página de instalación, en función de los plugins de instalación activados, dispone de cuatro opciones de instalación:

1. Instalar desde la web
2. Cargar el paquete
3. Instalar desde una carpeta
4. Instalar desde una URL

1. Instalar desde la web

Si su sitio web tiene activada la función de "Instalar desde la web", vaya a la pestaña de Instalar desde la web y, a continuación, escriba "Brevo" en el cuadro de búsqueda. Haga clic en el título del paquete para abrir la lista y luego haga clic en el botón Install (Instalar). Una vez confirmado, el paquete se instalará automáticamente.

2. Cargar el paquete

• Descargue el paquete desde aquí: https://github.com/brevo/joomla-plugin/tree/master/build/J3/package
• Seleccione la última versión disponible del paquete y haga clic en «Descargar» para guardar el paquete en su ordenador.
• Cuando haya terminado la descarga, cargue el archivo.

3. Instalar desde una carpeta

Si ha descargado el paquete de instalación en una carpeta específica de su servidor, puede utilizar esta opción de instalación. Introduzca la ruta del archivo para esa carpeta específica, luego haga clic en el botón Check and install (Verificar e instalar). Joomla intentará automáticamente abrir el paquete y ejecutar la instalación.

4. Instalar desde una URL

Usando esta opción, tiene que proporcionar a Joomla el enlace URL directo del paquete de instalación.  El enlace de instalación del dispositivo es: https://raw.github.com/brevo/joomla-plugin/master/build/J3/package/pkg_sendinblue_v1_0_0.zip

Una vez que haya hecho clic en el botón Check and Install (Comprobar e instalar), Joomla intentará abrir el paquete automáticamente para ejecutar la instalación:

Cómo configurar el componente de Brevo

En primer lugar, siga este tutorial para copiar su clave API v3 desde su cuenta de Brevo.

Luego vaya a su administrador de Joomla, haga clic en Components (Componentes) > Brevo. En el panel de control de Brevo, seleccione el icono de API key settings (Configuración de clave API).

Pegue su clave API v3 en el cuadro de texto.

Haga clic en el botón Save (Guardar)que hay en la parte superior.  A continuación, verá los datos de su cuenta de Brevo en su panel de control. Si no ve sus datos, es probable que no esté utilizando una clave API válida.

Cómo configurar las opciones avanzadas

Le recomendamos que no modifique los valores predeterminados en las opciones avanzadas. Si quiere editar los parámetros del componente a nivel general, haga clic en el botón Options (Opciones) que hay en la esquina superior derecha de su panel de control.

Desde esta página, podrá editar:

1. Configuración general

• Base URL (URL básica): es la URL utilizada para todas las llamadas API. Debe dejarse con el valor predeterminado.
• Connection timeout (seconds) (Tiempo de espera de la conexión [segundos]): si tiene problemas de conectividad, pruebe a aumentar este valor.

2. Configuración avanzada

• Opt-in template link tag (Etiqueta de enlace de la plantilla de consentimento): es la etiqueta utilizada en las plantillas de email de Brevo
• Double opt-in attribute name (Nombre del atributo de confirmación doble): el nombre del atributo de Brevo que se utilizará en el proceso de confirmación
• Opt-in link validity period (minutes) (Periodo de validez del enlace de consentimento [minutos]): el tiempo que un suscriptor tendrá para confirmar su suscripción
• Double opt-in temporary folder & double opt-in temporary list (Carpeta temporal de confirmación doble y lista temporal de confirmación doble): se utilizan para almacenar datos sobre un suscriptor de forma temporal hasta que confirme su suscripción

Paso 2: sincronizar usuarios y contactos con Brevo

Vaya a su administrador de Joomla, luego al panel de control de Brevo. Seleccione el icono Export contacts (Exportar contactos) .

• La funcionalidad le permitirá exportar el usuario/contacto de Joomla y sus datos (p. ej. direcciones de email y nombres).
• Tenga en cuenta que el identificador único de un usuario/contacto es su dirección de email.

En el lado izquierdo, elegirá las opciones de exportación para sus usuarios y contactos de Joomla. En el lado derecho, elegirá a qué lista(s) de Brevo se agregarán, así como la forma de administrar los usuarios/contactos existentes.

1. Exportar usuarios de Joomla

Establezca "Yes" (Sí) o "No" para cada opción.

• Export all user groups (Exportar todos los grupos de usuarios)
• Al seleccionar "Yes" (Sí), todos los grupos de usuarios se añadirán a Brevo.
• Al seleccionar "No", tiene la opción de elegir grupos de usuarios específicos que se agregarán a Brevo.
• Export blocked (Exportación bloqueada): "No" está seleccionado de forma predeterminada, lo que significa que los usuarios bloqueados no se agregan a Brevo.  Si selecciona "Sí", todos los contactos bloqueados se añadirán a Brevo.
• Export ungrouped (Exportar desagrupados): "No" está seleccionado de forma predeterminada. Esto significa que todos los usuarios que no estén asignados a ningún grupo de usuarios no se añadirán a Brevo. Si selecciona "Yes" (Sí), se añadirán a Brevo.

2. Exportar contactos de Joomla

Establezca "Yes" (Sí) o "No" para cada opción.

• Export all contacts categories (Exportar todas las categorías de contactos)
• Al seleccionar "Yes" (Sí), se añadirán a Brevo todas las categorías de contactos.
• Al seleccionar "No", tiene la opción de seleccionar la categoría de contactos que se añadirá a Brevo.
• Export unpublished (Exportar no publicados): "No" está seleccionado de forma predeterminada. Lo que significa que todos los contactos no publicados no se agregarán a Brevo. Si selecciona "Yes" (Sí), se añadirán a Brevo.

3. Opciones de listas

• Export mode (Modo de exportación): determina qué hacer con los contactos que ya existen en Brevo
• "Add to lists" (Añadir a listas): el usuario/contacto permanecerá en sus listas existentes de Brevo, además de añadirse a todas las listas recién seleccionadas.
• "Reassign to lists" (Reasignar a listas): el usuario/contacto se eliminará de sus listas existentes de Brevo y, en su lugar, se agregará a todas las listas recién seleccionadas.
• Use all lists (Usar todas las listas)
• Al seleccionar "Yes" (Sí), sus usuarios/contactos de Joomla se añadirán a todas sus listas de Brevo.
• Al seleccionar "No", tiene la opción de elegir la(s) lista(s) de Brevo donde se añadirán sus usuarios/contactos de Joomla. Las opciones de la lista aparecerán en el campo desplegable.

Ejemplo:

Nuestro contacto, example@brevo.com está actualmente en la List1, List2 y List3.

Si están en un grupo que se va a añadir a List1, List3 y List4, entonces:

• si el modo de exportación está configurado en "add to lists" (añadir a listas): example@brevo.com suscribirá a los cuatro: List1, List2, List3 y List4.
• si el modo de exportación está configurado en "reassign to lists" (reasignar a listas): solo se suscribirá a example@brevo.com List1, List3 y List4.

4. Opciones de nombre de usuario/contacto

Esta opción administra cómo se dividirá su nombre de usuario/contacto de Joomla en los atributos de Brevo.

• Attribute first word (Primera palabra de atributo): seleccione FIRSTNAME en el menú desplegable
• Attribute rest of words (Resto de palabras de atributo): seleccione LASTNAME en el menú desplegable

Cuando haya terminado de seleccionar sus opciones de exportación, haga clic en el botón Export contacts (Exportar contactos).

Crear un formulario con el paquete de Joomla

1. Creación de un formulario

Desde su administrador de Joomla, haga clic en Components (Componentes) > Brevo. Seleccione el icono Subscription forms (Formularios de suscripción). Para crear un nuevo formulario de suscripción, haga clic en el botón New (Nuevo) en la parte superior izquierda.

En esta página, verá todos sus formularios. Puede usar los botones de edición estándar de Joomla para administrarlos.

2. Asignar nombre al formulario

Empiece por asignar un nombre a su formulario.

3. Seleccione su(s) lista(s)

Aquí seleccionará la(s) lista(s) de Brevo a la(s) que se suscribirá un visitante cuando envíe el formulario. Puede elegir cualquier número de listas de diferentes carpetas.

4. Configurar el email de confirmación

Vaya a la pestaña Confirmation (Confirmación).

Cuando un nuevo suscriptor envía un formulario, hay varias formas de hacer un seguimiento:

• No confirmation (Sin confirmación): los visitantes se suscribirán a la(s) lista(s) seleccionada(s) sin ninguna notificación
• Simple confirmation (Confirmación simple): los visitantes se suscribirán a la(s) lista(s) seleccionada(s) y serán notificados mediante:
• A follow-up email (Un email de seguimiento): seleccione una plantilla de email de su cuenta de Brevo que se enviará para dar la bienvenida a su nuevo suscriptor.
• A confirmation page (Una página de confirmación): al seleccionar "Yes" (Sí), puede especificar la página a la que se redirigirá a un visitante después de enviar con éxito un formulario. Solo tiene que escribir la URL en el campo "Custom confirmation page" (Página de confirmación personalizada).

• Double confirmation (Doble confirmación): los visitantes que envíen un formulario se agregarán a la lista Temp - DOUBLE OPTIN y se les enviará un email de confirmación en el que se les solicitará que hagan clic para confirmar su suscripción. Una vez que hayan hecho clic, se añadirán a la(s) lista(s) de Brevo seleccionada(s).
• Opt-in email (Email de consentimento): seleccione una plantilla de email de su cuenta de Brevo que se utilizará para que su nuevo suscriptor confirme su suscripción. Nota: la plantilla debe contener la etiqueta de confirmación doble, ya que se sustituirá por un enlace de confirmación generado.
• Form redirect page (Página de redireccionamiento de formulario): al seleccionar "Yes" (Sí), puede especificar la página a la que se redirigirá a un visitante después de enviar con éxito el formulario. Simplemente escriba la URL en el campo "Custom form redirect page" (Página de redireccionamiento de formulario personalizado).
• Final confirmation (Confirmación final): al seleccionar "Yes" (Sí), su nuevo suscriptor recibirá un email de confirmación final después de confirmar el email de suscripción. Seleccione una plantilla de email de su cuenta de Brevo.
• Confirmation page (Página de confirmación): al seleccionar "Yes" (Sí), a su nuevo suscriptor se le redirigirá a una página de confirmación después de confirmar el email de suscripción.  Solo tiene que escribir la URL en el campo "Custom confirmation page" (Página de confirmación personalizada). Puede ser una página de agradecimiento o una landing page en la que proporcione información adicional.

5. Personalizar mensajes informativos

Vaya a la pestaña Messages (Mensajes) . Esta pestaña permite la personalización de mensajes básicos.

6. Añadir bloques de formularios y campos

Vaya a la pestaña Form blocks and fields (Bloques y campos de formulario) para crear su formulario. Cada formulario se compone de bloques. Puede personalizar cada bloque para que tenga diferentes opciones y diferentes representaciones visuales.

• Para crear el primer bloque, haga clic en el icono "+" en la parte superior izquierda del subformulario de bloques.
• Para crear el siguiente bloque, haga clic en el icono "+" en la parte inferior derecha del último bloque.
• Para eliminar un bloque, use una "X" roja en la esquina superior derecha del bloque.
• Con el icono de tres puntos en el lado izquierdo de cada bloque, puede arrastrar y soltar para reordenar los bloques. 

Hay dos grupos básicos de tipos de bloques:

1. Bloques de "tipo atributo": los bloques de tipo atributo tendrán la palabra "attribute" como prefijo.  Estos bloques de tipo permiten a los visitantes introducir datos específicos.
2. Bloques de "tipo específico": los bloques de tipo específico se utilizan para crear elementos en el formulario, p. ej. texto, imágenes, un separador, etcétera.

Tipos de bloques:

Bloques de tipo específico:

• Text and image (Texto e imagen): se utiliza para agregar texto o imágenes personalizadas al formulario, agregue contenido con el editor de texto. Asegúrese de tener el editor configurado en sus parámetros de usuario.
• Divider (Divisor): se utiliza para añadir un divisor (separador) que hace que el formulario sea más legible visualmente.
• Opt-in (Consentimento): se utiliza para agregar una casilla de verificación de consentimento.  Los visitantes no podrán enviar un formulario si esta casilla de verificación no está seleccionada.
• Captcha: se utiliza para añadir captcha a un formulario.  Para poder utilizar este tipo de bloque, debe tener instalado y habilitado el plugin captcha en su sitio web. Se recomienda encarecidamente que cada formulario tenga un campo captcha.

Bloques de tipo de atributo:

• Email: se utiliza para permitir que los visitantes introduzcan su dirección de email. Se requiere una dirección de email válida y se indicará si no se introduce correctamente.
• Attribute text (Atributo texto): se utiliza para permitir a los visitantes introducir un valor textual, por ejemplo, "Nombre".
• Attribute number (Número de atributo): se utiliza para permitir a los visitantes introducir un valor numérico, la entrada se validará cuando se trate de un valor numérico.
• Attribute date (Atributo fecha): se utiliza para permitir a los visitantes introducir un valor de fecha, los visitantes tendrán un calendario presentado para introducir el valor, por ejemplo, "Fecha de nacimiento".
• Attribute switch (Atributo botón de alternancia): se utiliza para permitir que los visitantes introduzcan el valor Sí/No.  El visitante verá la casilla de verificación.
• Attribute single choice (Atributo opción única): se utiliza para permitir a los visitantes hacer una selección de una lista de opciones. El visitante verá los botones de opción o la casilla de selección.

Tanto los tipos de bloque específicos como los de atributo tienen los siguientes parámetros:

• visible: con este modificador, puede activar o desactivar fácilmente un bloque.
• block class (clase de bloque): clase añadida al bloque.
• style (estilo): reglas de estilo CSS específicas añadidas a un bloque, atributo de estilo de elemento de bloque.
• block control class (clase de control de bloque): clase añadida a los elementos de control dentro de un bloque.

La mayoría de los tipos de bloque de atributos tienen los siguientes modificadores y parámetros:

• required switch (modificador requerido): los visitantes deben introducir un valor en este campo.
• show label switch with the option to enter label text (mostrar modificador de etiqueta con la opción de introducir el texto de la misma): puede establecer y seleccionar si la etiqueta se muestra junto a un campo.
• show help switch with the option to enter help text (mostrar modificador de ayuda con la opción de introducir texto de ayuda): puede configurar y seleccionar si se muestra una explicación adicional.

Cuando haya terminado de crear su formulario, haga clic en el botón Save (Guardar) en la parte superior izquierda.

7. Añadir un formulario

Para mostrar los formularios que ha creado, inicie sesión como administrador de Joomla:

1. Vaya a Extensions (Extensiones) > Modules (Módulos).
2. Haga clic en el botón +Nuevo en la parte superior izquierda.
3. Seleccione Brevo subscription form (Formulario de suscripción de Brevo).

Empiece por añadir un título.

Dentro de este módulo, tendrá que seleccionar el formulario de suscripción que acaba de crear.

También hay parámetros adicionales para añadir texto antes y después del módulo. Si su sitio web no está en inglés, le recomendamos que configure el parámetro del módulo con la etiqueta del botón.

Establezca otros parámetros estándar como:

• Show Title (Mostrar título): si selecciona "Show" (Mostrar), el título se mostrará en su sitio web.
• Position (Posición): elija en qué parte de su sitio web aparecerá el formulario.

Dependiendo de la plantilla de Joomla que utilice su sitio web y el otro estilo adicional, es importante comprender la representación visual de su formulario terminado. 

El módulo utiliza controles y clases estándar de Joomla para la representación de formularios, y hay opciones para agregar clases y estilos para cada bloque de formulario. Por esta razón, su formulario se puede personalizar fácilmente de acuerdo con sus preferencias.

Por ejemplo, si tiene el tipo de bloque "Attribute single choice" (Atributo de opción única) en su formulario y está utilizando la plantilla predeterminada "Protostar" de Joomla, al configurar el parámetro "Block control class" (Clase de control de bloque) en "btn-group btn-group-yesno" para dicho bloque, obtendrá botones de opción mostrados con tipos de botón predeterminados de Joomla, que también deberían existir en muchas otras plantillas.

Enviar emails transaccionales con Brevo

1. Configurar la contraseña SMTP

Desde su panel de control de Joomla, en el panel de control de Brevo, haga clic en el icono SMTP settings (Configuración de SMTP) para configurar sus emails transaccionales.

Pegue su contraseña de SMTP y haga clic en el botón Set Joomla mail settings (Establecer configuración de correo de Joomla). La configuración de Joomla se actualizará.

2. Enviar un email de prueba

Puede enviar un email de prueba para confirmar que todo funciona sin problemas: 

• Escriba su dirección de email en el campo Test email (Email de prueba).
• Haga clic en el botón Send test email (Enviar email de prueba).
• Compruebe sus emails.

Este email de prueba también se registrará en los registros transaccionales de su cuenta de Brevo.

Realizar un seguimiento de la actividad del sitio web con la automatización del marketing

Configuración de la automatización del marketing

En primer lugar, asegúrese de haber activado la automatización del marketing en su cuenta de Brevo. Para ello, inicie sesión, luego vaya a la pestaña Automation (Automatización) en el menú superior y haga clic en el botón TRY FOR FREE (PROBAR GRATIS). 

Cuando instale el paquete de Joomla, el plugin de automatización de marketing de Brevo estará disponible automáticamente para su uso. Ahora, solo tiene que habilitarlo. 

Desde el panel de control de Joomla, en el panel de control de Brevo. Haga clic en el icono de Marketing automation (Automatización de marketing) .

1. Haga clic en el botón Enable plugin (Habilitar plugin).
   
2. Haga clic en el botón Set plugin Tracking ID (Establecer ID de seguimiento de plugin . De este modo, se recuperará el ID de seguimiento de automatización de marketing de su cuenta de Brevo.

Supervisión de la actividad del sitio web

Ahora que Brevo Tracker de automatización está integrado en su web, se hará un seguimiento de todas las páginas visitadas por sus contactos automáticamente. Encontrará estos logs en su cuenta de Brevo en Automation (Automatización) > Logs > Event logs (Logs de eventos):

• página
• identificar

Consulte esta guía para obtener más información sobre el uso de sus registros de automatización. 

Automatización de las comunicaciones de marketing

Automatización utiliza "escenarios" para crear experiencias de marketing de varios pasos para sus contactos, tales como:

• Enviar un mensaje de bienvenida a los suscriptores de nueva lista de correo  
• Crear una serie de emails de incorporación para los nuevos usuarios del sitio web

Los escenarios también pueden ayudarle a gestionar los procesos de marketing internos, como: 

• Puntuar a nuevos leads en función de cómo se comportan en su sitio web
• Agregar un nuevo atributo a sus contactos actuales o moverlos a una nueva lista basada en una compra reciente 

Puede desencadenar el inicio de un escenario en función de muchas cosas, incluso cuando los contactos: 

• se identifiquen en su sitio web
• visiten una página
• se añadan a una lista de contactos 
• ¡y mucho más!

Brevo ofrece plantillas de escenario listas para usar, o puede ser creativo y crear un escenario personalizado para sus necesidades específicas.

Consulte esta guía para obtener más información sobre la creación de escenarios de automatización, o visite Automatización y cree su primer escenario hoy mismo. 

⏭ ¿Qué es lo siguiente?

• 6 razones para adoptar la Automatización del marketing
• Calificar a los contactos utilizando el sistema de puntuación de Brevo

🤔 ¿Tiene alguna duda?

Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de asistencia mediante la creación de un ticket desde su cuenta. Si todavía no tiene una cuenta, puede ponerse en contacto con nosotros aquí.

Si necesitas ayuda con un proyecto usando Brevo, podemos ponerte en contacto con un socio certificado de Brevo.