Actions5
- Action Actions
Overview
This node enables sending files via WhatsApp using the CustomJe.com API service. It is designed to send a file along with an optional message to a specified WhatsApp number through a particular WhatsApp instance managed by CustomJe.
Common scenarios where this node is beneficial include:
- Automating delivery of documents, PDFs, or other media files to customers or team members.
- Sending invoices, reports, or contracts directly over WhatsApp.
- Integrating WhatsApp file sharing into business workflows without manual intervention.
For example, a user can configure this node to send a PDF invoice stored on a public URL to a client’s WhatsApp number automatically after a purchase is made.
Properties
| Name | Meaning |
|---|---|
| CustomJe API Key | API key for authentication from CustomJe.com (required) |
| Instance ID | WhatsApp instance identifier provided by CustomJe (required) |
| Access Token | Access token for authenticating the WhatsApp instance (required) |
| Phone Number | Destination WhatsApp number including country code but without "+" sign (required) |
| Message | Optional text message content to send along with the file |
| Media URL | Publicly accessible URL of the file to be sent (required) |
Output
The node outputs a JSON object containing the response from the CustomJe API after attempting to send the file. This typically includes status information about the message delivery, such as success confirmation or error details.
No binary data output is produced by this node; all results are returned in JSON format.
Dependencies
- Requires an active account and valid API credentials (API key, instance ID, access token) from CustomJe.com.
- The file to be sent must be accessible via a public URL.
- Network connectivity to
https://api.customje.com/wb-send-file.phpendpoint. - No additional n8n environment variables are required beyond the input properties.
Troubleshooting
- Invalid Credentials: If the API key, instance ID, or access token are incorrect or expired, the API will reject the request. Verify and update these credentials.
- File URL Issues: The media URL must be publicly accessible. Private or inaccessible URLs will cause failures.
- Incorrect Phone Number Format: Ensure the phone number includes the country code but excludes the "+" sign.
- API Errors: The node throws errors if the operation or resource parameters are invalid or not implemented.
- Network Problems: Connectivity issues to the CustomJe API endpoint will result in request failures.
If the node fails and "Continue On Fail" is enabled, it will return the error message in the output JSON for that item.
Links and References
- CustomJe API Documentation (for detailed API usage and credential setup)
- WhatsApp Business API concepts (general understanding of WhatsApp messaging)