WSAPI Message

Send and manage WhatsApp messages via WSAPI

Actions16

Overview

This node enables sending WhatsApp messages using a WSAPI (WhatsApp Service API). Specifically, the Send Location operation allows users to send geographic location information to a WhatsApp contact or group. This is useful in scenarios where you want to share a precise place with others, such as meeting points, event locations, or places of interest.

Practical examples include:

  • Sending your current location to friends or family.
  • Sharing a business address or venue location with customers.
  • Dispatching delivery or service locations in real-time.

The node supports additional metadata like location name, address, and URL to enrich the location message.

Properties

Name Meaning
Recipient WhatsApp ID of the recipient (phone number with @s.whatsapp.net for contacts, or group ID with @g.us for groups)
Latitude Latitude coordinate of the location to send (number)
Longitude Longitude coordinate of the location to send (number)
Location Name Optional name for the location (e.g., "San Francisco")
Location Address Optional address string describing the location (e.g., "San Francisco, CA, USA")
Location URL Optional URL related to the location (e.g., Google Maps link)
Advanced Options Additional options including:
- Mentions: comma-separated WhatsApp IDs to mention in the message
- Reply To Message ID: ID of the message this is replying to
- Is Forwarded: mark message as forwarded (boolean)

Output

The output JSON contains the response from the WSAPI after sending the location message. It typically includes details about the sent message such as message ID, status, timestamps, and any server acknowledgments.

No binary data is output by this operation.

Example output structure (simplified):

{
  "id": "message-id",
  "to": "1234567890@s.whatsapp.net",
  "latitude": 37.7749,
  "longitude": -122.4194,
  "name": "San Francisco",
  "address": "San Francisco, CA, USA",
  "url": "https://maps.google.com/?q=San+Francisco",
  "status": "sent"
}

Dependencies

  • Requires an active connection to the WSAPI WhatsApp service via an API key credential.
  • The node expects configuration of base URL, API key, and instance ID for authentication.
  • Network access to the WSAPI endpoint must be available.

Troubleshooting

  • Invalid Recipient ID: Ensure the recipient WhatsApp ID is correctly formatted with @s.whatsapp.net for individual contacts or @g.us for groups.
  • Missing Coordinates: Latitude and longitude are required; verify these are provided and valid numbers.
  • API Authentication Errors: Check that the API key and instance ID credentials are correctly configured and have not expired.
  • Network Issues: Confirm that the WSAPI endpoint is reachable from your environment.
  • Error Responses from WSAPI: The node returns error messages from the API in the output if the request fails. Review these messages for clues (e.g., rate limits, invalid parameters).

Links and References

Discussion