WhatsApp

WhatsApp es una aplicación de mensajería instantánea y voz sobre IP que permite enviar mensajes, hacer llamadas y compartir contenido. Las empresas pueden usar WhatsApp Business para comunicarse con sus clientes mediante texto, enviar documentos y ofrecer soporte. Esta documentación cubre la integración de una cuenta de WhatsApp Business (WABA) con Odoo.

Advertencia

WhatsApp es una aplicación exclusiva de Odoo Enterprise y no funciona en la edición Community de Odoo. Regístrate en Odoo Enterprise para usar la aplicación WhatsApp de Odoo.

Conectar una cuenta de WhatsApp Business (WABA) a una base de datos de Odoo habilita lo siguiente en la aplicación WhatsApp de Odoo:

  • Enviar y recibir mensajes de WhatsApp de forma directa desde una base de datos de Odoo.

  • Crear y enviar plantillas preaprobadas con marcadores de posición o variables dinámicas, como:

    • Cotizaciones desde la aplicación Ventas.

    • Recibos y facturas desde la aplicación Punto de venta.

    • Boletos desde la aplicación Eventos.

La integración de WhatsApp es compatible con dos flujos: iniciado por la empresa e iniciado por el cliente. La empresa puede iniciar una conversación al enviar una plantilla a uno o varios clientes. Si el cliente responde dentro de los 15 días, aparecerá una ventana de chat en Conversaciones para iniciar la comunicación.

Si el cliente inicia el contacto al enviar un mensaje al número público de WhatsApp de la empresa, Odoo abrirá un chat grupal con todos los operadores responsables del canal de WhatsApp.

Truco

Considera configurar cuentas de WhatsApp separadas para cada departamento, esto te permitirá gestionar mejor las comunicaciones.

Configuración de WhatsApp en Meta

Meta, la empresa matriz de Facebook, opera WhatsApp. La integración de WhatsApp en Odoo usa una conexión estándar mediante una API configurada en Meta:

  1. Crea una cuenta comercial de Meta.

  2. Crea una cuenta de desarrollador de Meta.

  3. Configura una aplicación y el producto WhatsApp en la consola de desarrolladores de Meta.

  4. Pruebe la conexión con la API.

Una vez que conectes la API de WhatsApp, los usuarios de Odoo podrán enviar y recibir mensajes desde la aplicación Conversaciones de Odoo.

Cree una cuenta comercial de Meta.

Importante

Para crear una cuenta comercial en Meta debes tener una cuenta personal de Facebook que tenga al menos una hora de antigüedad antes de configurar la cuenta de Facebook Business. El sistema te mostrará un error si intentas crear la cuenta de la empresa antes de ese tiempo.

Para crear una cuenta comercial con Meta, ve a Meta Business Suite. Haz clic en Crear cuenta y escribe el nombre de la empresa, el nombre del administrador y una dirección de correo de trabajo. Haz clic en Siguiente y confirma la dirección de correo en la ventana emergente que aparece. Después de confirmar, haz clic en Listo para cerrar la ventana.

Siga las instrucciones del correo electrónico que le envió Facebook para confirmar la creación de la cuenta comercial y completar el proceso de configuración.

Importante

Si la cuenta comercial está vinculada a una cuenta personal de Facebook, el administrador debe alternar entre su cuenta personal y la cuenta de empresa durante el resto de la configuración.

Para cambiar a la cuenta empresarial, ve al panel de desarrolladores de Meta y haz clic en el nombre de la cuenta en la esquina superior derecha. Selecciona la empresa que quieres configurar en Cuentas de empresa.

Crear una aplicación de desarrollador de Meta para Odoo

En el panel de desarrolladores de Meta, inicia sesión con la cuenta de desarrollador de Meta. Si todavía no configuras una cuenta, vincula una cuenta de Facebook para crear una cuenta de desarrollador de Meta.

Nota

Una cuenta de desarrollador de Facebook es distinta de una cuenta de empresa de Facebook. Las cuentas de desarrollador están vinculadas a las cuentas personales de Facebook, mientras que las cuentas de empresa no, ya que representan a una empresa y gestionan todos sus activos, como las aplicaciones, en Meta.

Después de iniciar sesión en la cuenta de desarrollador de Meta, haz clic en Mis aplicaciones en la esquina superior derecha. El sistema te redirigirá a todas las aplicaciones que configuraste en esa cuenta de desarrollador. Haz clic en Crear aplicación para configurar una nueva aplicación de Meta.

