VEverihubs
WhatsApp Session Message

Send WhatsApp Session Message V2

This method allows you to reply to contact's messages within a 24-hour window.<br>

API Update Notice: This V2 endpoint is the recommended version, replacing the previous V1 endpoint. We recommend migrating to V2 immediately for a better experience.<br>

Benefits of V2:

  • Decreased processing time for API requests and responses
  • Improved features: Blocking Request, Spam Check, and Blocked Numbers
  • Increased RPS (from 30 RPS to 50 RPS)
  • Better developer environment to support future developments
  • Improved logging and monitoring
  • Improved dependencies and service stability<br>

A rate limit of 50 RPS is applied to WhatsApp services. Verihubs also applies rate limits divided into several categories based on product. For more details, see Rate Limit.

Callback Description

When you want to use callback_url payload, you only need to put for example

your-callback-url.com/callback

Example callback that we'll send

your-callback-url.com/callback?session_id=d0f5fb5c-2d50-4d3f-aea7-20018ab15806&status=1
PayloadDescription
session_idID of the specific message
statusLatest status of the request

Callback Status Description

StatusDescriptionCondition
0RequestedMessage has been requested.
1SentMessage has been sent to Whatsapp server.
2DeliveredMessage has been delivered to user.
3ReadMessage has been read by user.
6FailedWhatsapp cannot send Message to destination number
7Request ErrorVerihubs cannot reach WhatsApp
10Tier Limit ExceededExceeding channel tier limit
post/v2/whatsapp/session-message/send

Request

  • Base URL
    https://api.verihubs.com
  • URL
    https://api.verihubs.com/v2/whatsapp/session-message/send
  • Auth
    none declared. Required headers: App-ID, API-Key

Headers

App-IDstring required
API-Keystring required

Request body

msisdnstring required

Destination Phone Number. You need to include international prefix number.

contentstring required

Message that wants to be sent. The content must be a minimum length of 1 character to a maximum length of 4096 characters.

callback_urlstring

Optional. This URL will be called by the server when the desired event will occur.

Example request

{
  "msisdn": "628391028399",
  "content": "Hello welcome to Verihubs Apps",
  "callback_url": "https://your-url-callback.com"
}

Response

Successful Request

codeinteger required

Code (to be deleted on November 30, 2022)

messagestring required

Message

msisdnstring required

destination number with international prefix country code

session_idstring required

Generated ID which associated with verification request

Example response

{
  "code": 201,
  "message": "Session message sent successfully",
  "msisdn": "62839102839",
  "session_id": "asddede-asdae234-34sfd3-fe234d"
}

Changes

No recorded changes to this operation across all 1 revision of this API.