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 perform related operations. Specifically, for the API Plus resource with the Solicitar Localização (Request Location) operation, it sends a request to prompt a WhatsApp user to share their location.

Common scenarios where this node is beneficial include:

  • Customer support workflows where agents need to request a customer's location.
  • Delivery or logistics services requiring real-time location data from clients.
  • Any automated system that needs to interact with users via WhatsApp to obtain their geographic position.

Example: A delivery company uses this node to send a location request to a customer’s WhatsApp number, enabling the customer to share their current location easily.

Properties

Name Meaning
Número do WhatsApp The recipient's WhatsApp number in international format (e.g., 5511999999999).
Mensagem Text message content sent along with the location request.
External Key Optional external identifier to track or correlate the message externally.

Output

The node outputs JSON data representing the response from the WhatMaster API after sending the location request. This typically includes confirmation of the message being sent or error details if the request failed.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential configured with the WhatMaster API, including:
    • A Bearer token for authorization.
    • An external code identifier used in the API endpoint URL.
  • The node makes HTTP POST requests to https://back.whatmaster.com.br/v1/api/external/{externalCode}.
  • Uses standard Node.js modules such as fs and form-data for file handling in other operations (not relevant for this operation).

Troubleshooting

  • Missing Credentials: Errors like "No credentials found" or missing Bearer Token/External Code indicate the API credentials are not properly set up. Ensure the WhatMaster API credentials are configured correctly in n8n.
  • Required Parameters Missing: If the WhatsApp number or message text is empty, the node will throw errors indicating these fields are mandatory.
  • Latitude and Longitude Required: For location-related operations, latitude and longitude must be provided; otherwise, an error is thrown.
  • Unsupported Operation: Using an operation not supported for the selected resource will result in an error specifying the unsupported operation.
  • Network or API Errors: Standard HTTP errors may occur if the API endpoint is unreachable or returns an error. Check network connectivity and API status.

Links and References

  • WhatMaster API Documentation (assumed based on URL)
  • WhatsApp Business API concepts for location sharing
  • n8n documentation on creating custom nodes and using credentials

Discussion