| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
CRM (crm)
• Discuss (mail) • Calendar (calendar) • Contacts (contacts) |
| Community Apps Dependencies | Show |
| Lines of code | 9359 |
| Technical Name |
us_whatsapp |
| License | OPL-1 |
| Website | https://unitsoft.com.ua/ |
| Versions | 16.0 17.0 18.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
CRM (crm)
• Discuss (mail) • Calendar (calendar) • Contacts (contacts) |
| Community Apps Dependencies | Show |
| Lines of code | 9359 |
| Technical Name |
us_whatsapp |
| License | OPL-1 |
| Website | https://unitsoft.com.ua/ |
| Versions | 16.0 17.0 18.0 |
WhatsApp Integration powered by UnitSoft
Communicate with WhatsApp users in Odoo
Features
1Create bots easily
2Communicate in the document chatter
3You can quickly open discuss chat with client
4WhatsApp Templates
Create WhatsApp templates and send them for approval directly from Odoo. Also download existing ones from your Twilio account
Please note that sending template messages is only supported in Odoo versions 17 and 18 of this module
5Send WhatsApp templates to start a conversation or continue a session
6Send templates from chatter
7Send templates from phone field
8Send templates from channel
If the chat session has ended, you can send a template message to the user right in the channel
9Template Message Details
10Bots kanban cards
If all messengers module has been installed, you will see in Messengers >> Messengers kanban cards
11How clients will be saved in odoo?
If the client enters some data such as email or phone number, then if he also joins from another messenger, the odoo will connect them together
12View from the discuss
13View all messages
View all messages that anyone wrote to the client and messages that the client wrote in messenger
14Follow operators and their channels
Documentation
Twilio
- Register in Twilio: https://www.twilio.com/
- Upgrade your Twilio account, minimum amount 20 USD.
- In the WhatsApp Senders tab, create a new sender with phone number
- If you don't have your own phone number, you can buy a Twilio phone number and use it to create a Messegine Service
Installation
- Install this module in according to us_messenger Documentation
- This module requires the twilio and phonenumbers libraries to be installed, so make sure they are installed before you start setting up
Configuration
In WhatsApp
Find the bot with the created phone number
In Odoo
queue_job module. To do this, you need to add the
queue_job setting in the server_wide_modules field in the
odoo.conf file.
So the setting in your
odoo.conf file should look something like this:
- Activate Developer Mode
- Open menu
[[ Settings ]] >> Technical >> Parameters >> System Parameters - Check that parameter
web.base.urlis properly set, and it's accessible over internet (it should not be a localhost). Also, twilio accepts https addresses only (i.e. not http). If you can use only localhost, use ngrok - Open menu
[[ Messengers ]] >> Messengers - Select Kanban card with whatsapp icon and name 'Enter_bot_name' project
- Enter the WhatsApp token, ID, phone number (should be as in the example, with "whatsapp:" at the beginning) in the required fields, all this is in the Twilio account, also enter the name in the field to create Messaging Services
- Enter bot name and select the operators with which the user will contact
- Unarchive the project
- Click button
[Run Now]in the upper left corner
In Twilio
- Go to WhatsApp Senders, select your sender and assign the created Messaging Service to it
- Update WhatsApp Sender
Usage
Conversation in Discuss menu
In WhatsApp:
- begin conversation with created bot
- enter your email (optionally)
In Odoo:
- Open
[[ Discuss ]]menu - RESULT: two contact records will be created, child and parent. Later, other children from different messengers can join the parent record
- RESULT: there is channel with name WhatsApp:<WHATSAPP NAME>.
- Open the channel and reply to message
In WhatsApp:
- RESULT: the message is delivered via bot
You can continue chatting this way
Conversation in any document where there is a chatter
In Odoo:
- Make sure that in the
[[ Messengers ]] >> Messengers >> <Your bot name> >> Parametersyou have 'yes' written in CHATTER - Add followers to chatter by clicking on button 'Add followers'. Select only parent contacts (without any bot name)
- Click on button 'Send Message'. Select to whom and in which messenger to send a message. Write message and send. Note: the message will be sent not only in the selected messenger but also by mail. To disable sending by mail you can click button Followers, select follower, click 'Edit subscription', and disable 'Discussions' and enable 'Note'
- In
[[ Discuss ]]menu you will see the message from document with message with signature from which document it was written
In WhatsApp:
- RESULT: A new message will appear
- Answer on this message. Note: Reply to a message
In Odoo:
- RESULT: the message from WhatsApp you will see in chatter document
Документація
Twilio
- Зареєструйтеся в Twilio: https://www.twilio.com/
- Поповніть рахунок Twilio, мінімальна сума 20 USD.
- У вкладці WhatsApp Senders створіть нового відправника з номером телефону
- Якщо у вас немає власного номера телефону, ви можете купити номер телефону Twilio та використовувати його для створення Messegine Service
Інсталяція
- Встановіть модуль відповідно до документації модуля us_messenger
- Модуль потребує встановлення бібліотек twilio та phonenumbers, тому переконайтеся, що вони встановлені перед початком налаштування
Конфігурація
У WhatsApp
Знайдіть бота зі створеним номером телефону
В Odoo
queue_job. Для цього вам потрібно додати налаштування
queue_job в поле server_wide_modules у файлі
odoo.conf.
Таким чином, налаштування у вашому файлі odoo.conf має виглядати приблизно так:
- Активуйте Режим Розробника
- Відкрийте меню
[[ Налаштування ]] >> Технічні налаштування >> Параметри системи - Перевірте, чи правильно встановлено параметр
web.base.urlта чи доступний він через інтернет (не повинен бути localhost). Також, Twilio приймає тільки https адреси (тобто не http). Якщо ви можете використовувати тільки localhost, скористайтеся ngrok - Відкрийте меню
[[ Месенджери ]] >> Месенджери - Виберіть картку Kanban з іконкою Whatsapp та назвою проекту 'Enter_bot_name'
- Введіть токен WhatsApp, ID, номер телефону (повинен бути як у прикладі, з "whatsapp:" на початку) у відповідні поля, все це знаходиться в обліковому записі Twilio, також введіть назву у поле для створення Messegine Service
- Введіть назву бота та виберіть операторів, з якими користувач буде зв'язуватися
- Розархівуйте проект
- Натисніть кнопку
[Запуск]у верхньому лівому куті
У Twilio
- Перейдіть до WhatsApp Senders, виберіть вашого відправника та призначте створену Messegine Service для нього
- Оновіть WhatsApp Sender
Використання
Розмова в меню Discuss
У WhatsApp:
- почніть розмову зі створеним ботом
- введіть свою електронну адресу (необов'язково)
В Odoo:
- Відкрийте меню
[[ Обговорення ]] - РЕЗУЛЬТАТ: буде створено два записи контактів, дочірній та батьківський. Пізніше, інші діти з різних месенджерів можуть приєднатися до батьківського запису
- РЕЗУЛЬТАТ: є канал з назвою WhatsApp:<НАЗВА WHATSAPP>.
- Відкрийте канал та відповідайте на повідомлення
У WhatsApp:
- РЕЗУЛЬТАТ: повідомлення буде доставлено через бота
Ви можете продовжувати чатити таким чином
Розмова в будь-якому документі, де є обговорення
В Odoo:
- Переконайтеся, що в
[[ Месенджери ]] >> Месенджери >> <Назва вашого бота> >> Параметриви маєте написано 'yes' в CHATTER - Додайте підписників до обговорення, натиснувши кнопку 'Додати підписників'. Вибирайте тільки батьківські контакти (без будь-якої назви бота)
- Натисніть на кнопку 'Надіслати повідомлення'. Виберіть кому та в якому месенджері надіслати повідомлення. Напишіть повідомлення та надішліть. Примітка: повідомлення буде надіслано не тільки в обраному месенджері, але й поштою. Щоб відключити надсилання поштою, ви можете натиснути кнопку Послідовники, вибрати послідовника, натиснути 'Редагувати підписку', та вимкнути 'Обговорення' і ввімкнути 'Примітка'
- У меню
[[ Обговорення ]]ви побачите повідомлення з документа з підписом, з якого документа воно було написане
У WhatsApp:
- РЕЗУЛЬТАТ: З'явиться нове повідомлення
- Дайте відповідь на це повідомлення. Примітка: Відповісти на повідомлення
В Odoo:
- РЕЗУЛЬТАТ: повідомлення з WhatsApp, яке ви побачите в документі чату
Support
We provide free bug fixes and updates for all our modules for 1 year after purchase.
The warranty is for a clean installation of Odoo.
If you need help, please submit a request through our Support Portal at https://unitsoft.com.ua/support. Our support team, which consists of the developers who created the product, is always ready to help you.
We will not provide support (for free) if our modules do not work on your server or conflict with other modules.
We are ready to consider your requests regarding the functionality of our modules, and if they prove useful, we can take them into account when releasing new versions.
We also provide all types of Odoo support services, such as installing Odoo on your server, maintaining your Odoo server, custom development.
We invite you to familiarize yourself with our support packages here: https://unitsoft.com.ua/services-plan
Our Odoo Apps
WhatsApp Integration
Twilio
- Register in Twilio: https://www.twilio.com/
- In the WhatsApp Senders tab, create a new sender with phone number
- If you don't have your own phone number, you can buy a Twilio phone number and use it to create a Messegine Service
Installation
- Install this module in according to us_messenger Documentation
Configuration
In WhatsApp
Find the bot with the created phone number
In Odoo
- Activate Developer Mode
- Open menu [[ Settings ]] >> Technical >> Parameters >> System Parameters
- Check that parameter web.base.url is properly set and it's accessible over internet (it should not be a localhost). Also, twilio accepts https addresses only (i.e. not http). If you can use only localhost, use ngrok
- Open menu [[ Messengers ]] >> Messengers
- Select Kanban card with whatsapp icon and name 'Enter_bot_name' project
- Enter the WhatsApp token, ID, phone number (should be as in the example, with "whatsapp:" at the beginning) in the required fields, all this is in the Twilio account, also enter the name in the field to create Messaging Services
- Enter bot name and select the operators with which the user will contact
- Unarchive the project
- Click button [Run Now] in the upper left corner
In Twilio
- Go to WhatsApp Senders, select your sender and assign the created Messaging Service to it
- Update WhatsApp Sender
Usage
Conversation in any document where there is a chatter
In Odoo:
- Make sure that in the [[ Messengers ]] >> Messengers >> <Your bot name> >> Parameters you have 'yes' written in CHATTER
- Add followers to chatter by clicking on button 'Add followers'. Select only parent contacts (without any bot name)
- Click on button 'Send Message'. Select to whom and in which messenger to send a message. Write message and send. Note: the message will be sent not only in the selected messenger but also by mail. To disable sending by mail you can click button Followers, select follower, click 'Edit subscription', and disable 'Discussions' and enable 'Note'
- In [[ Discuss ]] menu you will see the message from document with message with signature from which document it was written
In WhatsApp:
- RESULT: A new message will appear
- Answer on this message. Note: Reply to a message
In Odoo:
- RESULT: the message from WhatsApp you will see in chatter document
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module