Send Contacts Session Message

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

If a WhatsApp user has sent your application a message — whether it’s a reply to one of your outbound message templates, or they have initiated communication themselves — your application has a 24-hour window to send that user any messages, without using a template. These are known as Session Messages.

Contacts session messages allow you to send rich contact information directly to WhatsApp users, such as names, phone numbers, physical addresses, and email addresses.

For more information, go to the Contacts messages section.

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

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

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

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