Actions12
Overview
The node "Wazzap API" enables interaction with the Wazzap messaging API, specifically allowing users to send documents as messages through a WhatsApp-like service. The "Enviar Documento" (Send Document) operation under the "Mensagem" (Message) resource facilitates sending a document file to a specified recipient number, optionally including a caption and message options such as delay, replying to a specific message, or mentioning participants.
This node is beneficial in scenarios where automated document sharing is required via WhatsApp messaging, such as sending invoices, contracts, reports, or any PDF/document files directly to clients or team members. For example, a business could automate sending purchase orders or delivery notes immediately after an order is processed.
Properties
| Name | Meaning |
|---|---|
| Nome Da Instância | The name of the Wazzap instance that will send the document. |
| Número Do Destinatário | The recipient's phone number in international format to whom the document will be sent. |
| Documento | The document to send, provided as a URL or base64-encoded string. |
| Mensagem | Optional text message (caption) to accompany the document. |
| Nome Do Arquivo | The filename for the document being sent; defaults to "document.pdf". |
| Opções | Additional message options: |
| - Delay | Time in milliseconds to wait before sending the message (default 1200 ms). |
| - Responder Mensagem | Option to reply to a specific message by providing its message ID. |
| - Menções | Options to mention participants in the group: either mention everyone or specify individual numbers separated by commas. |
Output
The node outputs a JSON array containing the response from the Wazzap API after attempting to send the document message. This typically includes confirmation details such as message IDs, status, or error information if the sending failed.
No binary data output is produced by this node; it strictly handles JSON responses related to message sending operations.
Dependencies
- Requires an active Wazzap API instance configured with appropriate credentials (an API key or token).
- The node depends on network access to the Wazzap API endpoint (
https://doc.wazzap.mx/api-reference). - Proper configuration of the instance name and authentication credentials within n8n is necessary for successful operation.
Troubleshooting
Common Issues:
- Invalid or missing instance name can cause authentication failures.
- Incorrect recipient number format may lead to message delivery errors.
- Providing an invalid document URL or malformed base64 string will prevent the document from being sent.
- Mentioning users not part of the group or incorrect message IDs for replies can cause errors.
Error Messages:
"Operação não suportada."indicates the selected operation is not implemented or recognized.- API errors related to authentication or authorization usually mean the API key/token is invalid or expired.
- Network errors suggest connectivity issues between n8n and the Wazzap API endpoint.
Resolutions:
- Verify all input parameters, especially instance name, recipient number, and document source.
- Ensure the API credentials are correctly set up and have sufficient permissions.
- Check the document URL or base64 content validity.
- Confirm message IDs used for replies exist and belong to the conversation.
Links and References
- Wazzap API Documentation (official API reference)
- n8n documentation on creating custom nodes for further customization guidance