API Reference

Send Contacts Session Message

post
https://elastic.messangi.me/balerion/v3/messages

Sends a WhatsApp contacts message to a recipient during an active 24-hour session, sharing one or more contact cards.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

You get a 24-hour window to send a WhatsApp user any message without using a template, once that user sends your application a message. This window opens whether the user replies to one of your outbound message templates or starts the conversation themselves. These are known as Session Messages.

You use Contacts session messages to send rich contact information directly to WhatsApp users, such as names, phone numbers, physical addresses, and email addresses. The Contacts messages section covers more information.

Body Params

Whatsapp Message Request

contacts
array of objects

Only applies to the ´contacs´ type.

Array that contains the contact information.

Contact information options:

  • ´addresses´: Full contact address(es).

  • ´birthday´: Birthday of the contact.

  • ´emails´: Contact email address(es).

  • ´name´: Full contact name formatted.

  • ´org´: Contact organization information.

  • ´phones´: Contact phone number(s).

  • ´urls´: Contact URL(s).

contacts
string

Alphanumeric identifier used for reporting purposes.

callbacks
array of strings

Webhook URL to notify about the events of the whatsApp message.

callbacks
string
required
^\+?[1-9]\d{1,14}$

Phone number of the sender.

Phone number provided during the WABA account setup will be used as the sender of the notification message.

Only accepts numeric characters. Do not include the ´+´ sign.

string
required
^\+?[1-9]\d{1,14}$

Determines the destination phone number for your regular message. Numbers are specified in E.164 format → (‘+’ and a country code).

string

Type of message you want to send.

Supported options:

  • ´text´: Sends a plain text message.

  • ´image´: Sends an image file (.jpeg, .png).

  • ´audio´: Sends an audio file (.acc, .mp3, .amr, .mpeg).

  • ´video´: Sends a video file (.mp4, .3gpp.)

  • ´document´: Sends a document file (.pdf).

  • ´contacts´: Sends contact information.

  • ´location´: Sends a location with latitude and longitude.

  • ´interactive´: Sends an interactive message with reply buttons or list .

In this example, we set the ´contacts´ parameter.

Responses

Updated about 2 hours ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 hours ago