Agregar los detalles de la aplicación

El primer paso del proceso Crear una aplicación consiste en completar la sección Detalles de la aplicación. Escribe Odoo en el campo Nombre de la aplicación.

Nota

Puedes cambiar el nombre de la aplicación más adelante desde los ajustes.

Advertencia

No uses marcas registradas ni elementos de marca en este campo de texto. Esto incluye al grupo de empresas Meta. No incluyas la palabra WhatsApp o el sistema arrojará un error.

Luego, escribe el correo del desarrollador en el campo Correo de contacto de la aplicación y haz clic en Siguiente.

Seleccionar el tipo de aplicación

El siguiente paso en la creación de la aplicación es la sección Casos de uso. En Filtrar por, selecciona Otros, vuelve a seleccionar Otros y haz clic en Siguiente. La página te redirigirá a Seleccionar un tipo de aplicación.

Selecciona Empresa. Esta opción te permitirá crear y gestionar la API de WhatsApp. Haz clic en Siguiente para configurar la aplicación según tus necesidades.

Seleccionar el portafolio comercial

El último paso del proceso de creación de la aplicación consiste en conectar un portafolio comercial.

En Portafolio comercial - Opcional, haz clic en el menú desplegable y selecciona el perfil de la cuenta de empresa de Meta. Revisa las condiciones de los términos de la plataforma de Meta y políticas para desarrolladores, luego haz clic en Crear aplicación para aceptar y crear la aplicación.

Para aceptar las condiciones y crear la aplicación, ingresa la contraseña de la cuenta de Facebook y haz clic en Enviar. Después, el navegador te redirigirá al tablero de Meta para desarrolladores.

Advertencia

Si la cuenta de empresa de Meta tiene prohibido anunciar, no podrás reclamar la aplicación. Para resolver este problema, ve a Meta Business Suite para recibir ayuda.

Consulte la documentación de Meta acerca de las restricciones publicitarias para obtener más información.

Agregue un producto de WhatsApp a la aplicación

Ahora que la estructura básica de la aplicación está lista deberás agregar un producto. Ve al tablero de desarrolladores de Meta y haz clic en la aplicación que estás configurando. La página te redirigirá al tablero de la aplicación.

En Agregar productos a tu aplicación, ve a WhatsApp cerca de la parte inferior de la página y haz clic en Configurar.

Después, el navegador te redirigirá a la página de configuración de la API de la plataforma de WhatsApp Business.

En la opción Selecciona una cuenta de empresa de Meta, selecciona la empresa de Meta que vas a configurar y haz clic en Continuar para confirmar la selección y aceptar los términos y condiciones de Meta enlazados en el tablero de la aplicación de Meta.

Una vez que agregues el producto de WhatsApp a la aplicación, Meta proporcionará un número de teléfono de prueba de WhatsApp. Este número de prueba puede enviar mensajes ilimitados a un máximo de cinco destinatarios.

En Enviar y recibir mensajes, selecciona el campo Para y elige Administrar lista de números de teléfono. Agrega hasta cinco números de WhatsApp válidos como destinatarios y luego ingresa los códigos de confirmación enviados a esos números en WhatsApp para verificarlos.

Inicio rápido de la API de WhatsApp

Una vez que configures las cuentas de Meta y la aplicación, haz clic en Continuar para ir a la página de inicio rápido de WhatsApp. Esta página ofrece un punto de partida para configurar la API de WhatsApp al agregar un número de teléfono y enviar un mensaje de prueba inicial.

Nota

Si el navegador no te redirige de forma automática a la página de inicio rápido de WhatsApp, ve al tablero de desarrolladores de Meta y selecciona la aplicación Odoo.

En el menú del lado izquierdo de la página, haz clic en el icono (flecha hacia abajo) junto al encabezado de la sección WhatsApp. Aparecerá un pequeño menú con las siguientes opciones:

  • Inicio rápido

  • Configuración de la API

  • Configuración

Haga clic en la opción Inicio rápido y luego haga clic en Comenzar a usar la API.

Configuración de la API

