Aysali API — n8n node

Aysali is an alternative stack to Evolution API for WhatsApp channel automation and integrations. This node targets Aysali API, not the Evolution API server itself.

If you are coming from Evolution-based workflows, compare endpoints and credentials in Aysali documentation before migrating.

---

Community node for n8n that connects your workflows to the Aysali API (WhatsApp channel hub and integrations). After the package is available in your n8n instance, add the Aysali API node from the node panel.

---

Prerequisites

• A running Aysali API deployment (or a server URL you are allowed to use).
• A valid API key (account- or instance-level, depending on your Aysali setup).
• An n8n version that supports community nodes (a current release is recommended).

Technical API details: Aysali documentation and API reference.

---

Credentials

1. In n8n: Credentials → New.
2. Search for Aysali API and select it.
3. Fill in:
   • Server URL — full base URL of your API (e.g. https://your-aysali.example.com) without extra path segments unless your deployment requires them.
   • API Key — key issued by Aysali (stored as a secret field).
4. Use Test if shown to verify the connection before saving.

The node sends the key in the request headers as expected by Aysali (apikey).

---

Using the node

1. In the editor, add the Aysali API node (from the node palette).
2. Select the credential you created.
3. Choose a Resource (see below).
4. Choose an Operation for that resource.
5. Fill in the fields shown for that operation (instance, chat id, message id, media, etc.). Fields change per operation.
6. Execute the node or the whole workflow. Output is usually JSON from the API for downstream nodes.

The node subtitle shows the selected operation.

---

Resources and operations

The UI flow is: Resource → Operation → operation-specific fields.

Instance

Manage the WhatsApp connection for an instance: create, connect (QR/Base64), list instances, behavior, presence, proxy, restart, logout, delete.

UI operation	Summary
Create Instance	Create a new instance
Connect Instance	Generate connection (QR or Base64)
Fetch Instance	List instances
Set Behavior	Configure instance behavior
Set Presence	Set presence
Set/Fetch Proxy	Configure or read proxy
Restart Instance	Restart the socket
Disconnect Instance	Disconnect WhatsApp
Delete Instance	Delete the instance

Message

Send text, media, poll, buttons, lists, PIX, status (story), reactions, contacts, etc.

UI operation	Summary
Send Text / Image / Video / Audio / Document	Text and media messages
Send Poll	Poll with up to 12 options
Send Contact / List / Buttons	Contact card, list, buttons
Send PIX	PIX payment button
Send Status	Post a status/story
React To Message	Reaction on a message

Chat

Read state, archive, search, profile picture, media as Base64, edit/delete messages, typing presence, block, list contacts/messages/chats/status.

UI operation	Summary
Check Number	Check if a number is on WhatsApp
Read Messages	Mark messages as read
Manage Archive / Mark As Unread	Archive or unread
Delete Message / Edit Message	Delete or edit a message
Fetch Profile Picture / Get Media As Base64	Profile image or media
Send Presence	Typing/recording presence
Block Contact	Block or unblock
List Contacts / Find Messages / Find Status / Find Chats	Query contacts, messages, status, chats

Group

Create groups, image/name/description, settings, members, invites, join/leave, ephemeral messages.

UI operation	Summary
Create Group	New group
Update Group Image / Name / Description	Update group metadata
Update Settings / Update Members	Permissions and members
Fetch / Revoke / Send Invite Link	Invite link
Fetch Groups / Find Participants	Groups and members
Ephemeral Messages	Disappearing messages
Join Group / Leave Group	Join with code or leave

Profile

Fetch and update name, status, picture, business profile, privacy settings.

UI operation	Summary
Fetch Profile / Fetch Business Profile	Read profile data
Update Profile Name / Status / Picture / Remove Profile Picture	Update or remove picture
Fetch Privacy Settings / Update Privacy Settings	Instance privacy

Event (outbound integrations)

Configure Webhook or RabbitMQ integration for the instance using the fields shown in the UI.

Integration (third-party)

Connect chat and bot stacks through Aysali:

• Chatwoot, Aysali Bot, Typebot, Dify, Flowise

Each option shows its own configuration fields; see Aysali documentation for valid values and limits.

---

Output and errors

• Output — JSON responses from the API; pass them to Set, IF, Code, or other nodes.
• Errors — Failed requests (e.g. server rejection or missing parameters) surface as n8n errors with API details; check HTTP status and body against Aysali documentation for common codes.

---

License

MIT — see LICENSE.md.