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
WhatsApp profile → Update Profile
AI-generatedOverview
This node allows updating the WhatsApp profile information associated with a specific WhatsApp number (device). It is particularly useful for businesses or users who want to programmatically manage their WhatsApp public profile details such as the profile name, status message, and business-related information. This can help keep contact information up-to-date, improve customer engagement by providing accurate business details, and maintain a professional presence on WhatsApp.
Practical examples include:
- Automatically updating the WhatsApp profile name and status based on marketing campaigns or seasonal promotions.
- Managing business profile details like address, description, email, websites, and categories for WhatsApp Business accounts.
- Setting business hours with timezone information to inform customers when the business is available.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number (device) whose profile you want to update. |
| Profile Name | The public name shown on the WhatsApp profile (maximum 25 characters). |
| Profile Status | The public status description shown on the WhatsApp profile (maximum 130 characters). |
| Update Business Profile | Boolean flag indicating whether to update the business profile information. Only applicable for WhatsApp Business numbers. |
| Business Profile | Collection of business profile details to update if "Update Business Profile" is true: - Business Address: Physical address (max 256 characters) - Business Description: Description of business activity (max 256 characters) - Business Email: Contact email (max 128 characters) - Business Websites: Up to 2 website URLs - Business Categories: Up to 3 categories from predefined options such as Automotive Service, Education, Restaurant, etc. |
| Set Business Hours | Boolean flag indicating whether to set business hours (only if updating business profile). |
| Business Hours Timezone | Timezone string for business hours, e.g., "America/New_York", "Europe/London". Required if setting business hours. |
Output
The node outputs JSON data representing the result of the profile update operation. This typically includes confirmation of the updated fields or any response data returned by the WhatsApp API regarding the profile update.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the WaliChat WhatsApp API service.
- The node depends on the external WaliChat API to perform profile updates.
- Proper configuration of the API key credential in n8n is necessary.
- The WhatsApp number (device) must be registered and accessible via the API.
Troubleshooting
Common Issues:
- Invalid or missing WhatsApp number ID: Ensure the device ID corresponds to a valid WhatsApp number linked to your account.
- Exceeding character limits for profile name or status: Keep profile name ≤ 25 characters and status ≤ 130 characters.
- Attempting to update business profile on a non-Business WhatsApp number: The business profile update will only work for WhatsApp Business accounts.
- Incorrect timezone format when setting business hours: Use valid IANA timezone strings (e.g., "America/New_York").
Error Messages:
- Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
- Validation errors from the API: Check input values against allowed lengths and formats.
- Network or API connectivity issues: Confirm network access and API endpoint availability.
Resolving these usually involves verifying input parameters, ensuring correct credentials, and confirming the WhatsApp number supports the requested operations.
Links and References
- WhatsApp Business Profile Documentation
- IANA Time Zone Database
- WaliChat API Documentation (Assumed URL for reference)