Después de hacer clic en Empezar a usar la API, la página te redirigirá a Configuración de la API. Ahora que ya hay un número de prueba podrás enviar un mensaje de este tipo para confirmar que WhatsApp funciona de forma correcta. Ve a la sección Enviar y recibir mensajes. En Paso 1 Seleccionar números de teléfono, haz clic en el menú desplegable junto a Para.

Luego, selecciona la única opción disponible: Administrar lista de números de teléfono. Sigue los pasos y agrega hasta cinco números de teléfono para enviar mensajes de prueba gratuitos. Ingresa el código de país correspondiente y el número de teléfono, después haz clic en Siguiente.

Importante

Agregar un número de teléfono en este paso permite enviar una prueba exitosa desde la terminal. Esto es indispensable para confirmar que la API de WhatsApp funciona.

En la siguiente página, ingresa el código de verificación enviado a los números de teléfono y haz clic en Siguiente para verificar los números.

Enviar un mensaje de prueba a través de la terminal

Una vez que verifiques el número de teléfono, envía un mensaje de prueba desde la terminal. En Paso 2 Enviar mensajes con la API, haz clic en Enviar mensaje. Esto enviará un mensaje de prueba a los números que agregaste.

Una vez que recibes el mensaje correctamente en los números, continúa con la siguiente sección para crear y configurar webhooks.

Configuración de WhatsApp en Odoo

Para crear una URL de retrollamada y un token de verificación del webhook debes configurar el número de teléfono, el token, el ID de la aplicación y el ID de la cuenta en Odoo. Estos valores sirven para configurar los webhooks, que permiten recibir mensajes en la base de datos. Debes realizar todos los pasos de configuración de esta sección en la base de datos de Odoo.

En Odoo, ve a WhatsApp ‣ Configuración ‣ Cuentas de WhatsApp Business y después haz clic en Nuevo para configurar la cuenta de WhatsApp Business en Odoo.

En otra pestaña del navegador, ve al tablero de desarrolladores de Meta. Selecciona Mis aplicaciones ‣ WhatsApp ‣ Configuración de la API y copia los siguientes valores desde la consola de desarrolladores de Meta en los campos correspondientes de Odoo:

Nombre

Consola de Meta

Interfaz de Odoo

Teléfono

ID del número de teléfono

ID del número de teléfono

Token

Token de acceso temporal

Token de acceso

ID de la aplicación

ID de la aplicación

ID de la aplicación

ID de la cuenta

ID de la cuenta de WhatsApp Business

ID de la cuenta

Para obtener el secreto de la aplicación, ve al tablero de desarrolladores de Meta y selecciona la aplicación Odoo. En el menú del lado izquierdo, en Ajustes de la aplicación, selecciona Básico.

Luego, haz clic en Mostrar junto a Secreto de la aplicación e ingresa la contraseña de la cuenta. Copia el secreto de la aplicación y pégalo en el campo Secreto de la aplicación del tablero de configuración de la cuenta de WhatsApp Business en Odoo.

Para completar la configuración de la cuenta de WhatsApp Business en Odoo, haz clic en Probar conexión. Si la configuración es correcta, aparecerá un mensaje de éxito en color verde en la esquina superior derecha del tablero.

Configurar webhooks

Para configurar los webhooks de la aplicación WhatsApp de Odoo, ve al tablero de desarrolladores de Meta y selecciona la aplicación Odoo. En el menú del lado izquierdo, haz clic en WhatsApp ‣ Configuración de la API. Ve a Paso 3: Configurar webhooks para recibir mensajes y haz clic en Configurar webhooks.

Truco

También puedes acceder a la configuración de webhooks desde el tablero de desarrolladores de Meta, al seleccionar la aplicación Odoo y luego elegir Webhooks en el menú del lado izquierdo.

Ir de forma manual a la configuración de los webhooks de WhatsApp.

Haz clic en Editar en la página de configuración de webhooks. Aquí deberás agregar los valores de la URL de retrollamada y el token de verificación del webhook de Odoo.

Nota

Los valores de la URL de retrollamada y el token de verificación del webhook se completan de forma automática después de hacer clic en Probar conexión en el paso anterior.

En otra ventana del navegador, obtén los valores necesarios en Odoo desde WhatsApp ‣ Configuración ‣ Cuentas de WhatsApp Business y selecciona la cuenta que estás configurando. Los valores están disponibles en Recepción de mensajes.

