Actions29
- Mensagem Actions
- Ticket Actions
- Contato Actions
- API Oficial Actions
- API Plus Actions
Overview
This node integrates with the WhatMaster API to create and manage WhatsApp-related resources such as messages, tickets, contacts, and more. Specifically, for the Ticket resource with the Criar Ticket (Create Ticket) operation, it allows users to create a new support or service ticket associated with a WhatsApp number. This is useful in customer support scenarios where incoming WhatsApp messages need to be tracked and managed through a ticketing system.
Practical examples include:
- Automatically creating a support ticket when a customer sends a message via WhatsApp.
- Logging customer information such as name and email alongside the ticket for follow-up.
- Integrating WhatsApp communication into existing CRM or helpdesk workflows.
Properties
| Name | Meaning |
|---|---|
| Número do WhatsApp | The WhatsApp phone number in international format (e.g., 5511999999999). Required. |
| External Key | Optional external identifier to associate with the ticket. |
| Nome do Cliente | Customer's name associated with the ticket. |
| Email do Cliente | Customer's email address associated with the ticket. |
Output
The node outputs JSON data representing the response from the WhatMaster API after attempting to create a ticket. The exact structure depends on the API response but typically includes details about the created ticket such as its ID, status, and any metadata returned by the service.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the WhatMaster API.
- The node expects the credentials to provide a Bearer token and an external code, both mandatory for API requests.
- Network access to
https://back.whatmaster.com.br/v1/api/external/{externalCode}is required.
Troubleshooting
- Missing Credentials: If no credentials are configured or the token/external code is missing, the node will throw errors prompting to configure these values.
- Required Fields Missing: The WhatsApp number is mandatory; if omitted or empty, the node throws an error.
- API Errors: Any issues returned by the WhatMaster API (e.g., invalid parameters, rate limits) will be surfaced as errors.
- Unimplemented Operations: Currently, the ticket operations handler method throws an error indicating that ticket operations are not implemented yet. This means the actual creation logic for tickets is not present in the provided source code, so the node will fail if used as-is for ticket creation.
To resolve these:
- Ensure credentials are properly set up with valid token and external code.
- Provide all required input fields.
- Confirm the WhatMaster API endpoint is reachable.
- Note that ticket operations are not implemented in the current node version; implementation is needed for full functionality.
Links and References
- WhatMaster API Documentation (assumed based on URL)
- n8n Documentation on Creating Custom Nodes
- General WhatsApp Business API concepts for ticketing and messaging integration.