Skip to content


The TTMSFNCWhatsAppReceiver is a non-visual component to receive messages sent to a WhatsApp account. For this component to receive WhatsApp messages it must connect to a server hosted by TTMSFNCWhatsAppServer, running on a secure context. It uses TTMSFNCWebSocketClient internally.

Receive messages

Whenever a message arrives from TTMSFNCWhatsAppServer the OnBinaryDataReceived/OnMessageReceived event is triggered first, depending on the message format. After that in case of a string message it is further parsed internally into a record that contains all the WhatsApp message related information. Any incoming messages that don't follow the messages field format will be discarded.

If a valid formatted message arrives the OnWhatsAppMessageReceived event will be triggered. The AMessage parameter contains the message details, such as sender name, phone number, message type, and so on...

Secure connection

The TTMSFNCWhatsAppServer is always required to run in a secure context. This means the UseSSL is set to True and cannot be modified. See the Secure connection part of TTMSFNCWebSocketClient.


Property name Description
Active: Boolean Set True to connect and False to disconnect.
HostName: string Name of the host.
PathName: string Name of the path.
For example: https://hostname:port/path
Port: Integer Port number.


Method name Description
Connect Connect to a server and perform handshake.
Disconnect(SendClose: Boolean = True) Disconnect from the server.
- Non-WEB The SendClose parameter is for non-WEB platforms only. If SendClose is False, the client will not send a closing frame. If True, it will send a closing frame and wait for reply from the server.
Send(ABytes: TBytes) Send a string message to the server.
Send(AMessage: string) Send a binary message to the server.
Ping(AMessage: string)Non-WEB only Sends a ping frame to the server with an optional message.


Event name Description
OnBinaryDataReceived Event triggered when binary data is received from the server.
OnConnect Event triggered when connection to the server is successful.
OnDisconnect Event triggered when client is disconnected from the server.
- WEBTriggered automatically whenever the connection is lost.
- Non-WEBDoes not trigger if the connection is suddenly lost. To make sure you have connection to the server, use the Ping method to periodically check the connection.
OnMessageReceived Event triggered when a string message arrives from the server. This includes both forwarded messages from the callback URL and the BroadcastMessage/SendMessageTo calls by the server.
OnPingNon-WEB only Event triggered when a ping message is received from the server.
OnPongNon-WEB only Event triggered when a pong message is received from the server.
OnWhatsAppMessageReceived Event triggered when a valid message field formatted message arrives from the server.