Copia y pega la URL de retrollamada de Odoo en el campo URL de retrollamada de Meta. Después, copia y pega el token de verificación del webhook en el campo Token de verificación de la consola de desarrolladores de Meta. Haz clic en Verificar y guardar.

Agregar campos de webhook

Ahora que la base de datos de Odoo y WhatsApp se comunican entre sí, el siguiente paso es agregar los campos de webhook para definir qué información se envía entre ambos. Para agregar campos de webhook individuales en la consola de desarrolladores de Meta, ve a la sección Campos de webhook y haz clic en Gestionar. En la ventana emergente que aparecerá, selecciona las casillas de la columna Suscribirse para los siguientes nombres de campo:

  • account_update

  • message_template_quality_update

  • message_template_status_update

  • messages

  • template_category_update

Haga clic en Hecho después de seleccionar las opciones correspondientes.

Si la configuración de los webhooks es correcta, los botones de la columna Suscribirse cambian de Suscribirse a Cancelar suscripción:

Webhooks de WhatsApp configurados en la consola de desarrollador de Meta.

Importante

Los campos de webhook solo aparecen después de confirmar la suscripción con la URL de retrollamada y el token de verificación del webhook.

Agregar un número de teléfono

Para configurar el número de teléfono de la empresa que usarás para WhatsApp en Odoo, regresa al tablero de desarrolladores de Meta y selecciona la aplicación Odoo. En el menú del lado izquierdo, en WhatsApp, haz clic en Configuración de la API. Ve a Paso 5: Agregar un número de teléfono y haz clic en Agregar número de teléfono.

Ingresa un nombre de la empresa y un sitio web de la empresa o página de perfil.

Truco

El campo Sitio web de la empresa o página de perfil puede ser un enlace a una página de redes sociales.

Selecciona el país en el que opera la empresa desde el menú desplegable País. La dirección de la empresa es opcional. Haz clic en Siguiente después de agregar la ubicación de la empresa.

En la página siguiente, completa los siguientes detalles del perfil de WhatsApp Business:

  • Nombre a mostrar en el perfil de WhatsApp Business

  • Zona horaria

  • Categoría

  • Descripción empresarial (opcional)

Luego de completar estas secciones, haz clic en Siguiente. La página se actualizará y le solicitará al administrador que agregue un número de teléfono para WhatsApp en el campo correspondiente. Ingresa el número de teléfono de la empresa que usarás con WhatsApp.

Selecciona Mensaje de texto o Llamada telefónica como método de verificación del número y haz clic en Siguiente para continuar.

El número de teléfono de la empresa recibe un código de WhatsApp según el método de verificación elegido. Ingresa el código en el campo Código de verificación y haz clic en Siguiente para verificar el número de teléfono de la empresa.

Advertencia

Debes agregar un método de pago para continuar. Esto forma parte del sistema de detección de fraude de Meta. Necesitas un método de pago para confirmar que la cuenta o la empresa existe. Consulta la documentación de Meta sobre cómo agregar un método de pago en Meta Business Suite.

Crear un token permanente

Después de completar la configuración y las pruebas, crea un token permanente para reemplazar el token temporal.

Ve a Meta Business Suite y luego a Ajustes de la empresa ‣ Usuario ‣ Usuarios del sistema. Selecciona un usuario del sistema existente o crea uno con Agregar.

Para generar un token permanente, agrega recursos al usuario del sistema. Haz clic en Agregar recursos y aparece una ventana emergente. Selecciona Aplicaciones en Seleccionar tipo de recurso, elige la aplicación Odoo y activa los permisos en Activado dentro de la opción Control total. Después, haz clic en Guardar cambios y, en la ventana de confirmación, haz clic en Listo.

Haz clic en Generar nuevo token y aparecerá una ventana emergente que te preguntará para qué aplicación quieres generar el token. Selecciona la aplicación Odoo y define la fecha de vencimiento como 60 días o Nunca.

Meta solicita los permisos que permite el usuario del sistema. Agrega los dos permisos siguientes:

  • WhatsApp_business_messaging

  • WhatsApp_business_management

Una vez que haya definido los permisos, haga clic en Generar token. Copie el valor del token que aparece en la pantalla.

Una vez que tenga este valor, vaya a WhatsApp ‣ Configuración ‣ Cuentas de WhatsApp Business y actualice el campo Token de acceso de la cuenta de WhatsApp Business en Odoo.

