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 and perform related operations. Specifically, for the API Plus resource with the Enviar Botão (Send Button) operation, it sends a WhatsApp message containing interactive buttons via the WhatMaster API.

Common scenarios where this node is beneficial include automating customer engagement through WhatsApp by sending messages with actionable buttons, such as quick replies or call-to-action buttons, enhancing user interaction in marketing campaigns, support workflows, or notifications.

For example, a business can use this node to send a message with buttons like "Confirm", "Cancel", or "More Info" to customers, allowing them to respond quickly without typing.

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 along with the button(s).
External Key An optional external identifier key to track or correlate the message externally.

Output

The node outputs a JSON object representing the response from the WhatMaster API after attempting to send the message with buttons. This typically includes confirmation details, message IDs, status, or error information 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}

Troubleshooting

  • Missing Credentials:
    Error: "No credentials found. Please configure the WhatMaster API credentials."
    Resolution: Ensure that the WhatMaster API credentials are properly set up in n8n with both the Bearer token and external code.

  • Missing Bearer Token or External Code:
    Errors indicating these are required mean the credentials are incomplete.
    Resolution: Verify that both token and external code fields are filled in the credential settings.

  • Required Parameters Missing:
    For example, if the WhatsApp number or message body is empty, errors will be thrown stating these fields are mandatory.
    Resolution: Provide valid values for all required input properties.

  • Unsupported Operation or Resource:
    If an unsupported operation or resource is selected, the node throws an error indicating so.
    Resolution: Use only supported combinations as defined in the node properties.

  • File Upload Issues (not applicable for this operation but relevant for other message types):
    Ensure file paths or URLs are correct and accessible.

Links and References

Note: The provided source code shows that the actual implementation for the API Plus resource operations is not implemented (handleApiPlusOperation throws an error). However, based on the properties and operation options, the intended functionality for "Enviar Botão" is to send a button message using the WhatMaster API.

Discussion