Kirim Pesan Balasan

POST 
/nusasms_api/1.0/wa_business/reply

Syarat Penggunaan

Supaya dapat mengirim pesan reply (balasan), harus sudah ada Conversation room (percakapan) antara akun Whatsapp (Gateway) dengan si penerima pesan.

Pengantar

Pesan Reply merupakan pesan bebas (tanpa template). Pengguna dapat mengirim pesan teks, dokumen, gambar dan video dengan endpoint ini.

Teks

Teks merupakan tipe pesan paling dasar endpoint ini. Endpoint ini digunakan untuk mengirim pesan bebas tanpa template.

Contoh

{
  "recipient": "<RECIPIENT>",
  "gateway_id": "<YOUR_GATEWAY_ID>",
  "type": "text",
  "payloads": {
    "body": "this is the text message"
  }
}

Dokumen

Tipe dokumen digunakan untuk mengirim pesan dengan lampiran berkas dokumen. Berikut tipe berkas yang didukung.

Tipe	Ekstensi	Tipe MIME	Ukuran Max
Teks	.txt	100 MB	text/plain
Microsoft Excel	.xls	100 MB	application/vnd.ms-excel
Microsoft Excel	.xlsx	100 MB	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Microsoft Word	.doc	100 MB	application/msword
Microsoft Word	.docx	100 MB	application/vnd.openxmlformats-officedocument.wordprocessingml.document
Microsoft PowerPoint	.ppt	100 MB	application/vnd.ms-powerpoint
Microsoft PowerPoint	.pptx	100 MB	application/vnd.openxmlformats-officedocument.presentationml.presentation
PDF	.pdf	100 MB	application/pdf

Contoh

{
  "recipient": "<NOMOR PENERIMA>",
  "gateway_id": "<GATEWAY_ID>",
  "type": "document",
  "payloads": {
    "link": "<URL DOCUMEN>",
    "caption": "<TEKS KETERANGAN; opsional>"
    "filename": "<NAMA FILE; opsional>"
  }
}

Contoh Pratinjau Pesan Dokumen

Image

Tipe	Ekstensi	Tipe MIME	Ukuran Max
JPEG	.jpeg, jpg	image/jpeg	5 MB
PNG	.png	image/png	5 MB

Contoh

{
  "recipient": "<NOMOR PENERIMA>",
  "gateway_id": "<GATEWAY_ID>",
  "type": "image",
  "payloads": {
    "link": "<URL GAMBAR>",
    "caption": "<TEKS KETERANGAN; opsional>"
  }
}

Video

Tipe	Ekstensi	Tipe MIME	Ukuran Max
3GPP	.3gp	vide/3gpp	16 MB
MP4 Video	.mp4	video/mp4	5 MB

Contoh

{
  "recipient": "<NOMOR PENERIMA>",
  "gateway_id": "<GATEWAY_ID>",
  "type": "video",
  "payloads": {
    "link": "<YOUR VIDEO URL; required>",
    "caption": "<YOUR CAPTIONS; optional>"
  }
}

Reaction

Kirim reaction ke inbox anda dengan karakter emoji. 🎉

Example

{
    "recipient": "RECIPIENT",
    "gateway_id": "YOUR_GATEWAY_ID",
    "type": "reaction",
    "payloads": {
        "message_id": "<MESSAGE_ID; required>",
        "emoji": "<EMOJI; required>"
    }
}

Balasan Kontekstual

peringatan

Pesan balasan kontekstual ini tidak dapat digunakan pada tipe pesan reaction dan untuk balasan tipe pesan reaction.

Balasan kontekstual merupakan cara spesial untuk merespon pesan pengguna Whatsapp. Pesan balasan kontekstual lebih fokus dengan satu pesan yang ditentukan dengan cara meng-quote pesan ini.

Pratinjau:

Gunakan parameter message_id_context yang nilainya adalah message_id dari pesan masuk atau pesan sebelumnya.

Nilai message_id dari pesan masuk bisa didapat jika anda mengaktifkan fitur Webhook Whatsapp Business

Contoh:

info

Konten json ini disederhanakan agar lebih mudah dibaca

{
  "gateway_id": "GATEWAY_ID",
  "recipient": "NOMOR_PENERIMA",
  "type": "text",
  "payloads": {
    "text": "Teks pesan"
  },
  "message_id_context": "wamid.RandomIdText"
}

Request

Responses

200

Successful Response

400

Request validation error

403

Forbidden access

422

Validation Error