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 perform various WhatsApp-related operations, including sending messages, managing tickets, and handling contacts. Specifically, for the Contato (Contact) resource with the operation Mostrar Informações do Contato (Show Contact Information), the node is designed to retrieve detailed information about a WhatsApp contact.

Common scenarios where this node is beneficial include:

  • Fetching contact details to enrich CRM or customer support systems.
  • Verifying contact information before sending messages or creating tickets.
  • Automating workflows that require up-to-date contact data from WhatsApp.

Practical example:

  • A user wants to automatically pull contact info when a new message arrives, to personalize responses or update internal databases.

Properties

Name Meaning
Número do WhatsApp The WhatsApp number in international format (e.g., 5511999999999). Required for most operations involving a contact.
External Key An optional external key to associate with the request, useful for tracking or correlation.
ID do Contato The unique identifier of the contact within the system, used to specify which contact's information to show.

Output

The node outputs JSON data representing the response from the WhatMaster API for the requested contact information. This typically includes fields such as contact name, phone number, email, tags, CRM data, follow-up status, and other metadata related to the contact.

If the node supports binary data output (not evident for this operation), it would represent media files or attachments associated with the contact, but for "Mostrar Informações do Contato" the output is purely JSON.

Example output structure (conceptual):

{
  "id": "contact-id",
  "name": "Contact Name",
  "number": "5511999999999",
  "email": "contact@example.com",
  "tags": ["tag1", "tag2"],
  "crm": "CRM System Name",
  "followUp": "Follow-up details"
}

Dependencies

  • Requires an API key credential for the WhatMaster API, including:
    • A Bearer token for authorization.
    • An external code identifier used in the API URL path.
  • The node makes HTTP requests to https://back.whatmaster.com.br/v1/api/external/{externalCode}.
  • No additional external dependencies beyond standard Node.js modules (fs, form-data) are required.
  • Proper configuration of credentials in n8n is mandatory.

Troubleshooting

  • No credentials found: Ensure the WhatMaster API credentials are configured in n8n with both the Bearer token and external code.
  • Bearer Token is required: The API token must be set; otherwise, authentication will fail.
  • External Code is required: This code is part of the API endpoint URL and must be provided.
  • Missing required parameters: For example, the WhatsApp number or contact ID must be supplied depending on the operation.
  • Operation not supported: If an unsupported operation is selected, the node throws an error indicating so.
  • Network or API errors: Check connectivity and API availability; verify that the token has sufficient permissions.

Links and References

Note: The current bundled source code shows that the contact operations handler (handleContactOperation) is not implemented yet and throws an error if called. Therefore, while the node interface lists the "Mostrar Informações do Contato" operation, its execution logic is not present in this version. Users should expect an error until this functionality is implemented.

Discussion