Messaging Introduction

This guide focuses on 1:1 messaging through the ChatWerk API — that is, sending messages directly to individual WhatsApp users.
In this context, WhatsApp enforces specific delivery rules, such as the 24-hour service window and the use of approved message templates.

If you intend to send messages to multiple recipients simultaneously (1:N messaging), we recommend using a Chatflow or the Broadcast feature instead. These tools are optimized for large-scale delivery, automation, and segmentation, and should be used rather than the direct 1:1 API endpoints described here.


The sections below explain how WhatsApp handles message delivery for individual contacts and outline the technical differences between Template Messages and Free-Form Messages.

Message Delivery Mechanisms
When sending messages to individual WhatsApp users, the API distinguishes between two message types: Template Messages and Free-Form Messages.
Each type follows its own delivery rules and constraints.




Choosing the Right Message Type

ScenarioRecommended Message Type
First contact with a userTemplate Call
Message outside 24-hour windowTemplate Call
Reply within 24-hour windowMessage Call
Transactional notificationTemplate Call
Conversational replyMessage Call

Understanding and correctly applying these delivery mechanisms ensures that your messages are delivered successfully and remain compliant with WhatsApp’s platform policies.


Did this page help you?