Activación de la aplicación de Meta

Por último, para lanzar la aplicación, define el estado de la aplicación de Meta como Activa en el tablero de desarrolladores de Meta. Haz clic en la aplicación que configuras y cambia el campo Modo de la aplicación de Desarrollo a Activa.

Importante

La base de datos solo podrá comunicarse con los números de prueba que definiste en la consola de desarrolladores si el estado de la aplicación no es Activa.

Advertencia

Debes configurar una URL de política de privacidad para poder activar la aplicación. Ve al tablero de desarrolladores de Meta Developer y selecciona la aplicación Odoo. Luego, en el menú del lado izquierdo, ve a Ajustes de la aplicación ‣ Básico. Ingresa la dirección del enlace de la política de privacidad en el campo URL de la política de privacidad del formulario y haz clic en Guardar cambios para aplicar la política de privacidad a la aplicación.

El administrador recibirá un correo electrónico de confirmación una vez que active la aplicación en la consola de desarrolladores de Meta.

Plantillas de WhatsApp

Las plantillas de WhatsApp permiten que los usuarios guarden los mensajes que envían con frecuencia. Al crear plantillas adaptadas a situaciones específicas puedes enviar mensajes aprobados con facilidad, sin comprometer la calidad ni redactar el mismo texto varias veces. Esto asegura respuestas rápidas y mensajes de atención al cliente coherentes, además de que aumenta la tasa general de interacción con el cliente.

Puedes crear plantillas de WhatsApp tanto en la consola de Odoo como en la de Meta.

Importante

WhatsApp tiene un proceso de aprobación que debes completar antes de poder usar la plantilla. Consulta Aprobación de plantillas en Meta.

Para acceder a las plantillas de WhatsApp, ve a WhatsApp ‣ tablero de plantillas.

Cada plantilla tiene tres pestañas:

  • Cuerpo: Almacena el cuerpo del mensaje. El cuerpo del mensaje puede incluir marcadores de posición para contenido dinámico que el sistema completará al enviar el mensaje.

  • Botones: Agrega botones o hipervínculos en los que se puede hacer clic en la parte inferior de la plantilla de WhatsApp. Por el momento existen tres tipos de botones: Respuesta rápida, Visitar sitio web y Llamar a un número. Visitar sitio web es compatible con URL estáticas, dinámicas y rastreables.

  • Variables: Muestra todos los marcadores de posición de la plantilla y las variables que debes completar. Por ejemplo, los mensajes pueden incluir marcadores para el nombre del destinatario, los productos comprados o el número de la orden de venta.

Crear plantillas de WhatsApp en Odoo

Para crear una plantilla de WhatsApp, ve a WhatsApp ‣ tablero Plantillas y haz clic en Nuevo. Escribe un nombre para la plantilla y selecciona un idioma.

Importante

Para completar la siguiente tarea es necesario contar con permisos de acceso de administrador para editar el campo Aplica a.

En el menú desplegable Cuenta, selecciona la cuenta de WhatsApp Business de Odoo a la que debe vincularse esta plantilla. Luego, en el campo Aplica a, selecciona el modelo al que debe aplicarse la acción del servidor para esta plantilla.

Truco

También puedes acceder a estos modelos en el modo de desarrollador. En un formulario de contacto (u otro formulario relevante de Odoo), ve al modelo que quieras referenciar y coloca el cursor sobre el nombre de un campo. Esta acción mostrará la información del backend, incluido el nombre específico del modelo de Odoo. Busca el nombre en el frontend del modelo en la plantilla de WhatsApp, en el menú desplegable Aplica a.

Advertencia

El campo de teléfono puede mostrar un error si cambias el modelo o el campo Aplica a. El campo de teléfono siempre debe usar el modelo Teléfono o Celular.

Para buscar campos disponibles, escribe el nombre del frontend en el cuadro de búsqueda. El sistema mostrará resultados de todos los campos disponibles del modelo (Aplica a) para el que creas la plantilla.

Nota

Para encontrar campos específicos es posible que debas recorrer varios niveles en el cuadro de resultados de búsqueda. Usa los iconos (flecha a la derecha) y (flecha a la izquierda) para moverte entre los niveles del menú.

Buscar el campo de teléfono en la barra de búsqueda.

