Set Up Configurations for Twilio WhatsApp and Tess Payment Gateway
This guide is intended for personnel responsible for configuring and maintaining the Twilio WhatsApp and Tess payment gateway within ERPNext system
Configuring Twilio Settings
1. Using the search bar, navigate to OUN Twilio Settings DocType
Tip: You can find your Account SID and Auth Token in your Twilio account using this link
2. Get Account SID and Auth Token from your Twilio account, and paste them here in OUN Twilio Settings
3.
Tip: WhatsApp number should be in full international format includes a plus sign (+), then country code, and local phone number, without spaces. Ex: +97471905638
4. Write your WhatsApp business number registered in your Twilio account, to be used to send all WhatsApp messages outgoing from ERPNext system.
5. Enter the WhatsApp message that will be automatically sent when someone messages you. [[(optional field)]]
Tip: The default value for the Auto-Reply Trigger Interval (hours) field is 24.
6. For the Auto-Reply Trigger Interval (hours) field, enter the number of hours that must pass since the last message was received from a WhatsApp number before the system will send the automatic reply again. [[(optional field)]]
- For example, if the Auto-Reply Trigger Interval (hours) is set to 2, the system will send the automatic Reply Message the first time a message is received from a WhatsApp number. If another message is received from the same number within 2 hours, the system will not resend the Reply Message, as it doesn't make sense to send the same reply multiple times during an ongoing conversation. However, after 2 hours have passed since the last message received, the system will send the Reply Message again when a new message is received.
7. Check Enable for Tess Payment Gateway checkbox
Tip: In your Twilio account you will find that we have created 5 message templates for you with the same names of field names in Tess Payment Gateway Messages Templates section here, each one is for a certain type of messages used when sending a payment request message for customer.
- You can find these templates in your Twilio account using this link.
- Feel free to edit the text message of any template, but please keep the variables used inside the template and it's order as it.
8. These are the 5 fields for WhatsApp message template SIDs, copy the SID for each template and paste it here in the corresponding field.
9. Don't forget to enable OUN Twilio Settings by check the Enabled checkbox
10. Click Save
Creating and Configuring new Tess Settings for WhatsApp communication
11. Navigate to Tess Settings DocType
12. Click Add Tess Settings
13. Enter Tess Payment Gateway Name, Merchant Key and password, then start configuring and filling fields with the appropriate values
14. Continue configuring values ...
15. Continue configuring values ...
Tip: When saving Tess settings, system will check that the entered Tess credentials are correct, if not, system will show a message noting which value is incorrect
16. When finish, Click Save
Tip: If you've previously used Tess Payment Gateway to send Payment Requests via email, then you are already done with this next step and can skip it and move on to the next one.
Create new account in COA to deal with all Tess type transactions
17. Navigate to Chart of Accounts, and add the account as a [[receivable]] account
18. Fill account information
19. Select Account Type as [[Receivable]], and continue entering values
20. Click Create New
Configure the Payment gateway Account for the new Tess Settings
21. Navigate to Payment Gateway Account List
22. See the payment gateway account that contains the name of the newly created Tess Settings, then click on it
23. See Payment Account field, delete the old value, and select the account that you created in CAO for Tess
24. Set Payment Channel to [[Phone]]
25. Click Save
Delete the account from COA for the newly created Tess Settings, which created automatically when you created the new Tess Settings
26. Navigate to Chart of Accounts, and find the Tess account that contains the name of the newly created Tess Settings, then click on it. (The image below is for COA as a list view, you can view the COA as a List or as a Tree)
27. From the Menu, see the Delete button
28. Click Delete
29. Click Yes
Create "Tess" Mode of Payment
30. Navigate to Mode of Payment List
31. Click Add Mode of Payment button, then start filling values
32. Click on Add Row button to add Account
33. For the Default Account field, select the new account that we created in COA for Tess
34. Click Save
Configure Customer profile
Tip: In this step, we primarily need to confirm two things for the customer:
- Customer contact information
- Customer payment gateway
You can add any other relevant information as needed.
35. Navigate to Cutomer List, then click on a customer you want to enable sending payment request via WhatsApp for him
36. Note Payment Gateway field. From this field you can select the payment gateway that you created for WhatsApp communication, as a payment gateway for this customer
37. Click Contact & Address tab
38. Click New Contact
39. Fill contact information
40. Enter Email ID
41. Check Is Primary checkbox for this Email ID
Tip: Note:
- WhatsApp number should be in full international format includes a plus sign (+), then country code, and local phone number, without spaces. Ex: +97471905638
- WhatsApp number should be selected as Primary Mobile
42. Enter WhatsApp number for this contact
43. Check Is Primary Mobile checkbox
44. Click Save to save the Contact information
45. Then, from the Customer profile, see Customer Primary Contact field and select the contact that you just created
46.
47. Note that the Mobile No and Email Id fields are automatically filled with the values you have configured
48. Click Save to save the Customer information
Tip: Congratulations !
Configurations are done, and the system is ready now to start the process with Sales Invoice or Sales Order