Send WhatsApp Message
📱 Node: Send WhatsApp Message¶
This node allows you to send WhatsApp messages automatically from your automations. It uses the Twilio service to connect with WhatsApp.
🔧 Initial Setup: Twilio Registration¶
Before you can use this node, you need to register your WhatsApp number in Twilio's production environment. You have two ways to do this:
Option 1: Scan QR Code¶
- Open WhatsApp on your mobile phone.
- Scan the following QR code:
- The QR code will take you directly to the Twilio chat with the message "join neighbor-use" already written.
- Send the message and you will receive a confirmation indicating that your number has been successfully registered in Twilio's production environment.
Option 2: Send Text Message¶
If you prefer not to use the QR code, you can register your number by sending a text message:
- Open WhatsApp on your mobile phone.
- Send the following message to number +14155238886:
join neighbor-use - You will receive a confirmation indicating that your number has been successfully registered.
⚙️ Node Configuration¶
Once you have registered your number, you can configure the node. Below we explain each field in the form:
📋 Form Fields¶
1. Phone Number (Sender) ⚠️¶
What is it?
The phone number from which the message will be sent. This must be the Twilio number you have configured.
What should I enter?
In the production environment, use: +14155238886
Example:
+14155238886
2. Phone Numbers (Receivers) ⚠️¶
What is it?
The phone numbers that will receive the WhatsApp message. You can add one or multiple recipients.
What should I enter?
- Enter the complete number with country code, including the
+sign at the beginning. - Example:
+13313210156(where+1is the United States code and3313210156is the local number). - If you need to send to multiple numbers, click "+ Add Phone Number" to add more recipients.
- You can remove a number by clicking the delete button (🗑️) next to each number.
Example:
+13313210156
Important: In Twilio's production environment, you can only send messages to numbers that have been previously registered following the steps in the "Initial Setup" section above.
3. Message Body ⚠️¶
What is it?
The text of the message that will be sent via WhatsApp.
What should I enter?
Write the message you want to send. It can be any text, emojis, or even variables from your automation.
Example:
Hello, from automation
With variables (advanced example):
Hello {{name}}, your temperature sensor recorded {{temperature}}°C
4. Account ID ⚠️¶
What is it?
The unique identifier for your Twilio account. It's like a "username" for your account.
Where do I find it?
- Log in to your Twilio account: https://www.twilio.com/console
- On the main dashboard, you'll see your Account SID (also called Account ID).
- Copy this value and paste it in this field.
Example:
ACfXXXbbcf51123f1eXXX25af164484bXXXXXXX
Security: This field is hidden by default (shown as dots) to protect your information. You can click the eye icon 👁️ to show or hide the text.
5. Auth Token ⚠️¶
What is it?
A special password that allows the system to verify that you are the owner of the Twilio account. It's like a "secret key" to access your account.
Where do I find it?
- Log in to your Twilio account: https://www.twilio.com/console
- On the main dashboard, you'll see your Auth Token.
- Click the eye icon 👁️ to reveal the token (it's hidden for security).
- Copy this value and paste it in this field.
Example:
f312791bac4515d70dabcaca9885aXX5XX
⚠️ Important Security Note:
- Never share your Auth Token with anyone.
- If someone has access to your Account ID and Auth Token, they can use your Twilio account.
- This field is hidden by default. You can click the eye icon 👁️ to show or hide the text.
6. Latitude (Optional)¶
What is it?
The latitude coordinate of the location you want to send in the WhatsApp message.
What should I enter?
- Enter a numeric value representing the latitude (north-south coordinate).
- The value must be between -90 and 90.
- This field is optional. If you leave it empty, no location will be sent.
Example:
11.054295271183525
Note: If you want to send a location, you must fill in both latitude and longitude. You can also add a label to identify the location.
7. Longitude (Optional)¶
What is it?
The longitude coordinate of the location you want to send in the WhatsApp message.
What should I enter?
- Enter a numeric value representing the longitude (east-west coordinate).
- The value must be between -180 and 180.
- This field is optional. If you leave it empty, no location will be sent.
Example:
-63.827733899456035
Note: If you want to send a location, you must fill in both latitude and longitude. You can also add a label to identify the location.
8. Label (Optional)¶
What is it?
A descriptive name or label for the location you are sending.
What should I enter?
- Enter a descriptive text that identifies the location (e.g., "Main Office", "Warehouse 1", "Twilio HQ").
- This field is optional, but recommended if you are sending a location so the recipient knows what place it represents.
Example:
Point A Warehouse
Note: This field only makes sense if you are also sending latitude and longitude coordinates.
9. Media URLs (Optional)¶
What is it?
Links to images, videos, or documents that you want to send along with the text message.
What should I enter?
- Enter the complete URL (web address) of the image, video, or document you want to send.
- The URL must be publicly accessible on the internet (it cannot be a local file on your computer).
- If you want to send multiple files, separate the URLs with commas.
Example of an image:
https://images.ctfassets.net/ihx0a8chifpc/gPyHKDGI0md4NkRDjs4k8/36be1e73008a0181c1980f727f29d002/avatar-placeholder-generator-500x500.jpg
Example of multiple files:
https://example.com/image1.jpg, https://example.com/video1.mp4, https://example.com/document.pdf
Note: This field is optional. If you don't want to send any attachments, you can leave it empty.
✅ Required Fields Summary¶
Fields marked with ⚠️ are mandatory and must be completed for the node to work:
- ✅ Phone Number (Sender) - Sender number
- ✅ Phone Numbers (Receivers) - Recipient numbers
- ✅ Message Body - Message text
- ✅ Account ID - Your Twilio account ID
- ✅ Auth Token - Twilio authentication token
- ⭕ Latitude - Latitude (optional, for sending location)
- ⭕ Longitude - Longitude (optional, for sending location)
- ⭕ Label - Location label (optional, recommended if sending location)
- ⭕ Media URLs - Attachments (optional)
🎯 Complete Configuration Example¶
Here's an example of how the node would be configured:
- Phone Number (Sender):
+14155238886 - Phone Numbers (Receivers):
+123445435 - Message Body:
Test message from automation backend, HI - Account ID:
xxxxxxxxxx - Auth Token:
xxxxxxxxxxxx - Latitude:
11.054295271183525 - Longitude:
-63.827733899456035 - Label:
Twilio HQ
🔍 Troubleshooting¶
Message is not being sent¶
- Verify that your number is registered:
-
Make sure you have completed the registration step (QR or text message).
-
Verify that the recipient number is registered:
-
In the production environment, you can only send messages to numbers that are also registered.
-
Check your credentials:
- Confirm that the Account ID and Auth Token are correct.
-
You can verify these values in your Twilio console.
-
Verify the number format:
- All numbers must include the country code with the
+sign at the beginning. - Correct example:
+13313123456 - Incorrect example:
13313123456(missing the+1)
I can't find my Account ID or Auth Token¶
- Go to https://www.twilio.com/console
- Log in to your account
- On the main dashboard you'll see both values
- To view the Auth Token, click the eye icon 👁️
📚 Additional Information¶
- Twilio Production Environment: The production environment allows you to send messages only to registered numbers. To send to any number, you'll need a Twilio account approved for production.
- Limits: The production environment has limits on the number of messages you can send. Consult Twilio documentation for more details.
- Support: If you have problems with your Twilio account, contact Twilio support directly.