WhatsApp¶
WhatsApp is an instant messaging and voice-over-IP app that allows users to send messages, make calls, and share content. Businesses can use WhatsApp Business to communicate with their customers by text, send documents, and provide support. This documentation covers the integration of a WhatsApp Business Account (WABA) with Odoo.
Advertencia
WhatsApp is an Odoo Enterprise-only application that does not work in Odoo Community edition. To use the Odoo WhatsApp app, sign up for Odoo Enterprise edition.
Ver también
Connecting a WhatsApp Business Account (WABA) to an Odoo database enables the following in Odoo’s WhatsApp app:
Send and receive WhatsApp messages directly from an Odoo database.
Create and send pre-approved templates with dynamic placeholders/variables, such as:
Quotations from the Sales app.
Receipts and invoices from the Point of Sale app.
Tickets from the Events app.
Ver también
The WhatsApp integration supports two flows: company-initiated and customer-initiated. A company can start a discussion by sending a template to one or more customers. If the customer answers within 15 days, a Discuss chat window pops up to begin the conversation.
If a customer initiates by sending a message to the company’s public WhatsApp number, Odoo opens a group chat with all operators responsible for the WhatsApp channel.
Truco
Consider setting up separate WhatsApp accounts for each department, to better manage communications.
Ver también
WhatsApp configuration in Meta¶
WhatsApp is operated by Meta, the parent company of Facebook. Odoo’s WhatsApp integration uses a standard API connection configured in Meta:
Create a Meta business account.
Create a Meta developer account.
Set up an app and WhatsApp product in Meta’s developer console.
Pruebe la conexión con la API.
Once the WhatsApp API is connected, Odoo users can send and receive messages through Odoo’s Discuss application.
Cree una cuenta comercial de Meta.¶
Importante
In order to create a Meta business account, the user must have a personal Facebook account that has existed for a minimum of one hour prior to setting up the Facebook Business account. Trying to create the business account prior to this time results in an error.
To create a business account with Meta, navigate to Meta Business Suite. Click Create account and then enter the business name, the administrator’s name, and a work email address. Click Next, and confirm the email address in the pop-up window that appears. After confirming, click Done to close the window.
Siga las instrucciones en el correo electrónico que le envió Facebook para confirmar la creación de la cuenta comercial y completar el proceso de configuración.
Ver también
Importante
If the business account is linked to a personal Facebook account, the administrator must switch between their personal account and the business account for the remainder of the configuration.
To switch to the business account, navigate to the Meta Developer Dashboard and click the account name in the top-right corner. Under Business Accounts, select the business to be configured.
Create a Meta developer app for Odoo¶
On the Meta Developer Dashboard dashboard, sign in with the Meta developer account. If no account is configured yet, link a Facebook account to create a Meta developer account.
Nota
A Facebook developer account is different than a Facebook business account. While developer accounts are tied to personal Facebook accounts, business accounts are not as they represent a business and manage all of the business’s assets in Meta, such as apps.
Ver también
After signing in to the Meta developer account, click My Apps in the top-right corner. This redirects the administrator to all the apps the developer has configured in the specific developer account. Click Create App to configure a new Meta application.
Add app details¶
The first step of the Create an app process is to fill out the App details
section. Enter Odoo in the App name field.
Nota
The app name can be changed in the settings afterward.
Advertencia
Trademarks and branded elements may not be used in this text section. This includes the Meta
group of companies. Do not include the word WhatsApp or the system flags this as an error.
Next, enter the developer email address in the App contact email field, then click Next.
Select the app type¶
The next step in app creation is the :Use cases section. Under , select Others, select Others, then click Next. The page redirects to Select an app type.
Select Business. This selection allows for the creation and management of the WhatsApp API. Click Next to configure the app as desired.
Select the business portfolio¶
The last step of the app creation process is to connect a business portfolio.
Under Business portfolio - Optional, click the drop-down menu and select the Meta business account profile. Review the Meta Platform Terms and Developer Policies agreements, then click Create app to accept and create the app.
To accept the agreements and create the app, enter the Facebook account password and click Submit. The browser then redirects to the Meta for Developers dashboard.
Advertencia
If the Meta business account is prohibited from advertising, the app can’t be claimed. To resolve this issue, navigate to Meta Business Suite for assistance.
Para obtener más información, consulte la documentación de Meta acerca de las restricciones de publicidad.
Agregue un producto de WhatsApp a la aplicación¶
Now that the basic structure of the app has been created, a product needs to be added to the app. Navigate to the Meta Developer Dashboard, and click on the app that is being configured. The page redirects to the app’s dashboard.
Under Add products to your app, go to WhatsApp near the bottom of the page and click Set up.
Ver también
The browser then redirects to the configuration page for the WhatsApp Business Platform API.
Under Select a Meta Business Account option, select the Meta business to be configured, then click Continue to confirm the selection and agree to Meta’s terms and conditions as linked on the Meta App Dashboard.
Once the WhatsApp product is added to the app, Meta provides a WhatsApp test phone number. This test phone number can send unlimited messages to a maximum of five recipients.
Under Send and receive messages, select the To field and choose Manage phone number list. Add up to five valid WhatsApp number as recipients, then enter the confirmation codes sent to those phone numbers in WhatsApp to verify.
Ver también
WhatsApp API quickstart¶
Once the Meta accounts and app have been configured, click Continue to proceed to the WhatsApp Quickstart page. This page provides a starting point for configuring the WhatsApp API by adding a phone number and sending an initial test message.
Nota
If the browser doesn’t automatically redirect to the WhatsApp Quickstart page,
navigate to the Meta Developer Dashboard and select
the Odoo app.
In the menu on the left-hand side of the page, click the (down chevron) icon next to the WhatsApp section heading. A small menu opens, containing the following options:
Quickstart
Configuración API
Configuración
Haga clic en la opción Quickstart y luego haga clic en Comenzar a usar la API.
Configuración de API¶
After clicking on Start using the API, the page navigates to the API Setup. Now that the test number has been created, a test message can be sent to confirm that WhatsApp is working properly. Navigate to the Send and receive messages section. Under Step 1 Select phone numbers, click the drop-down menu next to To.
Next, select the only option available: Manage phone number list. Follow the steps and add up to five phone numbers to send the free test messages to. Enter the appropriate country code and phone number, then click Next.
Importante
Adding a phone number to send to in this step allows for a successful test to be sent by the terminal. This is critical to ensure the WhatsApp API is working.
On the next page, enter the verification code sent to the phone numbers, and click Next to verify the numbers.
Enviar un mensaje de prueba a través de la terminal¶
Once the phone number has been verified, send a test message via the terminal. Under Step 2 Send messages with the API, click Send Message. This should send a test message to the phone numbers that were added.
Upon successfully receiving the message to the numbers, move onto the next section to produce and configure webhooks.
Configuración de WhatsApp en Odoo¶
To create a Callback URL and Webhook Verify Token, the phone number, token, app ID, and account ID need to be configured in Odoo; these values are used to set up webhooks, which make it possible to receive messages in the database. The configuration steps in this section are all performed in the Odoo database.
In Odoo, navigate to , then click New to configure the WhatsApp business account in Odoo.
In another browser tab, navigate to Meta Developer Dashboard. Select , and then copy the following values from the Meta developer console into the corresponding fields in Odoo:
Nombre |
Consola 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 |
To retrieve the App Secret, navigate to the Meta Developer Dashboard, and select the Odoo app. In the left-hand side menu,
under App settings, select Basic.
Next, click Show next to App secret, and enter the account password. Copy the App secret and then paste it into the App Secret field on the Odoo WhatsApp Business Account configuration dashboard.
To complete the setup of the WhatsApp business account in Odoo, click Test Connection. If the configuration is set correctly, a successful message in green populates the upper-right corner of the dashboard.
Configure webhooks¶
To configure the webhooks for the Odoo WhatsApp app, navigate to the Meta Developer Dashboard, and select the Odoo app. In the left-hand side menu,
click . Go to Step 3: Configure webhooks to
receive messages and click Configure webhooks.
Truco
Webhook configuration settings can also be accessed by navigating to the Meta Developer
Dashboard, selecting the Odoo app, and then selecting
Webhooks in the left hand menu.
On the page, click Edit. This is where the Callback URL and Webhook Verify Token values from Odoo are added.
Nota
The Callback URL and Webhook Verify Token values are both automatically populated after clicking on Test Connection in the previous step.
In a separate browser window, retrieve the necessary values in Odoo by navigating to and then selecting the account that is being configured. The values are located under Receiving Messages.
Copy and paste the Callback URL from Odoo into the Callback URL field in Meta, then copy and paste the Webhook Verify Token into the Verify Token field on the Meta developer console. Click Verify and save.
Add webhook fields¶
Now that the Odoo database and WhatsApp have been configured to communicate with each other, the next step is to add webhook fields to specify the information that should be sent between the two. To add individual webhook fields in Meta’s developer console, go to the Webhook fields section and click Manage. In the pop-up window that loads, check the boxes in the Subscribe column for the following field names:
account_update
message_template_quality_update
message_template_status_update
messages
template_category_update
Después de hacer la selección, haga clic en Hecho.
If the Webhooks configuration is successful, the buttons in the Subscribe column should change from Subscribe to Unsubscribe:
Importante
Webhook fields only appear once the subscription is confirmed using the Callback URL and Webhook Verify Token.
Add a phone number¶
To configure the business phone number to use for WhatsApp in Odoo, navigate back to the Meta
Developer Dashboard and select the Odoo app. Under
WhatsApp in the left-hand side menu, click API Setup. Go to Step
5: Add a phone number, and click Add phone number.
Enter a Business name and Business website or profile page.
Truco
The Business website or profile page field can be a link to a social media page.
Select the country that the company does business in from the Country drop-down menu; a business address is optional. After adding the business location, click Next.
On the next page, fill out the following WhatsApp Business profile details:
Nombre a mostrar en el perfil de empresa de WhatsApp.
Zona horaria
Categoría
Descripción empresarial (opcional)
Once these sections are complete, click Next. The page refreshes and then prompts the administrator to Add a phone number for WhatsApp in the respective field. Enter the business phone number to be used with WhatsApp.
Select Text message or Phone call for the phone number verification method, and then click Next to proceed.
The business phone number receives a WhatsApp code through the chosen verification method. Enter the verification code into the Verification code field and click Next to verify the business phone number.
Advertencia
A payment method must be added to proceed. This is part of Meta’s fraud detection system. In order to ensure that the account/company is real, a payment method is required to proceed. See Meta’s documentation on how to add a payment method in Meta Business Suite.
Ver también
Create a permanent token¶
After configuration and testing are complete, create a permanent token to replace the Temporary token.
Navigate to Meta Business Suite and then go to . Select an existing system user or create a new system user by clicking Add.
To generate a permanent token, assets must be added to the system user. Click Add
assets, and a pop-up window appears. Select Apps under Select asset type,
then select the Odoo app and toggle the permissions to On under the Full
control option, then click Save Changes. Click Done in the confirmation
window that appears.
Click Generate new token, and a pop-up window appears asking which app this token should
be generated for. Select the Odoo app, then set the expiration date to either 60 days
or Never.
Meta asks which permissions the system user allows. Add both of the following permissions:
WhatsApp_business_messaging
WhatsApp_business_management
Una vez establecidos los permisos, haga clic en generar token. Copie el valor del token que aparece en la pantalla.
Vaya a la aplicación y actualice el campo Token de acceso de la cuenta de empresa de WhatsApp en Odoo.
Activación de la aplicación Meta¶
Finally, to launch the app, the Meta app must be set to Live in the Meta Developer Dashboard. Click the app that is being configured, then toggle the App Mode field from Development to Live.
Importante
If the app status is not set to live, then the database is only able to contact the test numbers specified in the developer console.
Advertencia
A privacy policy URL must be set in order for the app to be set to live. Go to the Meta
Developer Dashboard and select the Odoo app. Then, in
the left-hand side menu, go to . Enter the privacy policy
hyperlink address under the Privacy Policy URL field of the form. Click
Save changes to apply the privacy policy to the app.
Una vez que active la aplicación en la consola de desarrolladores de Meta, se enviará un correo electrónico de confirmación al administrador.
Plantillas de WhatsApp¶
WhatsApp templates allow users to store messages that are frequently sent. By creating templates tailored to specific situations, users can easily send pre-approved messages, without having to compromise on quality or compose the same text repeatedly. This ensures quick turnaround and consistent customer service messaging, and increases the overall engagement rate with the customer.
WhatsApp templates can be created on both the Odoo and Meta consoles.
Importante
WhatsApp has an approval process that must be completed before the template can be used. See Aprobación de plantillas en Meta.
To access WhatsApp templates, navigate to the dashboard.
Each template has three tabs:
Body: stores the message body. The message body may contain placeholders for dynamic content which is populated when the message is sent.
Buttons: adds clickable buttons/hyperlinks at the bottom of the WhatsApp template. Currently, there are three button types: Quick Reply, Visit Website, and Call Number. Visit Website supports static, dynamic, and tracked URLs.
Variables: lists all of the placeholders in the template, as well as the variables that should be populated. For example, messages can contain placeholders for a recipient’s name, purchased products, or sales order number.
Create WhatsApp templates in Odoo¶
To create a WhatsApp template, go to the dashboard and click New. Enter a Name for the template, and select a Language.
Importante
In order to complete this next task, administrator access rights are needed to edit the Applies to field.
In the Account drop-down menu, select the WhatsApp business account in Odoo that this template should link to. Next, under the Applies to field, select the model the server action should apply to this template.
Truco
These models can also be accessed in developer mode. In a contact form (or similar relevant form in Odoo), navigate to the model to be referenced, and hover over a field name. This displays backend information, including the specific Odoo Model name in the backend. Search for the model’s frontend name in the WhatsApp template, under the Applies to drop-down menu.
Advertencia
The Phone Field may produce an error when changing the model or Applies
to field. The Phone Field should always be set to the Phone or Mobile model.
To search available fields, type the frontend name in the Search… box. This displays results from all of the available fields for the model (Applies to) that the template is created for.
Nota
To find specific fields, multiple levels may need to be navigated in the search results box. Use the (right chevron) and :icon:`fa-arrow-left (left arrow) icon icons to navigate between the menu levels.
Change the Category to one of the following:
- Marketing: Promotions or information about your business, products or services. Or any
message that isn’t utility or authentication.
Utility: Messages about a specific transaction, account, order or customer request.
- Authentication: One-time passwords your customers use to authenticate a transaction or
login.
Importante
Especificar una categoría incorrecta puede causar un estado de marcado/rechazado de Meta durante el proceso de aprobación.
Añada los usuarios que pueden utilizar esta plantilla. En la columna de la derecha, también se puede configurar un tipo de encabezado junto con un 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.
When all the necessary changes are made to the template, click the Submit for approval button in the upper-left corner, and the status of the template changes to Pending.
The status remains Pending until a decision has been made by Meta, whereby a confirmation email is sent indicating that the template has been approved or rejected. Next, sync the templates from the Odoo database.
Ver también
Truco
En Odoo hay disponibles plantillas de datos de demostración preconfiguradas que puede usar y modificar. Puede modificar estas plantillas para cumplir con sus necesidades empresariales.
To use these templates, navigate to and select a pre-configured template. Click Submit for Approval to start the approval process. An email is sent to the administrator of the Meta account when the template has been approved.
Placeholders and variables¶
Cuando usamos la 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. Codificamos las variables dinámicas para mostrar campos que se encuentran dentro de la base de datos, dentro de un modelo.
Example
Muchas empresas buscan llamar la atención de los clientes por medio de mensajes de WhatsApp personalizados. Para hacer esto con Odoo tenemos que configurar una variable dinámica para referenciar un campo dentro de un modelo. Por ejemplo, podemos referenciar el nombre de un cliente en un correo electrónico con el campo Cliente dentro del modelo Orden de ventas.
Para agregar variables dinámicas en el cuerpo del mensaje hay que agregar 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
Aquí le mostramos el texto del cuerpo de la plantilla del recibo de pago:
Estimado/a {{1}}:
Gracias
Ver también
These placeholders must be configured on the Variables tab of the template before submitting for approval from Meta. To edit the dynamic variables on a template, first change the Type to Field of Model. This allows Odoo to reference a field within a model to produce unique data in the message being sent.
Después, edite el campo de las variables dinámicas. El campo Aplica a en la plantilla se debe de editar antes para asegurarnos que se están referenciando el campo y modelos correctos.
To search the available fields, type in the front-end name of the field in the search box. This finds a result from all of the available fields for the model (Applies to) that the template is created for. There may be multiple levels that need to be configured.
Example
Las siguientes son ejemplos de variables que se configuran para los marcadores de posición antes mencionados en el recibo de pago que mostramos:
Nombre |
Valor de ejemplo |
Tipo |
Campo |
|---|---|---|---|
body - {{1}} |
Azure Interior |
Campo del modelo |
|
body - {{2}} |
INV/2022/00001 |
Campo del modelo |
|
body - {{3}} |
Mi Empresa |
Campo del modelo |
|
body - {{4}} |
$ |
Campo del modelo |
|
body - {{5}} |
4000 |
Campo del modelo |
|
body - {{6}} |
https://.. |
Enlace del portal |
Example
Por ejemplo, en la pestaña cuerpo si escribe «Hello {{1}},», entonces {{1}} debe configurarse en la pestaña Variables. Para este caso en específico, el mensaje debe hablarle al cliente por su nombre, por lo que debe configurar {{1}} de manera que el campo {{1}} se llene con el nombre del Cliente.
Advertencia
Personalizar las plantillas de WhatsApp está fuera del alcance del Soporte de Odoo.
Aprobación de plantillas en Meta¶
After updating the dynamic variables on the template, the template needs to be resubmitted to Meta for approval. Click Submit for Approval to start the approval process. An email is sent to the administrator of the Meta account when the template has been approved.
Una vez que tenga la aprobación de Meta, vuelva a sincronizar las plantillas en la base de datos de Odoo. Vea la siguiente documentación: Sincronización de plantillas.
Truco
To see the status, go to Meta Business Suite and select .
Sincronización de plantillas¶
Templates must be synced on the Odoo database once they are approved by the Meta team. To do so, begin by navigating to and select the configuration that should be synced. Under the section marked , towards the bottom, click Sync Templates. Meta updates the templates that are approved so that they can be utilized with various apps in the database.
Al finalizar, aparecerá un mensaje verde en la esquina superior derecha donde se mostrará el número de plantillas actualizadas.
Truco
Templates can also be synced individually from the template itself. Navigate to the dashboard and select the template to sync. Then, click the Sync Template button located in the top menu of the template’s form.
Create WhatsApp templates in Meta¶
First, navigate to Meta Business Suite, and then go to .
To create a WhatsApp template, click the blue Create template button, and then select the Category from one of the following:
- Marketing: Promotions or information about your business, products or services. Or any
message that isn’t utility or authentication.
Utility: Messages about a specific transaction, account, order or customer request.
- Authentication: One-time passwords your customers use to authenticate a transaction or
login.
Ingrese el Nombre de la plantilla y después seleccione el Idioma de la plantilla.
Nota
Multiple languages can be selected by typing the language names, then selecting the other languages as needed.
After making the appropriate selections, click Continue in the top-right corner. The browser redirects to the Edit template page where the Header, Body, Footer, and Buttons are configured. To the right of the template is a preview of what the template looks like in production.
When all necessary changes are made to the template, click Submit button in the top-right corner, and a window populates to confirm the language. Click Confirm to approve and then another window states that the template has been submitted to Meta for review and approval.
The Status of the template remains In review until a decision is made by Meta. Once an email confirmation approving the template is received, the templates need to be synced from within the Odoo database.
Ver también
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 debe establecer las notificaciones en la configuración de la cuenta de WhatsApp Business en Odoo.
Notification settings can be adjusted by navigating to . From there, select the account and scroll down to the section where notifications are handled. Under the Notify users heading, type in the field which users should be notified for this particular WhatsApp channel.
Nota
Once a conversation is initiated between a user and a customer, notifications to all the users specified in the WhatsApp business account configuration won’t occur. Only notifications to the users in the conversation occur. Should the user not respond within 15 days, the customer’s reply after the 15 days populates once again to all the users specified in the WhatsApp configuration.
Add users to a chat¶
Users can be added to a WhatsApp chat by expanding the WhatsApp pop-up window. WhatsApp conversations are located in the Discuss app. Select a conversation, then click the (Add User) icon in the top-right, and a window appears to invite users to the conversation.
Preguntas frecuentes sobre la API de WhatsApp¶
Verificación¶
As of February 1, 2023, if the Meta app requires advanced level access to permissions, a complete business verification may need to be completed. This includes submitting office business documents to Meta. See this documentation.
Errores en plantillas¶
Editing templates can cause tracebacks and errors unless the exact process is followed.
Error de validación de plantilla duplicada¶
When syncing the templates there may be an instance when there are multiple templates with the same
name on Meta’s business manager and in Odoo. This causes a duplicate validation error. Odoo displays
Validation Error: The operation cannot be completed: Duplicate template is not allowed for one Meta
account. To correct this issue, rename the duplicate template name on Odoo and sync the
templates once again.
Errores de token¶
User error 190¶
If the temporary token is not replaced with a permanent token, Odoo displays User Error 190: Error
validating access token: Session has expired. To correct this issue, add a permanent token.
User error 100¶
If an Employee attempts to set up the permanent token, Odoo displays User Error 100:
Unsupported get request.
To correct this error, create an Admin system user.
Otro¶
WhatsApp template can’t be sent to multiple contacts¶
Make sure the Multi-Template feature is enabled on the template.
Check why a WhatsApp message failed to send¶
Enable the Failure Type and Failure Reason columns under WhatsApp —> Messages.
Other error codes¶
For other errors, see Meta’s Developer Suite for WhatsApp Error Codes.