Actions29
- Mensagem Actions
- Ticket Actions
- Contato Actions
- API Oficial Actions
- API Plus Actions
Overview
This node integrates with the WhatMaster API to send WhatsApp messages and perform related operations. Specifically, for the Mensagem resource and the Enviar Localização operation, it allows sending a location message via WhatsApp by specifying latitude, longitude, and optional descriptive details such as location name and address.
Typical use cases include:
- Sharing a precise location with customers or contacts directly through WhatsApp.
- Automating location sharing in customer support or delivery notifications.
- Embedding location data in workflows that require geographic context.
Example: Automatically send a customer's delivery location to a WhatsApp number after an order is placed.
Properties
| Name | Meaning |
|---|---|
| Número do WhatsApp | The recipient's WhatsApp number in international format (e.g., 5511999999999). |
| Mensagem | Text message body accompanying the location (required). |
| External Key | Optional external identifier for tracking or referencing the message externally. |
| Latitude | Latitude coordinate of the location to send (required for Enviar Localização). |
| Longitude | Longitude coordinate of the location to send (required for Enviar Localização). |
| Nome da Localização | Optional name/title of the location being sent. |
| Endereço | Optional address description of the location. |
Output
The node outputs JSON data representing the response from the WhatMaster API after attempting to send the location message. This typically includes confirmation details or error information returned by the API.
If the operation succeeds, the output JSON contains the API's success response. If it fails, the output may contain an error message describing what went wrong.
No binary data output is produced for this operation.
Dependencies
- Requires configuration of WhatMaster API credentials including:
- A Bearer token for authorization.
- An external code identifier used in the API endpoint URL.
- Uses the WhatMaster REST API endpoint
https://back.whatmaster.com.br/v1/api/external/{externalCode}. - Node.js modules used internally include
form-dataandfsfor file handling in other operations, but not specifically for sending location.
Troubleshooting
- Missing Credentials: Errors like "No credentials found" or missing bearer token/external code indicate the API credentials are not properly configured. Ensure these are set up in n8n credentials.
- Required Fields Missing: For sending location, both latitude and longitude must be provided; otherwise, an error "Latitude e longitude são obrigatórios." will be thrown.
- Invalid Phone Number or Message: The WhatsApp number and message text are mandatory. Empty or invalid values cause errors.
- Unsupported Operation: Attempting an unsupported operation for the resource will throw an error indicating the operation is not supported.
- API Request Failures: Network issues or invalid API tokens can cause request failures. Check connectivity and credential validity.
Links and References
- WhatMaster API Documentation (Assumed based on URL pattern, verify actual docs)
- WhatsApp Location Message Format (For general understanding of WhatsApp location messages)