WhatsApp

Send and receive WhatsApp messages via the unofficial multi-device protocol. Use at your own risk — Meta may suspend accounts that rely on unofficial automation.

Authentication

This connector uses Token-based authentication.

info

Set up your connection in the Abstra Console before using it in your workflows.

How to use

Using the Smart Chat

Execute the action "CHOOSE_ONE_ACTION_BELOW" from my connector "YOUR_CONNECTOR_NAME" using the params "PARAMS_HERE".

Using the Web Editor

from abstra.connectors import run_connection_action

result = run_connection_action(
  connection_name="your_connection_name",
  action_name="your_action_name",
  params={
    "param1": "value1",
    "param2": "value2"
  })

Available Actions

This connector provides 9 actions:

Action	Purpose	Parameters
send_text	Send a plain text WhatsApp message to a phone number or JID.	to (string) required message (string) required replyToId (string)
send_image	Send an image to a phone number or JID. URL must be publicly reachable.	to (string) required url (string) required caption (string)
send_document	Send a document PDF, spreadsheet, etc. to a phone number or JID.	to (string) required url (string) required filename (string) required caption (string)
send_audio	Send an audio message. Pass voice=true to send as a voice note PTT.	to (string) required url (string) required voice (boolean)
mark_as_read	Mark incoming messages as read shows the double-blue-check in sender's app.	chatJid (string) required messageIds (array) required
create_group	Create a new WhatsApp group with an initial participant list.	name (string) required participants (array) required
add_to_group	Add participants to an existing group. Requires the bot to be a group admin.	groupJid (string) required participants (array) required
remove_from_group	Remove participants from a group. Requires admin rights.	groupJid (string) required participants (array) required
send_to_group	Send a text message to a group by JID.	groupJid (string) required message (string) required

Webhook Events

This connector emits 4 events back to your workflow via the connection's webhook callback. Subscribe to them by attaching a workflow trigger to the connection.

Event	Description
new_message	Incoming WhatsApp message text, image, document, or audio.
message_status	Status update for a previously sent message delivered, read, failed.
connection_status	Connection lifecycle change connected, reconnecting, logged_out, banned.
group_participants_changed	Group membership changed add, remove, promote, demote.