Skip to content
← Back to documentation
Technical Reference

WhatsScale

Send WhatsApp messages, manage contacts, and automate conversations via WAHA

CategoryCommunication
Authenticationcustom
Version1.1.0
Published scopes0 published scopes
Last updatedSeptember 24, 2026

Overview

Connect WhatsScale with Flows360

Send WhatsApp messages, manage contacts, and automate conversations via WAHA

Use the WhatsScale connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 56 actions and 5 triggers.

Available actions

  • Send a Message to a Contact
  • Send a Message to a Group
  • Send a Text to a Channel
  • Send a Message to a CRM Contact
  • Send an Image to a Contact
  • Send an Image to a Group
  • Send an Image to a Channel
  • Send an Image to a CRM Contact
  • Plus 48 additional declared actions.

Available triggers

  • Watch Channel Messages
  • Watch Group Messages
  • Watch Incoming Messages
  • Watch Specific Group Messages
  • Watch Specific Channel Messages

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: WhatsScale
  • Package: @activepieces/piece-whatsscale@1.1.0
  • Exact artifact digest: sha256:5f1292b113749fe2f61e5c9d6ec994e1b1335d3d48ba57005d26a40b8bd70d96
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

SECRET TEXT. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • Send a Message to a Contact (whatsscale_send_text_to_contact), Send a text message to a WhatsApp contact selected from your contact list Classification: read.
  • Send a Message to a Group (whatsscale_send_text_to_group), Send a text message to a WhatsApp group selected from your group list Classification: read.
  • Send a Text to a Channel (whatsscale_send_text_to_channel), Send a text message to a WhatsApp Channel Classification: read.
  • Send a Message to a CRM Contact (whatsscale_send_text_to_crm_contact), Send a text message to a contact from your WhatsScale CRM Classification: read.
  • Send an Image to a Contact (whatsscale_send_image_to_contact), Send an image to a WhatsApp contact selected from the dropdown. Classification: read.
  • Send an Image to a Group (whatsscale_send_image_to_group), Send an image to a WhatsApp group selected from the dropdown. Classification: read.
  • Send an Image to a Channel (whatsscale_send_image_to_channel), Broadcast an image to a WhatsApp Channel selected from the dropdown. Classification: read.
  • Send an Image to a CRM Contact (whatsscale_send_image_to_crm_contact), Send an image to a WhatsScale CRM contact selected from the dropdown. Classification: read.
  • Send a Video to a Contact (whatsscale_send_video_to_contact), Send a video to a WhatsApp contact selected from the dropdown. Classification: read.
  • Send a Video to a Group (whatsscale_send_video_to_group), Send a video to a WhatsApp group selected from the dropdown. Classification: read.
  • Send a Video to a Channel (whatsscale_send_video_to_channel), Broadcast a video to a WhatsApp Channel selected from the dropdown. Classification: read.
  • Send a Video to a CRM Contact (whatsscale_send_video_to_crm_contact), Send a video to a WhatsScale CRM contact selected from the dropdown. Classification: read.
  • Send a Document to a Contact (whatsscale_send_document_to_contact), Send a document to a WhatsApp contact selected from the dropdown. Classification: read.
  • Send a Document to a Group (whatsscale_send_document_to_group), Send a document to a WhatsApp group selected from the dropdown. Classification: read.
  • Send a Document to a CRM Contact (whatsscale_send_document_to_crm_contact), Send a document to a WhatsScale CRM contact selected from the dropdown. Classification: read.
  • Get a CRM Contact (whatsscale_get_crm_contact), Retrieve a CRM contact by ID Classification: read.
  • Update a CRM Contact (whatsscale_update_crm_contact), Update the name or tags of an existing CRM contact Classification: read.
  • Delete a CRM Contact (whatsscale_delete_crm_contact), Permanently delete a contact from your WhatsScale CRM Classification: read.
  • Add Tags to a CRM Contact (whatsscale_add_crm_contact_tag), Add one or more tags to an existing CRM contact Classification: read.
  • Remove a Tag from a CRM Contact (whatsscale_remove_crm_contact_tag), Remove a single tag from a CRM contact Classification: read.
  • Create a CRM Contact (whatsscale_create_crm_contact), Add a new contact to your WhatsScale CRM Classification: read.
  • Find a CRM Contact by Phone (whatsscale_find_crm_contact_by_phone), Look up a CRM contact using their phone number Classification: read.
  • List CRM Contacts (whatsscale_list_crm_contacts), Retrieve a paginated list of CRM contacts with optional filters Classification: read.
  • List CRM Tags (whatsscale_list_crm_tags), List every unique tag currently used across CRM contacts. Classification: read.
  • Send an Audio Message (By ID) (whatsscale_send_audio_manual), Send an audio file to a contact, group, channel, or CRM contact by ID rather than picking from a list. Classification: read.
  • Send a Location (By ID) (whatsscale_send_location_manual), Send GPS coordinates to a contact, group, channel, or CRM contact by ID rather than picking from a list. Classification: read.
  • Send a Poll (By ID) (whatsscale_send_poll_manual), Send an interactive poll to a contact, group, channel, or CRM contact by ID rather than picking from a list. Classification: read.
  • Add Participants to a Group (whatsscale_add_participants_to_group), Add contacts to a WhatsApp group, both selected from dropdowns. Classification: read.
  • Remove Participants from a Group (whatsscale_remove_participants_from_group), Remove members from a WhatsApp group, both selected from dropdowns. Classification: read.
  • Promote Group Admins (whatsscale_promote_admins_in_group), Grant admin rights to members of a WhatsApp group, both selected from dropdowns. Classification: read.
  • Demote Group Admins (whatsscale_demote_admins_in_group), Revoke admin rights from members of a WhatsApp group, both selected from dropdowns. Classification: read.
  • Leave a Group (whatsscale_leave_selected_group), Make the connected session leave a WhatsApp group selected from the dropdown. Classification: read.
  • List Group Participants (whatsscale_list_participants_in_group), List the members of a WhatsApp group selected from the dropdown, and their roles. Classification: read.
  • Add Participants to a Group (By ID) (whatsscale_add_group_participants_by_id), Add one or more people to a WhatsApp group by group ID. Classification: read.
  • Remove Participants from a Group (By ID) (whatsscale_remove_group_participants_by_id), Remove (kick) one or more people from a WhatsApp group by group ID. Classification: read.
  • Promote Group Admins (By ID) (whatsscale_promote_group_admins_by_id), Grant admin rights to one or more group members by group ID. Classification: read.
  • Demote Group Admins (By ID) (whatsscale_demote_group_admins_by_id), Revoke admin rights from one or more group members by group ID. Classification: read.
  • Leave a Group (By ID) (whatsscale_leave_group_by_id), Make the connected session leave a WhatsApp group by group ID. Classification: read.
  • List Group Participants (By ID) (whatsscale_list_group_participants_by_id), List the members of a WhatsApp group and their roles, by group ID. Classification: read.
  • Post a Text Status (whatsscale_post_text_status), Post a text-only WhatsApp Status (story) with an optional background color. Classification: read.
  • Post an Image Status (whatsscale_post_image_status), Post an image WhatsApp Status (story) with an optional caption. Classification: read.
  • Post a Video Status (whatsscale_post_video_status), Post a video WhatsApp Status (story) with an optional caption. Classification: read.
  • Check WhatsApp Number (whatsscale_check_whatsapp), Check if a phone number has WhatsApp Classification: read.
  • List WhatsApp Sessions (whatsscale_list_sessions), List every WhatsApp session (device) connected to this account, and its status. Classification: read.
  • List WhatsApp Contacts (whatsscale_list_whatsapp_contacts), List the raw WhatsApp contacts synced to a session. Not the same as the WhatsScale CRM contacts. Classification: read.
  • List WhatsApp Groups (whatsscale_list_whatsapp_groups), List the WhatsApp groups a session belongs to. Classification: read.
  • Send a Text Message (By ID) (whatsscale_send_text_manual), Send a text message to a contact, group, channel, or CRM contact by ID rather than picking from a list. Classification: read.
  • Send an Image (By ID) (whatsscale_send_image_manual), Send an image to a contact, group, channel, or CRM contact by ID rather than picking from a list. Classification: read.
  • Send a Video (By ID) (whatsscale_send_video_manual), Send a video to a contact, group, channel, or CRM contact by ID rather than picking from a list. Classification: read.
  • Send a Document (By ID) (whatsscale_send_document_manual), Send a document to a contact, group, channel, or CRM contact by ID rather than picking from a list. Classification: read.
  • Get a CRM Contact (By ID) (whatsscale_get_crm_contact_by_id), Retrieve a CRM contact by ID, entered directly rather than picked from a list. Classification: read.
  • Update a CRM Contact (By ID) (whatsscale_update_crm_contact_by_id), Update the name or tags of a CRM contact, entered directly rather than picked from a list. Classification: read.
  • Delete a CRM Contact (By ID) (whatsscale_delete_crm_contact_by_id), Permanently delete a CRM contact by ID, entered directly rather than picked from a list. Classification: read.
  • Add Tags to a CRM Contact (By ID) (whatsscale_add_crm_contact_tag_by_id), Add one or more tags to a CRM contact, entered directly rather than picked from a list. Classification: read.
  • Remove a Tag from a CRM Contact (By ID) (whatsscale_remove_crm_contact_tag_by_id), Remove a single tag from a CRM contact, entered directly rather than picked from a list. Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • Watch Channel Messages, webhook.
  • Watch Group Messages, webhook.
  • Watch Incoming Messages, webhook.
  • Watch Specific Group Messages, webhook.
  • Watch Specific Channel Messages, webhook.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

