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 and the Enviar Botão operation, it sends a WhatsApp message containing interactive buttons to a specified phone number.

Common scenarios where this node is beneficial include automating customer engagement via WhatsApp by sending messages with actionable buttons, such as quick replies or call-to-action buttons, enhancing user interaction and response rates.

Practical example: A business can use this node to send a promotional message with buttons like "Buy Now" or "Learn More" directly to customers' WhatsApp numbers, streamlining marketing campaigns.

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 reference the message externally.

Output

The node outputs JSON data representing the response from the WhatMaster API after attempting to send the button 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.

Dependencies

  • Requires an API key credential for authenticating with the WhatMaster API.
  • The node expects configuration of:
    • A Bearer token for authorization.
    • An external code identifier used in the API endpoint URL.
  • Uses the WhatMaster API endpoint at https://back.whatmaster.com.br/v1/api/external/{externalCode}.
  • Requires network access to the WhatMaster API service.

Troubleshooting

  • Missing Credentials: Errors like "No credentials found" or missing Bearer token/external code indicate that the API authentication details are not configured properly. Ensure the API key and external code are set up in the node credentials.
  • Required Fields Missing: If the WhatsApp number or message body is empty, the node will throw errors indicating these fields are mandatory. Verify input parameters before execution.
  • Unsupported Operation: Using an operation other than "Enviar Botão" under the API Oficial resource may result in errors since only certain operations are implemented.
  • API Request Failures: Network issues or invalid tokens can cause request failures. Check connectivity and credential validity.
  • Error Handling: If "Continue On Fail" is enabled, errors will be returned in the output JSON; otherwise, execution stops on the first error.

Links and References

Discussion