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 manage related resources such as tickets, contacts, and different API variants. Specifically, for the Ticket resource and the Mostrar Informações do Ticket (Show Ticket Information) operation, it is designed to retrieve detailed information about a specific ticket by its ID.

Common scenarios where this node is beneficial include:

  • Customer support workflows where agents need to fetch ticket details from WhatsApp conversations.
  • Automating ticket status checks or displaying ticket metadata in dashboards.
  • Integrations that require syncing ticket data between WhatsApp and other CRM or helpdesk systems.

Practical example:

  • A support agent triggers this node with a ticket ID to get the current status, assigned queue, and customer information of a WhatsApp support ticket.

Properties

Name Meaning
Número do WhatsApp The WhatsApp number in international format (e.g., 5511999999999).
External Key An optional external key to associate with the request for tracking or correlation.
ID do Ticket The unique identifier of the ticket whose information is to be retrieved.

Output

The output JSON contains the response from the WhatMaster API for the requested ticket information. This typically includes fields such as ticket status, creation date, assigned queue, client details, and any other metadata associated with the ticket.

If the node encounters an error, the output JSON will contain an error field with the error message.

The node does not output binary data.

Dependencies

  • Requires configuration of WhatMaster API credentials including:
    • A Bearer token for authorization.
    • An external code used as part of the API endpoint URL.
  • Uses the WhatMaster API endpoint: https://back.whatmaster.com.br/v1/api/external/{externalCode}.
  • Requires internet access to communicate with the WhatMaster API.

Troubleshooting

  • No credentials found: Ensure the WhatMaster API credentials are properly configured in n8n.
  • Bearer Token is required: The API token must be set in the credentials.
  • External Code is required: The external code must be provided in the credentials.
  • Missing required parameters: For this operation, the "ID do Ticket" must be provided; otherwise, the node will throw an error.
  • Operation not implemented: Currently, the code throws an error indicating ticket operations are not implemented yet. This means the actual logic to fetch ticket info is missing and needs implementation.
  • Network errors or API failures: Check network connectivity and API availability.

Links and References


Note: The source code shows that the ticket operations, including "Mostrar Informações do Ticket," are not yet implemented (handleTicketOperation method throws an error). Therefore, while the node interface supports this operation, the actual execution logic to retrieve ticket information is missing in the current version.

Discussion