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 manage WhatsApp contacts, messages, tickets, and other related operations. Specifically, for the Contato (Contact) resource with the Definir Follow-up (setFollowUp) operation, it allows users to set or update the follow-up information of a contact in the WhatMaster system.

Common scenarios where this node is beneficial include:

  • Automating customer relationship management by updating follow-up notes on contacts.
  • Integrating WhatsApp contact management into broader workflows, such as CRM updates or ticketing systems.
  • Keeping track of customer interactions and next steps directly through WhatsApp contact metadata.

Practical example:

  • After a support conversation, automatically set a follow-up note on the customer's WhatsApp contact to remind the team to check back in 3 days.

Properties

Name Meaning
Número do WhatsApp The WhatsApp number of the contact in the format 5511999999999.
External Key An optional external key to associate with the request for tracking or identification.
ID do Contato The unique identifier of the contact whose follow-up is being set.
Follow-up The follow-up text or note to assign to the contact.

Output

The node outputs a JSON object representing the response from the WhatMaster API after setting the follow-up on the contact. This typically includes confirmation details or updated contact information returned by the API.

No binary data output is involved in this operation.

Example output structure (conceptual):

{
  "success": true,
  "contactId": "123456",
  "followUp": "Call back next week",
  "message": "Follow-up updated successfully"
}

Dependencies

  • Requires an API key credential for the WhatMaster API, including a bearer token and an external code.
  • The node makes HTTP requests to the WhatMaster API endpoint: https://back.whatmaster.com.br/v1/api/external/{externalCode}.
  • No additional external libraries are required beyond those bundled with n8n.

Troubleshooting

  • Missing Credentials: If the API credentials are not configured or incomplete (missing bearer token or external code), the node will throw errors prompting to configure them.
  • Required Parameters Missing: The node requires the WhatsApp number, contact ID, and follow-up text to be provided. Omitting any of these will cause an error.
  • Unsupported Operation: If an unsupported operation is selected for the contact resource, the node will throw an error indicating the operation is not supported.
  • API Errors: Any errors returned by the WhatMaster API (e.g., invalid contact ID) will be surfaced in the node's output if "Continue On Fail" is enabled; otherwise, they will stop execution.

Links and References

Note: The actual implementation of the setFollowUp operation logic is indicated as not implemented in the source code (handleContactOperation throws an error). Therefore, the above summary assumes intended functionality based on input properties and typical use cases.

Discussion