How to Use Whapi.Cloud in Albato Automations
Automate WhatsApp messaging and connect your conversations with CRM systems, online forms, databases, and other applications using Whapi.Cloud and Albato.
This guide covers the available Whapi.Cloud triggers and actions, explains how to configure them, and provides practical automation examples.
1. Before You Start
Make sure you have:
An active Whapi.Cloud channel connected to your WhatsApp account.
An Albato account.
A Whapi.Cloud connection configured in Albato using your channel's API token.
If you haven't connected your account yet, follow the How to Connect Whapi.Cloud to Albato connection guide.
Each Whapi.Cloud channel is associated with a particular WhatsApp account. If you have multiple channels, choose the correct connection when configuring your automation.
2. Available Whapi.Cloud Triggers and Actions
The Whapi.Cloud integration currently provides two triggers and three actions.
Triggers
Triggers start automations when supported events occur.
Trigger
Description
New Message
Starts an automation when a new WhatsApp message event is received.
Group hook
Starts an automation when a supported WhatsApp group event is received.
Both triggers use webhook-based event delivery.
Actions
Actions perform operations through the Whapi.Cloud API.
Action
Description
Send Text Message
Sends a text message to a WhatsApp recipient or chat.
Get Message by ID
Retrieves information about a particular WhatsApp message using its identifier.
Check Phone Number
Checks information about a phone number, including WhatsApp availability when returned by the API.
The input and output fields displayed in Albato depend on the configuration of each action or trigger.
3. How to Create an Automation in Albato
Sign in to your Albato account.
Open Automations.
Click New to create an automation.
Select the application that will trigger your workflow.
Choose a trigger event.
Add Whapi.Cloud as an action, or select a Whapi.Cloud trigger if you want to start the workflow from WhatsApp.
Select your Whapi.Cloud connection.
Configure the required fields.
Test the workflow.
Click Start to activate it.
An Albato automation consists of a trigger followed by one or more actions. You can use data from earlier steps to configure subsequent actions.
4. Action: Send Text Message
Purpose: Send a WhatsApp text message automatically using your connected Whapi.Cloud channel.
Example: Send a WhatsApp Notification When a New Lead Is Created
Suppose you collect customer inquiries through an online form and want to automatically send each customer a confirmation.
Workflow:
New Form Submission → Albato → Whapi.Cloud: Send Text Message
Setup:
Create a new automation in Albato.
Select your form application as the trigger.
Choose the new submission event.
Add Whapi.Cloud as an action.
Select Send Text Message.
Choose your Whapi.Cloud connection.
Fill in the required recipient and message fields.
Map the customer's phone number from the form to the recipient field.
Enter the message text.
Test the action using a WhatsApp number you control.
Example message:
Hello! Thank you for your inquiry. We have received your request and will contact you shortly.
Phone Number Format
For individual WhatsApp recipients, use the international phone number format without spaces, brackets, or a leading plus sign.
Example: 14155550123
If your source application provides numbers with formatting characters, normalize them before sending the data to Whapi.Cloud.
When the action accepts a chat identifier instead of a phone number, use the identifier format required by that specific field.
Personalizing Messages
You can insert dynamic data from previous automation steps into your message.
For example:
Hello [Customer Name]! Your order [Order Number] has been received.
Use Albato's field-mapping interface to select the customer name and order number from the trigger data.
The values in square brackets are explanatory placeholders, not literal Albato variable syntax.
5. Action: Get Message by ID
Purpose: Retrieve information about a WhatsApp message using its message identifier.
This is useful when your workflow needs additional information about a message that was received or processed earlier.
Example: Retrieve Message Details for Further Processing
Workflow:
New Message → Get Message by ID → CRM or Database
Setup:
Create a new Albato automation.
Select Whapi.Cloud as the trigger application.
Choose New Message.
Select your Whapi.Cloud connection.
Add another step.
Select Whapi.Cloud → Get Message by ID.
Map the message identifier from the trigger into the corresponding action field.
Complete any other required fields displayed in Albato.
Test the workflow using a real message event.
Use the action's returned data in a subsequent automation step.
Depending on the message and API response, retrieved information may include message identifiers, chat information, content, timestamps, or other message metadata.
Important Notes
Use the exact message identifier provided by Whapi.Cloud.
Make sure you are using the channel associated with the message.
A message that is unavailable or cannot be found may produce an error.
Only map output fields that are present in your action's actual test response.
6. Action: Check Phone Number
Purpose: Check a phone number through Whapi.Cloud before proceeding with further automation steps.
This action can be useful for workflows that need to verify WhatsApp availability before attempting to send a message.
Example: Check a Customer Number Before Sending a Notification
Workflow:
New CRM Contact → Check Phone Number → Filter → Send Text Message
Setup:
Create a new Albato automation.
Choose a CRM trigger such as a newly created contact.
Add Whapi.Cloud as an action.
Select Check Phone Number.
Select your Whapi.Cloud connection.
Map the customer's phone number into the action's required input field.
Run a test using a number you control.
Inspect the response fields.
Add an Albato filter using the appropriate result field.
In the branch that satisfies your condition, add Send Text Message.
Map the recipient and message text.
Test the complete workflow.
Important: Configure your filter using the actual response returned by the Check Phone Number action. Do not assume a particular response field name or value without testing it.
A successful phone-number check does not constitute permission to contact a recipient or guarantee delivery of future messages.
7. Trigger: New Message
Purpose: Start an automation when the configured Whapi.Cloud webhook delivers a new WhatsApp message event.
Example: Save Incoming WhatsApp Messages to Google Sheets
Workflow:
Whapi.Cloud: New Message → Albato → Google Sheets: Add Row
Setup:
Create a new automation in Albato.
Choose Whapi.Cloud as the trigger application.
Select New Message.
Select the required Whapi.Cloud connection.
Complete any additional settings displayed for the trigger.
Start the trigger test in Albato.
Send a WhatsApp message from a separate test account to your connected channel.
Verify that Albato receives the event.
Add a Google Sheets action that creates a new row.
Map available message fields into the spreadsheet columns.
Test the complete automation.
Activate it.
Suggested Spreadsheet Columns
Received At
Sender
Chat ID
Message ID
Message Content
Message Type
Map each column to the corresponding field exposed by the tested New Message trigger.
Some message types may not contain a plain-text body.
Important Notes
New Message is a webhook-based trigger. It requires a working event subscription between Whapi.Cloud and Albato.
If a test event does not arrive, check the connected channel, trigger setup, and webhook delivery configuration.
Incoming and outgoing message events can differ. If you want to process incoming messages only, inspect the available direction or sender fields and configure a filter where appropriate.
8. Trigger: Group hook
Purpose: Start an Albato automation when Whapi.Cloud delivers a group-related webhook event supported by this trigger.
This trigger can be useful for tracking relevant activity in WhatsApp groups.
The exact events and fields depend on the webhook event subscription and the Group hook configuration.
Example: Record Group Events in a Spreadsheet
Workflow:
Whapi.Cloud: Group hook → Albato → Google Sheets
Setup:
Create a new automation in Albato.
Choose Whapi.Cloud as the trigger application.
Select Group hook.
Select your Whapi.Cloud connection.
Complete the trigger's required settings.
Start the test process in Albato.
Generate a supported group event in a test WhatsApp group.
Confirm that Albato receives the event.
Add an action to save the event information to Google Sheets.
Map the available grou
Last updated