> For the complete documentation index, see [llms.txt](https://support.whapi.cloud/help-desk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.whapi.cloud/help-desk/integrations/albato/how-to-use-whapi.cloud-in-albato-automations.md).

# 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:

* A [Whapi.Cloud account](https://panel.whapi.cloud).
* 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

1. Sign in to your [Albato account](https://albato.com).
2. Open **Automations**.
3. Click **New** to create an automation.
4. Select the application that will trigger your workflow.
5. Choose a trigger event.
6. Add Whapi.Cloud as an action, or select a Whapi.Cloud trigger if you want to start the workflow from WhatsApp.
7. Select your Whapi.Cloud connection.
8. Configure the required fields.
9. Test the workflow.
10. 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:**

1. Create a new automation in Albato.
2. Select your form application as the trigger.
3. Choose the new submission event.
4. Add Whapi.Cloud as an action.
5. Select **Send Text Message**.
6. Choose your Whapi.Cloud connection.
7. Fill in the required recipient and message fields.
8. Map the customer's phone number from the form to the recipient field.
9. Enter the message text.
10. 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:**

1. Create a new Albato automation.
2. Select Whapi.Cloud as the trigger application.
3. Choose **New Message**.
4. Select your Whapi.Cloud connection.
5. Add another step.
6. Select Whapi.Cloud → **Get Message by ID**.
7. Map the message identifier from the trigger into the corresponding action field.
8. Complete any other required fields displayed in Albato.
9. Test the workflow using a real message event.
10. 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:**

1. Create a new Albato automation.
2. Choose a CRM trigger such as a newly created contact.
3. Add Whapi.Cloud as an action.
4. Select **Check Phone Number**.
5. Select your Whapi.Cloud connection.
6. Map the customer's phone number into the action's required input field.
7. Run a test using a number you control.
8. Inspect the response fields.
9. Add an Albato filter using the appropriate result field.
10. In the branch that satisfies your condition, add **Send Text Message**.
11. Map the recipient and message text.
12. 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:**

1. Create a new automation in Albato.
2. Choose Whapi.Cloud as the trigger application.
3. Select **New Message**.
4. Select the required Whapi.Cloud connection.
5. Complete any additional settings displayed for the trigger.
6. Start the trigger test in Albato.
7. Send a WhatsApp message from a separate test account to your connected channel.
8. Verify that Albato receives the event.
9. Add a Google Sheets action that creates a new row.
10. Map available message fields into the spreadsheet columns.
11. Test the complete automation.
12. 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:**

1. Create a new automation in Albato.
2. Choose Whapi.Cloud as the trigger application.
3. Select **Group hook**.
4. Select your Whapi.Cloud connection.
5. Complete the trigger's required settings.
6. Start the test process in Albato.
7. Generate a supported group event in a test WhatsApp group.
8. Confirm that Albato receives the event.
9. Add an action to save the event information to Google Sheets.
10. Map the available grou
