Sending Location Messages

Use this api to send location messages.

To send a location message, make a POST call to /messages and attach a message object with type=location .

Parameters

This is the main parameter used in send location message requests:

NameDescription

to

Required

WhatsApp ID or phone number for the person you want to send a message to.

The phone numbers in this requests can be provided in any dialable format, as long as they include their country code. It's recommended that you explicitly prefix the country code with a plus sign (+).

Here are some examples of supported phone number formats:

  • +1-000-000-0000
  • +1 (000) 000-0000
  • +1 000 000 0000
  • +1 (000) 000 0000

reply_message_id

Optional
You can send any message as a reply to a previous message in a conversation by including the previous message's ID. The recipient will receive the new message along with a contextual bubble that displays the previous message's content.

type

Required
The type of message you want to send. Set this as individual

location

.

location

Required
A location object.

location.latitude

Required

Latitude of the location.

location.longitude

Required

Longitude of the location.

location.name

Optional

Name of the location.

location.address

Optional

Address of the location. Only displayed if name is present.

Example

Sample request:

curl -X POST 'https://waofficial.botika.online/api/whatsapp/v1/messages' \
-H 'Authorization: Bearer {{ API_TOKEN }}' \
-H 'Content-Type: application/json' \
-d '{
    "to": "+62821xxxxxx",
    "reply_message_id": "{{ MESSAGE_ID }}",
    "type": "location",
    "location": {
        "latitude": "LOCATION_LATITUDE",
        "longitude": "LOCATION_LONGITUDE",
        "name": "LOCATION_NAME",
        "address": "LOCATION_ADDRESS"
    }
}'

A successful response includes an object with an identifier for the message:

{
    "data": {
        "id": "{{ MESSAGE_ID }}"
    }
}

Copyright © 2023 Botika Teknologi Indonesia