Actions55
- Message Actions
- Contact Actions
- Chat Actions
- Group Actions
- Queue Actions
- Account Actions
- Session Actions
- Session Control Actions
- Call Actions
Session Control → Set Config
AI-generatedOverview
This node integrates with the Maytapi WhatsApp Unofficial API, enabling automation and management of WhatsApp sessions and messaging. Specifically, the Session Control - Set Config operation allows users to configure phone-specific settings such as webhook URLs and acknowledgment delivery preferences for their WhatsApp instance.
Typical use cases include:
- Setting or updating a custom webhook URL for receiving WhatsApp events on a per-phone basis.
- Enabling or disabling message acknowledgment delivery for specific phones.
- Managing session configurations dynamically within an automated workflow.
For example, you might use this node to update the webhook URL when migrating your backend server or to toggle acknowledgment notifications for troubleshooting message delivery issues.
Properties
| Name | Meaning |
|---|---|
| Phone ID Source | Select how to provide the Phone ID: either "From Credentials" (uses Phone ID stored in credentials) or "Custom" (enter a custom Phone ID). |
| Phone ID | The WhatsApp instance Phone ID to use when "Custom" is selected as Phone ID Source. Required if using custom Phone ID. |
| Webhook URL | Phone-specific webhook URL to receive WhatsApp events. If left empty, the product-level webhook configuration will be used. |
| Enable Acknowledgments | Boolean flag to enable or disable acknowledgment delivery for this phone. |
Output
The node outputs JSON data representing the response from the Maytapi API after setting the configuration. This typically includes success status and any relevant details returned by the API.
No binary data output is produced by this operation.
Example output JSON structure:
{
"success": true,
"message": "Configuration updated successfully"
}
Dependencies
- Requires an API key credential for authenticating with the Maytapi WhatsApp API.
- The Phone ID must be provided either via credentials or manually as a custom value.
- Network access to the Maytapi API endpoint (
https://api.maytapi.com/api) is required.
Troubleshooting
Error: "Phone ID is required."
This error occurs if no Phone ID is provided either in credentials or as a custom input. Ensure that the Phone ID is correctly set in credentials or select "Custom" and provide a valid Phone ID.Invalid Webhook URL or network errors:
If the webhook URL is invalid or unreachable, the API may reject the configuration. Verify the URL format and ensure your server is accessible.API authentication failures:
Make sure the API key credential is valid and has the necessary permissions.Unexpected API errors:
Check the exact error message returned in the node output. It may indicate issues like rate limits, invalid parameters, or service downtime.
Links and References
- Maytapi Official Website
- Maytapi WhatsApp API Documentation (for detailed API endpoints and parameters)
- n8n Documentation on Creating Custom Nodes