Cambia la categoría a una de las siguientes:

  • Marketing: Promociones o información sobre tu empresa, productos o servicios. O cualquier

    mensaje que no sea de utilidad ni de autenticación.

  • Utilidad: Mensajes sobre una transacción, cuenta, orden o solicitud del cliente específica.

  • Autenticación: Contraseñas de un solo uso que tus clientes usan para autenticar una transacción o

    iniciar sesión.

Importante

Especificar una categoría incorrecta puede ocasionar que Meta defina su estado como reportado o rechazado durante el proceso de aprobación.

Agregue los usuarios que pueden utilizar esta plantilla. En la columna de la derecha también puede configurar el tipo de encabezado y el mensaje de encabezado.

Los tipos de encabezado disponibles son los siguientes:

  • Texto

  • Imagen

  • Video

  • Documento

  • Ubicación (es necesario establecer variables)

Vaya a la pestaña Cuerpo para configurar el mensaje principal de la plantilla.

Al terminar de hacer todos los cambios necesarios en la plantilla, haz clic en el botón Enviar para aprobación en la esquina superior izquierda y el estado de la plantilla cambiará a Pendiente.

El estado permanecerá en Pendiente hasta que Meta tome una decisión y envíe un correo de confirmación que indique si aprobaron o rechazaron la plantilla. Después, sincroniza las plantillas desde la base de datos de Odoo.

Truco

Odoo cuenta con plantillas de datos de demostración preconfiguradas que puede usar y modificar. Puede usarlas tal y como están o adaptarlas a sus necesidades empresariales.

Para usar estas plantillas, ve a WhatsApp ‣ Plantillas y selecciona una plantilla ya configurada. Haz clic en Enviar para aprobación para iniciar el proceso de aprobación. Cuando Meta apruebe la plantilla, el administrador de la cuenta de Meta recibirá un correo electrónico.

Botones

Puede agregar botones a los mensajes desde la pestaña Botones. Seleccione el tipo (elija entre Visitar sitio web, Llamar al número y Respuesta rápida) y después especifique el texto del botón, el número de llamada o la URL del sitio web (incluyendo el tipo de URL) según el tipo de botón.

Nota

También puedes agregar botones desde Meta Business Suite. Para ver el tablero de plantillas de WhatsApp de Meta, ve a Herramientas de la cuenta ‣ Plantillas de mensajes.

Marcadores de posición y variables

Al usar una plantilla, las variables dinámicas hacen referencia a ciertos campos dentro de la base de datos de Odoo para producir datos únicos en el mensaje de WhatsApp. Las variables dinámicas están codificadas para mostrar los campos de la base de datos que hacen referencia a aquellos que se encuentran dentro de un modelo.

Example

A muchas empresas les gusta personalizar sus mensajes de WhatsApp e incluir información del cliente para captar su atención. Es posible hacer esto con Odoo al definir una variable dinámica que haga referencia a un campo que se encuentre dentro de un modelo. Por ejemplo, es posible hacer referencia al nombre de un cliente en un correo electrónico con el campo Cliente del modelo Orden de venta.

Imagen que muestra las variables dinámicas dentro de un mensaje de WhatsApp.

Es posible agregar variables dinámicas al cuerpo del mensaje al incluir marcadores de posición en el texto. Para agregar un marcador de posición en el cuerpo del mensaje, ingrese {{1}} para el primero. Para el segundo marcador de posición, ingrese {{2}} y vaya incrementando los números conforme agregue marcadores de posición al texto.

Example

El siguiente texto es el cuerpo de la plantilla de recibos de pago:

Apreciable {{1}},

Esta es la factura {{2}} de parte de {{3}} por un total de {{4}}{{5}}.
Vaya a {{6}} para revisar la factura o pagar en línea.

Gracias.

Es necesario que, antes de enviar la plantilla a Meta para su aprobación, configures estos marcadores de posición en la pestaña Variables. Para editar las variables dinámicas en la plantilla, primero debes cambiar el tipo a Campo del modelo. De esta forma, Odoo podrá hacer referencia a un campo que se encuentra dentro de un modelo para mostrar información personalizada al enviar el mensaje.

Después, edite el campo de las variables dinámicas. Es necesario que edite el campo Aplica a antes en la plantilla de asegurarse de que hace referencia al modelo y al campo correctos.

