WhatMaster icon

WhatMaster

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

Overview

This node integrates with the WhatMaster API to send various types of WhatsApp messages and manage related resources. Specifically, for the API Plus resource with the Enviar Botão Dinâmico (Send Dynamic Button) operation, it allows sending WhatsApp messages that include dynamic buttons, enhancing user interaction possibilities within chats.

Common scenarios where this node is beneficial include:

  • Automating customer support by sending interactive button messages.
  • Marketing campaigns where users can quickly respond via buttons.
  • Any workflow requiring rich WhatsApp message formats with dynamic call-to-action buttons.

Practical example: Sending a WhatsApp message to a customer with buttons like "Confirm", "Reschedule", or "Cancel" dynamically generated based on context.


Properties

Name Meaning
Número do WhatsApp The recipient's WhatsApp number in international format (e.g., 5511999999999).
Mensagem The text content of the message to be sent.
External Key An optional external key to associate with the message for tracking or referencing.

Note: These properties are required inputs when using the API Plus resource with the Enviar Botão Dinâmico operation.


Output

The node outputs a JSON object representing the response from the WhatMaster API after attempting to send the dynamic button message. This typically includes status information about the message delivery, any identifiers returned by the API, or error details if the request failed.

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 endpoint URL.
  • The node makes HTTP POST requests to the WhatMaster API endpoint:

    https://back.whatmaster.com.br/v1/api/external/{externalCode}
    
  • No additional external libraries beyond standard Node.js modules and form-data (for other operations) are needed for this specific operation.


Troubleshooting

  • Missing Credentials: Errors will occur if the API credentials (token or external code) are not configured. Ensure these are set up correctly in n8n credentials.

  • Required Fields Missing: The WhatsApp number and message body are mandatory. If omitted or empty, the node throws errors indicating which field is missing.

  • Unsupported Operation: If an operation other than supported ones for the API Plus resource is selected, the node will throw an error stating the operation is not supported.

  • API Request Failures: Network issues or invalid API tokens may cause request failures. Check connectivity and credential validity.

  • Error Handling: If "Continue On Fail" is enabled, errors will be returned as part of the output JSON instead of stopping execution.


Links and References

Discussion