Actions10
- Message Actions
- Webhook Actions
- Control Actions
Overview
The Quepasa (Whatsapp) node for n8n enables sending messages via the unofficial Quepasa WhatsApp API. Specifically, with the Message resource and Send operation, this node allows you to send text messages or attachments (via URL, binary data, or base64) to a specified chat ID (individual, group, or phone number). This is useful for automating WhatsApp notifications, alerts, or file sharing in workflows.
Example scenarios:
- Sending automated order confirmations to customers on WhatsApp.
- Notifying a support group with real-time updates and attachments.
- Distributing files or images to users via WhatsApp from other systems.
Properties
| Name | Type | Meaning |
|---|---|---|
| Authentication | options | Selects how to authenticate: either by entering parameters manually or using predefined credentials. |
| BaseUrl | string | The base URL of the Quepasa API. Required if using manual parameter authentication. |
| Token | string | The WhatsApp bot token. Required if using manual parameter authentication. |
| Method | options | Specifies the type of message to send: text, attachment by URL, binary, or base64. |
| Text | string | The text content of the message. Used for text and URL-based messages. |
| Chat ID | string | The destination chat identifier (group, individual, or E164 phone number). |
| Url | string | The URL of the attachment to send. Required for "Send Attachment By Url" method. |
| File Name | string | The name (and extension) of the file being sent. Used for URL, binary, and base64 methods. |
| Track ID | string | Optional system identifier to avoid duplicate messages. |
Output
The node outputs a JSON object (or array of objects) representing the result of the message send operation. The structure typically includes:
{
"status": "success",
"messageId": "string",
"chatId": "string",
"timestamp": "string",
// ...other fields as returned by the Quepasa API
}
- If an error occurs and "Continue On Fail" is enabled, the output may include an
errorfield with the error message. - For binary operations, the node can output binary data, which represents the file or media sent/received.
Dependencies
- External Service: Requires access to the Quepasa WhatsApp API endpoint.
- API Key / Token: You must provide a valid WhatsApp bot token.
- n8n Credentials: Optionally, you can use predefined credentials configured in n8n for authentication.
- Environment Variables: None required unless specified by your credential setup.
Troubleshooting
Common Issues:
- Authentication errors: Ensure the BaseUrl and Token are correct, or that the selected credential is properly configured.
- Invalid Chat ID: Make sure the Chat ID is a valid WhatsApp group, user, or E164 phone number.
- Attachment issues: For "Send Attachment By Url," verify the URL is accessible and points to a supported file type.
- Duplicate messages: Use the Track ID property to prevent accidental resending.
Error Messages:
"Authentication failed": Check your token and BaseUrl or credential configuration."Invalid chatId": Verify the format and existence of the target chat."File not found"or"Invalid URL": Ensure the provided URL is correct and reachable."Missing required property": Double-check all required fields for the selected method.