Para buscar los campos disponibles, escribe el nombre del frontend del campo en el cuadro de búsqueda. El sistema mostrará resultados de todos los campos disponibles del modelo (Aplica a) para el que creas la plantilla. Es posible que necesites configurar varios niveles.

Example

A continuación encontrará un ejemplo de las variables configuradas para los marcadores de posición antes mencionados en el recibo de pago que mostramos:

Nombre

Valor de ejemplo

Tipo

Campo

cuerpo - {{1}}

Azure Interior

Campo del modelo

Contacto

cuerpo - {{2}}

INV/2022/00001

Campo del modelo

Número

cuerpo - {{3}}

Mi Empresa

Campo del modelo

Empresa

body - {{4}}

$

Campo del modelo

Moneda > Símbolo

cuerpo - {{5}}

4000

Campo del modelo

Cantidad

cuerpo - {{6}}

https://..

Enlace del portal

Example

Por ejemplo, si escribe «Hola {{1}},» en la pestaña Cuerpo, entonces es necesario que defina {{1}} en la pestaña Variables. Para este caso en específico, el mensaje saludará al cliente por su nombre, por lo que debe configurar {{1}} para que el campo {{1}} se complete con el nombre del cliente.

Advertencia

El equipo de soporte de Odoo no se encarga de personalizar las plantillas de WhatsApp.

Aprobación de plantillas en Meta

Después de actualizar las variables dinámicas de la plantilla debes volver a enviarla a Meta para su aprobación. Haz clic en Enviar para aprobación para iniciar el proceso. El administrador de la cuenta de Meta recibirá un correo electrónico cuando Meta apruebe la plantilla.

Una vez que tenga la aprobación de Meta, vuelva a sincronizar las plantillas en la base de datos de Odoo. Consulte la documentación sobre Sincronización de plantillas para obtener más información.

Truco

Para ver el estado, ve a Meta Business Suite y selecciona Herramientas de la cuenta ‣ Plantillas de mensajes.

Sincronización de plantillas

Debes sincronizar las plantillas en la base de datos de Odoo una vez que el equipo de Meta las apruebe. Para hacerlo, ve a WhatsApp ‣ Configuración ‣ Cuentas de WhatsApp Business y selecciona la configuración a sincronizar. Dirígete a la parte inferior de la sección Envío de mensajes y haz clic en Sincronizar plantillas. Meta actualizará las plantillas aprobadas para que puedas usarlas con varias aplicaciones de la base de datos.

Imagen donde se muestra la sincronización de las plantillas de WhatsApp Meta con la base de datos de Odoo y el botón 'Sincronizar plantillas' está resaltado.

Al finalizar, aparecerá un mensaje verde en la esquina superior derecha con el número de plantillas actualizadas.

Truco

También puedes sincronizar las plantillas por separado desde cada plantilla. Ve al tablero de WhatsApp ‣ Plantillas y selecciona la plantilla que quieras sincronizar. Después, haz clic en el botón Sincronizar plantilla ubicado en el menú superior del formulario de la plantilla.

Crear plantillas de WhatsApp en Meta

Primero, ve a Meta Business Suite y luego a Herramientas de la cuenta ‣ Plantillas de mensajes.

Imagen de los botones herramientas de la cuenta y plantillas de mensajes resaltados en el gestor de empresa.

Para crear una plantilla de WhatsApp, haz clic en el botón azul Crear plantilla y después selecciona una de las categorías de las siguientes opciones:

  • Marketing: Promociones o información sobre tu empresa, productos o servicios. O cualquier

    mensaje que no sea de utilidad ni de autenticación.

  • Utilidad: Mensajes sobre una transacción, cuenta, orden o solicitud del cliente específica.

  • Autenticación: Contraseñas de un solo uso que tus clientes usan para autenticar una transacción o

    iniciar sesión.

Escriba el nombre de la plantilla y después seleccione su idioma.

Nota

Puedes seleccionar varios idiomas si escribes los nombres de los idiomas y luego eliges los demás que necesites.

Imagen que muestra las opciones de configuración de plantillas con las opciones de Marketing, Utilidades, Nombre e idioma resaltados.

Haz clic en Continuar en la esquina superior derecha después de hacer las selecciones adecuadas. El navegador te redirigirá a la página Editar plantilla donde podrás configurar el encabezado, el cuerpo, el pie de página y los botones. A la derecha de la plantilla aparecerá la previsualización de cómo aparece en producción.

