WhatMaster icon

WhatMaster

Integração com a API WhatMaster para envio de mensagens

Overview

This node integrates with the WhatMaster API to send WhatsApp messages and files. Specifically, for the Mensagem resource and Enviar Arquivo operation, it allows users to send a file attachment along with a text message to a specified WhatsApp number.

Common scenarios where this node is beneficial include:

  • Sending invoices, tickets, or documents directly to customers via WhatsApp.
  • Sharing images, PDFs, or other media files as part of customer support or marketing campaigns.
  • Automating file delivery in workflows that require sending personalized attachments.

Example use case: Automatically sending a PDF receipt to a customer after a purchase by providing the WhatsApp number, message text, and the file path of the receipt.

Properties

Name Meaning
Número do WhatsApp The recipient's WhatsApp number in international format (e.g., 5511999999999). Required.
Mensagem Text content of the message to accompany the file. Required.
External Key Optional external key to associate with the message for tracking or referencing.
Arquivo File path of the file to upload and send. Required for the "Enviar Arquivo" operation.

Output

The node outputs JSON data representing the response from the WhatMaster API after attempting to send the file message. This typically includes confirmation details such as message ID, status, or error information if the request failed.

No binary data output is produced by this node; all responses are JSON objects describing the result of the API call.

Dependencies

  • Requires an API authentication token ("Bearer Token") and an external code configured in the node credentials to authenticate requests to the WhatMaster API.
  • Uses the form-data and fs Node.js modules internally to handle file uploads.
  • The file specified in the "Arquivo" property must be accessible on the filesystem where n8n runs.

Troubleshooting

  • Missing Credentials: If no credentials or required tokens are configured, the node will throw errors prompting to configure them.
  • Required Fields Missing: Errors occur if mandatory fields like WhatsApp number, message body, or file path are empty.
  • File Access Issues: If the file path is invalid or inaccessible, the node will fail when trying to read the file stream.
  • API Errors: Any API-level errors returned by WhatMaster will be included in the node output JSON. Check the message and status for troubleshooting.
  • Unsupported Operations: Using operations not implemented for the "message" resource will cause errors.

To resolve issues:

  • Ensure credentials are properly set up with valid tokens.
  • Verify all required input properties are filled correctly.
  • Confirm the file path is correct and readable by n8n.
  • Review API response messages for specific error details.

Links and References

Discussion