Actions148
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Team Actions
- Labels Actions
- Departments Actions
- Files Actions
- Quick replies Actions
- Queue Actions
- WhatsApp session Actions
- WhatsApp profile Actions
- Business catalog Actions
- Campaigns Actions
- Meeting Links Actions
- User Status Actions
- Webhooks Actions
- Other Actions
Overview
This node operation allows you to create a new WhatsApp channel associated with a specific WhatsApp number (device). It is useful for managing multiple communication channels within the Wassenger WhatsApp API environment, enabling you to organize conversations or campaigns under distinct channel names and optionally customize each channel with a profile image.
Practical scenarios include:
- Setting up separate channels for different departments or teams within an organization.
- Creating branded channels for marketing campaigns or customer support.
- Uploading a custom profile picture to visually distinguish channels in the WhatsApp interface.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number (device) to which the channel will be linked. |
| Channel Name | The name assigned to the new channel. |
| Description | Optional description text for the channel (up to 2048 characters). |
| Upload Image | Boolean flag indicating whether to upload a profile image for the channel. |
| Image Source | If uploading an image, specifies the source type: either a URL or Base64-encoded image data. |
| Image URL | When using URL as image source, the direct link to the JPG or PNG image file (max size 1MB). |
| Image Data (Base64) | When using Base64 as image source, the Base64-encoded string representing the JPG or PNG image (max size 1MB). |
Output
The node outputs JSON data representing the result of the channel creation operation. This typically includes details about the newly created channel such as its ID, name, description, and any metadata returned by the Wassenger API.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Wassenger WhatsApp API via an API key credential.
- The node depends on the Wassenger API's ability to manage WhatsApp numbers and channels.
- Proper configuration of the API key credential in n8n is necessary for authentication.
Troubleshooting
Common Issues:
- Invalid or missing WhatsApp number ID: Ensure the device ID corresponds to an existing WhatsApp number registered in your Wassenger account.
- Image upload failures: Verify that the image URL is accessible and points to a valid JPG or PNG file not exceeding 1MB, or that the Base64 data is correctly encoded and within size limits.
- Insufficient permissions or invalid API key: Confirm that the API key used has the required permissions to create channels.
Error Messages:
"error": "Invalid device ID"โ Check the WhatsApp Number property for correctness."error": "Image size exceeds limit"โ Use a smaller image or compress it below 1MB."error": "Authentication failed"โ Reconfigure the API key credential in n8n.
Links and References
- Wassenger Official API Documentation (for detailed API capabilities and limitations)
- WhatsApp Business API Guidelines (general WhatsApp channel management best practices)