WhatMaster icon

WhatMaster

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

Actions29

Overview

This node integrates with the WhatMaster API to send WhatsApp messages, including text and various media types. Specifically, for the Mensagem resource and the Enviar Arquivo Base64 operation, it allows sending a file encoded in Base64 format directly as a WhatsApp message.

Common scenarios where this node is beneficial include:

  • Automating the sending of documents, images, or other files stored or generated in Base64 format without needing to upload them separately.
  • Integrating systems that produce Base64-encoded files (e.g., scanned documents, dynamically generated reports) with WhatsApp messaging workflows.
  • Sending multimedia content programmatically to WhatsApp users in customer support, marketing, or notification contexts.

Example use case:

  • A CRM system generates a PDF invoice encoded in Base64 and uses this node to send the invoice directly to the customer's WhatsApp number.

Properties

Name Meaning
Número do WhatsApp The recipient's WhatsApp number in international format (e.g., 5511999999999). Required.
Mensagem Text message body accompanying the file. Required.
External Key Optional external key for tracking or referencing the message externally.
Arquivo Base64 The file content encoded in Base64 format. Required for this operation.
Tipo do Arquivo MIME type of the file being sent (e.g., image/jpeg, application/pdf). Required for this operation.
Nome do Arquivo The filename to assign to the sent file. Required for this operation.

Output

The node outputs a JSON object representing the response from the WhatMaster API after attempting to send the 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 operation since the file is sent as Base64 within the JSON payload.

Dependencies

  • Requires configuration of WhatMaster API credentials, specifically:
    • A Bearer token for authorization.
    • An external code identifier used in the API URL path.
  • The node makes HTTP POST requests to the WhatMaster API endpoint:
    https://back.whatmaster.com.br/v1/api/external/{externalCode}

Troubleshooting

  • Missing Credentials: Errors like "No credentials found" or missing bearer token/external code indicate that the WhatMaster API credentials are not properly configured. Ensure credentials are set up in n8n before running the node.
  • Required Parameters Missing: The node throws errors if mandatory fields such as WhatsApp number, message body, Base64 file content, MIME type, or filename are empty or missing. Double-check all required inputs are provided.
  • Invalid WhatsApp Number Format: The WhatsApp number must be in the correct international format without spaces or symbols (e.g., 5511999999999).
  • API Errors: If the API returns an error, the node will output the error message in the JSON response. Check the API documentation or logs for more details.
  • Base64 Encoding Issues: Ensure the Base64 string is correctly encoded and does not contain invalid characters or line breaks that could cause the API to reject the file.

Links and References

If you need summaries for other resources or operations, please provide their names.

Discussion