4Jawaly WhatsApp Sender icon

4Jawaly WhatsApp Sender

Send WhatsApp messages via 4Jawaly API

Actions15

Send Document

AI-generated

Overview

This node sends WhatsApp documents/files via the 4Jawaly API. It supports sending various file types such as PDF, DOCX, XLSX, and others up to 100MB in size. The node is useful for automating the delivery of documents to WhatsApp users, for example, sending invoices, reports, contracts, or any other file directly to a recipient's WhatsApp number.

Use Case Examples

  1. Sending a PDF invoice to a customer via WhatsApp.
  2. Delivering a DOCX contract file to a client automatically.
  3. Sharing an XLSX report with a team member through WhatsApp.

Properties

Name Meaning
Phone Number The recipient's phone number without '+' or spaces, used to specify the WhatsApp message destination.
WhatsApp Project ID The WhatsApp project identifier number, required to route the message through the correct WhatsApp project.
File URL The direct URL link to the file to be sent (supports PDF, DOCX, XLSX, etc.) with a maximum size of 100MB.
File Name Optional name of the file as it will appear to the recipient. If not provided, the filename is extracted automatically from the URL.
Caption Optional text caption to accompany the file in the WhatsApp message.
Additional Options Optional settings including batch size for sending to multiple numbers and timeout duration in milliseconds.

Output

JSON

  • success - Indicates if the document was sent successfully.
  • operation - The operation performed, here it will be 'sendDocument'.
  • message - A descriptive message about the result of the send operation.
  • phone_number - The recipient's phone number.
  • file_url - The URL of the file sent.
  • detected_type - The type of file detected (e.g., document, image, audio, video).
  • filename - The name of the file sent.
  • caption - The caption text sent with the file, if any.
  • message_id - The unique identifier of the sent message from the API.
  • api_message - The message returned by the API.
  • description - Additional description or details from the API response.
  • raw_response - The full raw response from the 4Jawaly API.

Dependencies

  • 4Jawaly API
  • An API key credential for authentication

Troubleshooting

  • Ensure the phone number is correctly formatted without '+' or spaces.
  • Verify the WhatsApp Project ID is correct and active.
  • Check that the file URL is accessible and the file size does not exceed 100MB.
  • If the filename is not provided, ensure the URL contains a valid filename to extract.
  • Timeout errors may occur if the API is slow; adjust the timeout setting accordingly.
  • API errors will include messages; review these for specific issues such as invalid credentials or unsupported file types.

Links

Discussion