Send Message | Official Api Documentation

# Send Message

pay attention

You can use the "Send Message" API in one case only:

You reply to a message that the client sent, within 24 hours since the client sent his last message.

If you send a message to a new client, or try to send a message to an old client (old client means that 24 hours since client's last message has passed), you must use the "Send Template Message" API instead.

If you send a template message to the client, and the client did not reply yet, and you want to send another message to him, you must use the template message again.

# Remarks

You can use the "Send Message" API in one case only - for reply to a message that the client sent, within 24 hours since the client sent his last message. If you send a message to a new client, or try to send a message to an old client (old client means that 24 hours since client's last message has passed), you must use the "Send Template Message" API instead. If you send a template message to the client, and the client did not reply yet, and you want to send another message to him, you must use the template message again.
You can only send a message to private people, not groups.
The billing is per "conversation". conversation means a 24 hours session between you and the client (this 24 hours conversation session is unrelated to the 24 hours timer for template message)
You can send unlimited messages within the 24 hours session time of a conversation.
24 hours session conversation starts when you send a message to the client.
Every time the user replies, the template message session resets. which means that you don't have to use template message during this 24 hours template message session.

# Endpoint

POST https://019sms.co.il/whatsapp-api/send-whatsapp-message

Name	Type	Required
Authorization	Bearer authentication	✔️
Content-Type	application/json	✔️

# Request parameters

Name	Type	Description	Required
source	string	Your WhatsApp account. international number without +. for example: 972771234567	✔️
destination	string	The number you want to send the message to. for example: 972501234567	✔️
message	string	Your message goes here \n for new line text for bold text for italic ~text~ for strike through	✔️
replyTo	string	In case you want to reply to a message that the end user has sent (quoted message), here you can provide the unique ID of that message	➖

# Request example

POST whatsapp-api/send-whatsapp-template HTTPS/1.1
Content-Type: application/json

{
"source": 972555555555,
"destination": 972550000000,
"message": "freestyle message",
"replyTo": ""
}

# Response example

Content-Type: application/json
{
    "success": true,
    "ans": {
        "status": "OK",
        "unique": "HBgMOTcyNTI2ODkzMjQ1FQIAERgSRdDU4RjIyQjY2MEI5NUVEMUM4AA==",
        "timestamp": 1735648695,
        "from": 972555555555,
        "to": "972550000000",
        "body": "Hi dana , thank you for calling",
        "templateTimeLeft": 0,
        "conversationTimeLeft": 0,
        "reason": 1
    }
}

# Response parameters

Name	Type	Description	Options
success	boolean	The status of request.	`true`/`false`
ans	object	The response object
ans -> status	string	Status of sending the message	`OK` / `FAIL`
ans -> unique	string	Unique ID for any message
ans -> timestamp	timestamp	Time stamp
ans -> from	string	Your WhatsApp account
ans -> to	string	The number that the message was sent to
ans -> templateTimeLeft	number	Amount of minutes left since client's last message. if passed, you must use Template Message. This value resets every time the client is sending you a message.
ans -> conversationTimeLeft	number	Amount of minutes left for the conversation session to end. if passed, any message after that, will be considered as a new conversation, and the timer will reset.
ans -> reason	string	The status explanation in case of FAIL	see the table below

# Reason explanation

Reason	Description
1	Not FAIL. the status is OK
2	Your "from" number account does not exist, or JSON syntax error
3	General error
4	'to' is either empty or wrong number format or WhatsApp number does not exist
5	'body' can't be empty
6	WhatsApp error
7	You are trying to send a message but it has been more than 24 hours since client's last message. please use 'Send Template' instead
8	You are trying to send a message for first time to a contact. please use 'Send Template' message instead
9	Rate limit error, try again

← Tamplates Send List →