Imagen donde se edita la plantilla con las opciones encabezado, cuerpo, pie de página y los botones.

Haz clic en el botón Enviar en la esquina superior derecha al terminar de hacer todos los cambios necesarios en la plantilla. Esta acción abrirá una ventana para confirmar el idioma. Haz clic en Confirmar para aprobarlo y después aparecerá otra ventana que indica que el sistema envió la plantilla a Meta para su revisión y aprobación.

El estado de la plantilla permanecerá en En revisión hasta que Meta tome una decisión. Una vez que recibas el correo de confirmación que aprueba la plantilla deberás sincronizar las plantillas desde la base de datos de Odoo.

Notificaciones

La gestión de las notificaciones de WhatsApp es similar a la de los mensajes de Conversaciones en Odoo. Aparecerá una ventana emergente con el mensaje que envió el cliente. De forma predeterminada, es necesario configurar las notificaciones desde la cuenta de WhatsApp Business en Odoo.

Para ajustar las notificaciones, vaya a WhatsApp ‣ Configuración ‣ Cuentas de WhatsApp Business. Una vez allí, seleccione la cuenta y diríjase a la sección Control donde podrá gestionar las notificaciones. En el encabezado Notificar usuarios, incluya en el campo correspondiente a los usuarios que deben recibir notificaciones de este canal de WhatsApp.

Nota

Una vez que inicia una conversación entre un usuario y un cliente, el sistema no enviará notificaciones a todos los usuarios definidos en la configuración de la cuenta de WhatsApp Business, sino que solo enviará notificaciones a los usuarios que participan en la conversación. Si el usuario no responde dentro de un plazo de 15 días, la respuesta del cliente después de esos 15 días vuelve a aparecer para todos los usuarios definidos en la configuración de WhatsApp.

Agregar usuarios a un chat

Puedes agregar usuarios a un chat de WhatsApp al expandir la ventana emergente de WhatsApp. Las conversaciones de WhatsApp están en la aplicación Conversaciones. Selecciona una conversación y luego haz clic en el icono (Agregar usuario) ubicado en la esquina superior derecha, esta acción abrirá una ventana para invitar usuarios a la conversación.

Imagen que muestra el proceso de agregar usuarios a las conversaciones, con el icono para agregar a un usuario resaltado.

Preguntas frecuentes sobre la API de WhatsApp

Verificación

A partir del 1 de febrero de 2023, es posible que debas completar una verificación empresarial si la aplicación de Meta requiere acceso de nivel avanzado a los permisos. Esto incluye enviar documentos comerciales a Meta. Consulta esta documentación para obtener más información.

Errores de plantillas

Editar plantillas puede provocar excepciones y errores si no sigues el proceso exacto.

Error de validación de plantilla duplicada

Al sincronizar las plantillas puede existir más de una con el mismo nombre en el administrador de empresas de Meta y en Odoo. Esto provocará un error de validación por duplicado. Odoo mostrará el mensaje Error de validación: No es posible completar la operación: No puede haber plantillas duplicadas en una cuenta de Meta. Para corregir este problema, cambia el nombre de la plantilla duplicada en Odoo y vuelve a sincronizar las plantillas.

Mensaje de error que aparece Odoo cuando hay una plantilla duplicada.

Errores de token

Error de usuario 190

Si no reemplazas el token temporal por un token permanente, Odoo mostrará el mensaje Error de usuario 190: Error al validar el token de acceso: La sesión expiró. Agrega un token permanente para solucionar este problema.

Mensaje de error que aparece en Odoo cuando expira el token temporal.

Error de usuario 100

Si un empleado intenta configurar el token permanente, Odoo mostrará el mensaje Error de usuario 100: Solicitud GET incompatible.

Crea un usuario del sistema con rol de administrador para solucionar este error.

Mensaje de error que aparece en Odoo al generar un token de empleado en lugar de uno de  administrador.

Otro

La plantilla de WhatsApp no se puede enviar a varios contactos

Asegúrate de activar la función Varias plantillas en la plantilla.

Revisar por qué no se envió un mensaje de WhatsApp

Activa las columnas Tipo de error y Motivo del error en WhatsApp —> Mensajes.

Otros códigos de error

Para otros errores, consulta los códigos de error de WhatsApp en Meta Developer Suite.