WhatsApp

The WhatsApp SFTP integration enables organizations to automate the delivery of WhatsApp template messages by uploading JSON files to the secure /whatsapp directory. Unlike session-based messages sent through the API, the SFTP method supports only the use of pre-approved templates as defined in the WhatsApp Business Platform.

Before using this feature, the required template must first be created and approved within the Digital Engagement Platform or via the WhatsApp Business API. Once a template is available, customers can prepare a JSON file referencing the template name, language, and parameters, then upload it to the SFTP directory for automatic processing.

This mechanism is designed for enterprises that:

  • Require high-volume or recurring WhatsApp communications.
  • Prefer automated, file-based workflows instead of real-time API integration.
  • Must ensure consistency with WhatsApp’s compliance requirements for message templates.

The following WhatsApp template types are supported through SFTP:

  • Text Message Template - Send a simple WhatsApp text message template. This type of template allows you to predefine the configuration of text messages and personalized fields (placeholders).

    Best suited for notifications, reminders, or alerts that require a consistent text structure.

  • Media Message Template - This type of template allows you to predefine the configuration of text message, media, and buttons features, and personalized fields (placeholders) that provide additional information.

  • Session Messages - They are free-form messages sent within an active 24-hour conversation window initiated by the end user. Unlike templates, session messages do not require prior approval and can contain text, media, or interactive elements.

📘

NOTE

  • Templates must be created and approved in advance, either through the Digital Engagement Platform or via the WhatsApp Business API.
  • The JSON structure must exactly match the template definition (name, language, placeholders, and components).
  • Phone numbers of the recipients must always be in E.164 format to ensure compatibility.