Wappfy icon

Wappfy

Interact with WhatsApp through Wappfy API

Overview

This node enables sending voice messages through the Wappfy API, which interacts with WhatsApp. It allows users to send voice notes either by providing a URL to the media file or by supplying Base64-encoded audio data. This functionality is useful for automating voice message delivery in customer support, marketing campaigns, or personal communication workflows.

For example, you can use this node to:

  • Send a pre-recorded voice message hosted on a server to a specific WhatsApp chat.
  • Convert audio files to Base64 and send them directly without hosting.
  • Automate voice notifications or reminders to groups or individual contacts.

Properties

Name Meaning
Chat ID The identifier of the WhatsApp chat to send the voice message to (e.g., 123456789@c.us).
Media Source The source type of the voice media: either "URL" (a link to the file) or "Base64" (encoded data).
File URL The URL of the voice file to send (required if Media Source is "URL").
Base64 Data The Base64 encoded string of the voice file (required if Media Source is "Base64").
File Name The name of the voice file (used when Media Source is "Base64", default is "file").
MIME Type The MIME type of the voice file (e.g., audio/mpeg, audio/ogg), required for correct handling.

Output

The node outputs JSON data representing the response from the Wappfy API after attempting to send the voice message. This typically includes details about the sent message such as message ID, status, or error information if the operation failed.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Wappfy API account with valid credentials including:
    • Base URL of the Wappfy API.
    • Instance name identifying the WhatsApp session.
    • An API key credential for authentication.
  • The node must be configured with these credentials in n8n before use.

Troubleshooting

  • Invalid Chat ID: If the chat ID format is incorrect or the chat does not exist, the API will return an error. Ensure the chat ID follows the pattern like 123456789@c.us for direct chats or 123456789@g.us for groups.
  • Incorrect Media Source: Providing a URL when Base64 data is expected or vice versa will cause failures. Verify that the selected media source matches the provided input.
  • MIME Type Missing or Incorrect: The MIME type is required to correctly interpret the voice file. Use standard audio MIME types such as audio/mpeg.
  • API Authentication Errors: If the API key or instance name is invalid or missing, requests will fail. Confirm credentials are properly set up.
  • Network Issues: Connectivity problems to the Wappfy API endpoint will prevent message sending. Check network access and API availability.

Links and References


This summary focuses specifically on the "Message" resource with the "Send Voice" operation as requested.

Discussion