Authenticationcustom
Supported objects61
Supported actionsNot published
Triggers5

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • API Key Required · protected credential

Supported objects

ObjectReadWriteNotes
Send a Message to a Contact Yes No Send a text message to a WhatsApp contact selected from your contact list
Send a Message to a Group Yes No Send a text message to a WhatsApp group selected from your group list
Send a Text to a Channel Yes No Send a text message to a WhatsApp Channel
Send a Message to a CRM Contact Yes No Send a text message to a contact from your WhatsScale CRM
Send an Image to a Contact Yes No Send an image to a WhatsApp contact selected from the dropdown.
Send an Image to a Group Yes No Send an image to a WhatsApp group selected from the dropdown.
Send an Image to a Channel Yes No Broadcast an image to a WhatsApp Channel selected from the dropdown.
Send an Image to a CRM Contact Yes No Send an image to a WhatsScale CRM contact selected from the dropdown.
Send a Video to a Contact Yes No Send a video to a WhatsApp contact selected from the dropdown.
Send a Video to a Group Yes No Send a video to a WhatsApp group selected from the dropdown.
Send a Video to a Channel Yes No Broadcast a video to a WhatsApp Channel selected from the dropdown.
Send a Video to a CRM Contact Yes No Send a video to a WhatsScale CRM contact selected from the dropdown.
Send a Document to a Contact Yes No Send a document to a WhatsApp contact selected from the dropdown.
Send a Document to a Group Yes No Send a document to a WhatsApp group selected from the dropdown.
Send a Document to a CRM Contact Yes No Send a document to a WhatsScale CRM contact selected from the dropdown.
Get a CRM Contact Yes No Retrieve a CRM contact by ID
Update a CRM Contact Yes No Update the name or tags of an existing CRM contact
Delete a CRM Contact Yes No Permanently delete a contact from your WhatsScale CRM
Add Tags to a CRM Contact Yes No Add one or more tags to an existing CRM contact
Remove a Tag from a CRM Contact Yes No Remove a single tag from a CRM contact
Create a CRM Contact Yes No Add a new contact to your WhatsScale CRM
Find a CRM Contact by Phone Yes No Look up a CRM contact using their phone number
List CRM Contacts Yes No Retrieve a paginated list of CRM contacts with optional filters
List CRM Tags Yes No List every unique tag currently used across CRM contacts.
Send an Audio Message (By ID) Yes No Send an audio file to a contact, group, channel, or CRM contact by ID rather than picking from a list.
Send a Location (By ID) Yes No Send GPS coordinates to a contact, group, channel, or CRM contact by ID rather than picking from a list.
Send a Poll (By ID) Yes No Send an interactive poll to a contact, group, channel, or CRM contact by ID rather than picking from a list.
Add Participants to a Group Yes No Add contacts to a WhatsApp group, both selected from dropdowns.
Remove Participants from a Group Yes No Remove members from a WhatsApp group, both selected from dropdowns.
Promote Group Admins Yes No Grant admin rights to members of a WhatsApp group, both selected from dropdowns.
Demote Group Admins Yes No Revoke admin rights from members of a WhatsApp group, both selected from dropdowns.
Leave a Group Yes No Make the connected session leave a WhatsApp group selected from the dropdown.
List Group Participants Yes No List the members of a WhatsApp group selected from the dropdown, and their roles.
Add Participants to a Group (By ID) Yes No Add one or more people to a WhatsApp group by group ID.
Remove Participants from a Group (By ID) Yes No Remove (kick) one or more people from a WhatsApp group by group ID.
Promote Group Admins (By ID) Yes No Grant admin rights to one or more group members by group ID.
Demote Group Admins (By ID) Yes No Revoke admin rights from one or more group members by group ID.
Leave a Group (By ID) Yes No Make the connected session leave a WhatsApp group by group ID.
List Group Participants (By ID) Yes No List the members of a WhatsApp group and their roles, by group ID.
Post a Text Status Yes No Post a text-only WhatsApp Status (story) with an optional background color.
Post an Image Status Yes No Post an image WhatsApp Status (story) with an optional caption.
Post a Video Status Yes No Post a video WhatsApp Status (story) with an optional caption.
Check WhatsApp Number Yes No Check if a phone number has WhatsApp
List WhatsApp Sessions Yes No List every WhatsApp session (device) connected to this account, and its status.
List WhatsApp Contacts Yes No List the raw WhatsApp contacts synced to a session. Not the same as the WhatsScale CRM contacts.
List WhatsApp Groups Yes No List the WhatsApp groups a session belongs to.
Send a Text Message (By ID) Yes No Send a text message to a contact, group, channel, or CRM contact by ID rather than picking from a list.
Send an Image (By ID) Yes No Send an image to a contact, group, channel, or CRM contact by ID rather than picking from a list.
Send a Video (By ID) Yes No Send a video to a contact, group, channel, or CRM contact by ID rather than picking from a list.
Send a Document (By ID) Yes No Send a document to a contact, group, channel, or CRM contact by ID rather than picking from a list.
Get a CRM Contact (By ID) Yes No Retrieve a CRM contact by ID, entered directly rather than picked from a list.
Update a CRM Contact (By ID) Yes No Update the name or tags of a CRM contact, entered directly rather than picked from a list.
Delete a CRM Contact (By ID) Yes No Permanently delete a CRM contact by ID, entered directly rather than picked from a list.
Add Tags to a CRM Contact (By ID) Yes No Add one or more tags to a CRM contact, entered directly rather than picked from a list.
Remove a Tag from a CRM Contact (By ID) Yes No Remove a single tag from a CRM contact, entered directly rather than picked from a list.
Custom API Call Yes No Make a custom API call to a specific endpoint
Watch Channel Messages Yes No webhook trigger declared by the pinned package.
Watch Group Messages Yes No webhook trigger declared by the pinned package.
Watch Incoming Messages Yes No webhook trigger declared by the pinned package.
Watch Specific Group Messages Yes No webhook trigger declared by the pinned package.
Watch Specific Channel Messages Yes No webhook trigger declared by the pinned package.

Triggers

Watch Channel Messages · Webhook

Triggers when a new message is posted to any WhatsApp Channel (includes own posts).

Inputs

  • session · string
Watch Group Messages · Webhook

Triggers when a new message is received in any WhatsApp group.

Inputs

  • session · string
Watch Incoming Messages · Webhook

Triggers when a new 1-on-1 WhatsApp message is received.

Inputs

  • session · string
Watch Specific Group Messages · Webhook

Triggers when a new message is received in a specific WhatsApp group.

Inputs

  • session · string
  • group · string
Watch Specific Channel Messages · Webhook

Triggers when a new message is posted to a specific WhatsApp Channel.

Inputs

  • session · string
  • channel · string

Setup

Setup

  1. Add the WhatsScale connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • No provider credential fields are declared by the pinned package.
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-whatsscale@1.1.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 56 actions and 5 triggers declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required WhatsScale connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-whatsscale@1.1.0 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.