Set up messages to customers
Connect the company's business number, register the approved message templates, record each customer's consent, and follow the messages and photo readings that customers send from their phone.
Updated on
Once messages are set up, customers can ask the company number for their latest invoice, send a photo of their meter and check their support requests from their phone, and your team can send a notice to a whole neighbourhood. The Owner and Administrator roles set up the connection and templates; the Customer service role can also send notices.
Before you start#
- Have the business account details from your messaging provider ready: the phone number ID, the business account ID, the access token, the app secret and a verify token you choose.
- Customers' mobile numbers must be on their water accounts. A number that belongs to no account gets no menu and cannot have consent recorded.
- Message templates must already be approved by your messaging provider before you register them here.
Step 1: Save the connection#
- In the web app, open Messages and choose Connection.
- Fill in Phone number ID, the business account ID, Access token, App secret and Verify token.
- Click Save connection. The page now shows Connected to number and the callback URL.
- Copy that URL and your verify token into your messaging provider's webhook settings.
Step 2: Register the approved templates#
- Under Messages, open Templates and click New template.
- Enter the Name and Language exactly as they appear at your messaging provider (for example
pt_PT). - Under Status, choose Approved, paste the Text and click Save template.
Step 3: Record consent and send a notice#
- In Contacts, click Record consent, enter the Mobile phone number, choose Agrees to receive notices or Does not agree, and click Record.
- In Notices, click Send notice.
- Enter the Neighbourhood, choose the Approved template and, if the template has variables, fill in Parameters separated by ; in the order they appear.
- Click Send notice.
What happens next#
- The notice reaches only contacts in that neighbourhood whose consent reads Opted in. A message tells you how many received it and how many were left out for lack of consent; the Notices sent list shows the Sent, Failed and No consent columns.
- A customer who replies PARAR, STOP or SAIR moves to Opted out; one who replies SIM, ACEITO, YES or START moves to Opted in.
- Conversations lists every message: incoming ones show Received, and outgoing ones move through Sent, Delivered, Read or Failed, with the failure reason in the Reference / reason column.
- When a customer picks option 2 from the menu and sends a meter photo, the reading appears in Photo readings. If the caption carries the value and the account has a meter, the reading is submitted (Submitted). Without a value, or if the submission is refused, it waits for your team to review it and the list shows it as Unknown.
Common problems#
- You see Could not connect: one of the required fields (phone number ID, access token, app secret or verify token) is empty, or that number is already connected to another company.
- The Send notice button is greyed out: notices go out only after the connection is saved. Finish Step 1.
- The template is missing from Approved template: only templates with the Approved status are offered. Open the template and check its status.
- Saving consent shows Could not record it: the number is not linked to any water account. Update the customer's mobile number and try again.