Wappfy icon

Wappfy

Interact with WhatsApp through Wappfy API

Overview

This node enables sending a location message via WhatsApp using the Wappfy API. It allows users to share geographic coordinates along with optional descriptive information such as the location's name and address. This is useful in scenarios where you want to inform contacts or groups about a specific place, for example:

  • Sharing your current position during a meetup.
  • Sending the location of an event or business.
  • Providing directions or points of interest.

By integrating this node into workflows, you can automate location sharing in chats or groups on WhatsApp.

Properties

Name Meaning
Chat ID The identifier of the chat where the location will be sent. Examples: 123456789@c.us (direct), 123456789@g.us (group).
Latitude The latitude coordinate of the location to send (number).
Longitude The longitude coordinate of the location to send (number).
Location Name Optional name/title of the location (string).
Location Address Optional address or description of the location (string).

Output

The node outputs the response from the Wappfy API after attempting to send the location message. The output JSON typically contains details about the message status or any returned metadata from the API call.

If multiple input items are processed, the output is an array of JSON objects corresponding to each item.

No binary data output is produced by this operation.

Dependencies

  • Requires a valid Wappfy API credential configured in n8n, including:

    • Base URL of the Wappfy API instance.
    • Instance name identifier.
    • API key for authentication.
  • The node makes HTTP POST requests to the /api/sendLocation endpoint of the Wappfy API.

Troubleshooting

  • Common issues:

    • Invalid or missing Chat ID: Ensure the chat ID is correctly formatted and corresponds to an existing chat or group.
    • Incorrect latitude/longitude values: Coordinates must be valid numbers within their respective ranges (latitude: -90 to 90, longitude: -180 to 180).
    • Authentication errors: Verify that the API key and instance name are correctly set in credentials.
    • Network or connectivity problems: Confirm that the Wappfy API base URL is reachable from the n8n environment.
  • Error messages:

    • API errors will be returned in the node output JSON under an error field if "Continue On Fail" is enabled.
    • If not continuing on fail, errors will throw a NodeOperationError with the API's error message.
  • Resolution tips:

    • Double-check all required parameters.
    • Validate API credentials.
    • Review API documentation for endpoint-specific requirements.
    • Enable detailed logging or inspect raw API responses for debugging.

Links and References

Discussion