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 Oficial resource with the Solicitar Localização operation, it allows requesting a user's location via WhatsApp by sending a message that prompts the recipient 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 services requiring customers to share their address or current position.
  • Event management or logistics where location confirmation is necessary.

Practical example: A delivery company uses this node to send a WhatsApp message asking the customer to share their current location to facilitate accurate delivery.

Properties

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

Output

The node outputs JSON data representing the response from the WhatMaster API after attempting to send the location request message. This typically includes status information about the message delivery or any errors returned by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires configuration of WhatMaster API credentials including:

    • 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}
    
  • No additional external dependencies beyond standard Node.js modules and n8n helpers.

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 these are set up in n8n credentials.

  • Required Parameters Missing: If the WhatsApp number or message body is empty, the node will throw an error indicating these fields are mandatory.

  • Invalid Coordinates: For location-related operations, latitude and longitude must be provided and valid numbers; otherwise, an error is thrown.

  • Unsupported Operation: If an unsupported operation is selected for the resource, the node throws an error specifying the operation is not supported.

To resolve issues, verify all required input properties are correctly filled, credentials are configured, and the operation matches the resource capabilities.

Links and References

Discussion